Java エージェント 7.x から 8.x への移行ガイド

このガイドでは、Java エージェントの 7.x シリーズと 8.x シリーズの間の主な変更点について説明します。アップグレード中に発生する可能性のある問題と、バージョン 8.x に正常に移行する方法について説明します。主な変更点は次のとおりです。

• 変更および削除されたトランザクションおよびスパン属性
• 削除された計装

変更および削除されたトランザクションおよびスパン属性

APM エージェント全体で一貫性を確保し、業界標準との整合性を高めるために、Java エージェントのトランザクション属性とスパン属性を変更しました。Java エージェント バージョン 7.6.0 以降、新しい標準属性http.statusCodeおよびhttp.statusTextを導入し、 httpResponseCode 、 response.statusをマークしました。およびresponse.statusMessage非推奨として。

推奨されるアクション

• 非推奨の属性を使用するアラートまたはダッシュボードがあり、エージェントのバージョン 8.0 ～ 8.7 を使用している場合は、エージェントを 8.8 に更新するか、削除された属性への参照を更新する必要があります。すべてのアラートまたはダッシュボードを新しい標準属性に更新した場合は、互換性フラグを無効にして、新しい標準属性のみを使用することができます。互換性フラグの設定については、 http_attribute_mode構成を参照してください。
• 非推奨の属性を使用しているアラートとダッシュボードを更新します。

影響を受けるアラート クエリの検索

影響を受けるアラートを見つけて修正するには:

1. NerdGraph Explorerを使用し、探している属性ごとにqueryLike演算子を使用してアラートを検索します。例えば：

{
  actor {
    user {
      name
    }
    account(id: <ACCOUNTID>) {
      alerts {
        nrqlConditionsSearch(searchCriteria: {queryLike: "httpResponseCode"}) {
          nrqlConditions {
            nrql {
              query
            }
            id
            name
            policyId
          }
        }
      }
    }
  }
}

2. 返された各アラートについて、 Alerts & AI > Alerts Conditions UI で ID または名前を使用してアラートを検索できます。
3. アラートの状態と信号範囲を確認して、アラートへの影響を確認します。
4. 「影響を受けるアラートとダッシュボードの NRQL ステートメントを修正する」の手順を使用して、NRQL ステートメントを更新します。

影響を受けるダッシュボード クエリの検出

ダッシュボードの影響を受けるクエリを見つけるには:

1. NerdGraph Explorer とダッシュボードのメタデータにあるエンティティ guid を使用すると、ダッシュボードのすべての NRQL クエリを取得できます。

{
  actor {
    entity(guid: "[ENTITY GUID]") {
      ... on DashboardEntity {
        guid
        name
        pages {
          widgets {
            rawConfiguration
          }
        }
      }
    }
  }
}

2. NRQL クエリはrawConfiguration項目で返されます。テキスト検索を使用して、削除された属性を見つけることができます。
3. 「影響を受けるアラートとダッシュボードの NRQL ステートメントを修正する」の手順を使用して、NRQL ステートメントを更新します。

次のクエリを使用して、すべてのダッシュボードのエンティティ guid のリストを取得することもできます。

{
  actor {
    entitySearch(query: "domain IN ('VIZ')") {
      results {
        entities {
          guid
          accountId
        }
      }
    }
  }
}

影響を受けるアラートとダッシュボードの NRQL ステートメントを修正する

http.statusCodeは、httpResponseCodeまたはresponse.statusへの参照を置き換えます。これもデータ型が異なります。以前は、次のような参照を使用していました。

[...] WHERE (数値(response.status)>399[...]

文字列データ型を数値に変換します。これを行う必要はなくなり、代わりに次のような単純な数値演算を使用できるようになりました。

[...] WHERE (http.statusCode >399) [...]

http.statusTextは、response.statusMessageへの参照を置き換えます。この属性のデータ型は変更されていません。

削除された計装

それぞれのメンテナによってサポートされなくなったライブラリ バージョンの次のインストルメンテーション モデルを削除しました。

• cassandra-datastax-2.1.2
• httpクライアント-3.0
• jdbc-embedded-derby-10.2.1.6
• jdbc-embedded-derby-10.10.1.1
• 桟橋-7
• 桟橋-7.6
• 桟橋-9
• 桟橋-9.0.4
• 桟橋-9.1
• mongodb-2.12
• mongodb-2.14
• mongodb-3.0
• khttp-3.0.0
• khttp-3.4.0
• khttp-3.5.0

アプリケーションがいずれかのライブラリを使用している場合、Java エージェント バージョン v8.x に更新すると、そのライブラリのインストルメンテーションによって生成されたメトリックとトランザクションを受信できなくなります。

推奨されるアクション

可能であれば、影響を受けるライブラリをメンテナと New Relic がサポートするバージョンに更新し、エージェントを更新します。EOL になったライブラリを更新できない場合でも、エージェントを更新できますが、削除されたデータによって重要な領域にギャップが生じていないかどうかを確認するために、テストとレビューを行うことをお勧めします。