New Relic での変更を表示および分析する方法

New Relic の変更追跡機能を使用すると、デプロイなどの最近の変更がエンド ユーザーに与える影響を確認できます。たとえば、アプリ サーバーの Apdex スコア、応答時間、スループット、エラーを確認できます。詳細の表示とドリルダウン、検索と並べ替えオプションの使用、エラーの非表示または削除、他のユーザーとの共有、またはエラーに関するチケットの提出を行うことができます。

変更の影響を表示および分析する方法についてここで詳しく説明する前に、GraphQL、当社の CLI、または CI/CD 統合を使用して監視する変更を指定していることを確認してください。追跡する変更を指定したら、さまざまな方法でスタック全体から結果を確認できます。

• APM およびダッシュボードのグラフ: 時系列グラフにピンの頭の付いた垂直線が表示されます。このマーカーは記録された変更を表しており、ピンの頭をクリックすると、変更がエンティティの健全性と品質に与えた影響の詳細を調べることができます。

  

  ヒント

  ダッシュボードまたはエンティティの概要ページにアクセスしても、期待していた追跡された変更が表示されない場合は、時間ピッカーの選択を確認してください。あなたが見ている窓の外にそれがあるかもしれません。

• エンティティ サイドバー:変更のテーブルを表示するには、変更を記録したエンティティのChange tracking [変更追跡]をクリックします。時間範囲セレクター、テーブルのフィルタリングおよび並べ替えオプションを備えています。これらを使用して、変更のフィールドを絞り込んだり、特定の変更を検索したりできます。

  ヒント

  追跡された変更を確認するには、このページで選択した時間範囲を調整する必要がある場合があることに注意してください。また、デフォルトでは、テーブルは最大 2,000 件の変更のみを遅延読み込みします。時間範囲をフィルタリング、検索、調整するときは、この点に留意してください。

• New Relic のアラートと検出:変更が問題に関連している場合は、 Issues [問題]ページのRoot Cause Analysis [根本原因分析]セクションにその変更がリストされます。

  

• アクティビティ ストリーム コンポーネント: New Relic UI のさまざまなページにある右側の折りたたみ可能なパネルで、アクティビティ フィードに記録された変更を確認できます。

  

変更の影響を分析する

変更はシステムにどのような影響を与えましたか?追跡している変更の影響を分析するためのさまざまな方法が提供されています。

変更詳細ページ

New Relic で追跡している変更 (チャートやIssues [問題]ページなど) をクリックすると、Change details [変更の詳細]ページが開きます。これには、変更を記録したときに送信したデータに加えて、その影響に関する豊富な情報が含まれています。

この変更がこのエンティティの健全性、パフォーマンス、品質にどのような影響を与えたのかについて、さまざまな洞察が得られます。これらの洞察は、エラー、主要なメトリクス、ログ属性の傾向、異常、問題などに基づいています。このページには、進行中の変更に関するコンテキストをさらに詳しく確認して理解するのに役立つ、強力なスコープ設定および比較ツールも備えています。たとえば、現在の変更が以前の変更とどのように比較されるかを確認できます。

変更を記録し、他の New Relic 機能を活用することで得られる役立つ洞察をいくつか紹介します。

• スループット、エラー率、トランザクション時間などの主要なエンティティシグナルに対する変更の正味影響を計算。各時系列グラフの上に信号に対する正味の影響を確認できます (通常はパーセンテージで表示されます)。これらの正味の影響は、通常、変更前後のシグナルの平均またはその他の関数を比較することによって計算されることに注意してください (正味の影響の数値の上にマウスを置くと、前後の平均が表示されます)。

  これらの計算に使用され、時系列グラフに表示される前後の期間は、変更の詳細ページの右上隅にあるタイムピッカーを使用して調整できます。

  ヒント

  変更の影響を分析するときは、選択した前後の期間に細心の注意を払ってください。期間が特定のニーズに対して短すぎるか長すぎる場合は、調整してください。変更後の経過時間が、選択した前後の期間よりも短い場合、UI は正味の影響を計算しないことに注意してください。計算すると、偏った結果が得られ、一般に役に立たないためです。

• エラー受信箱、ログ監視、AIOps (問題、インシデント、異常) などを含む、さまざまな New Relic 製品から得られた多面的な調査結果は、この変更が重要なトラブルシューティングと分析の記録にどのような影響を与えたか、またはどのように関連しているかを示します。ここで紹介する洞察とデータのフィルター方法は、エンティティの種類によって異なります。ページセクションのタイトルにカーソルを合わせると、ここで有意義な洞察を明らかにする方法について詳しく知ることができます。

  

  ヒント

  ページレベルのタイムピッカーは、他の New Relic 製品からのファセット分析にも影響します。自分にとって最も重要な変化後の期間に焦点を当ててみてください。

• このエンティティにフィルターされた展開リスト ページを含むページへのリンク（このエンティティのすべての変更を表示）。これを使用すると、すぐにズームアウトして、システムのこの部分の最近の変更をすべて確認できます。

• この変更のエンティティに関連するエンティティへのリンク。これは、問題の原因を探したり、この変更に起因する変更の影響を測定したりするときに、スタック全体を移動するのに役立ちます。

• 変更が記録されたときに提供されたすべてのデータ。これは、変更を行ったかどうかに関係なく、誰でもコンテキストをすぐに理解するのに役立ちます。

  ヒント

  変更を記録するときは、changelog 属性の URL を送信してみてください。 UI は、ソース リポジトリ管理システムへの便利な出発点として機能するクリック可能なリンクとしてレンダリングします。

前後の比較期間を変更する

Change details [変更の詳細]ページは、この変更に至るまでの期間にわたって生成されたレコードと信号が、この変更後の同じ長さの期間と比較されるという考えに基づいています。右上隅にあるタイムピッカーを使用して、その期間の長さを変更できます。これは、時系列グラフとデータ駆動型の洞察を特徴とする他の UI 要素の両方に影響することに注意してください。

ある変更を別の変更と比較する

Change details [変更の詳細]ページの右上隅にあるタイムピッカーの横に、ドロップダウン メニューの隣に比較 が表示されます。そのドロップダウン メニューを使用して、記録された別の変更を選択できます。これにより、ページが比較モードに切り替わります。

変更を比較する場合:

• 各時系列グラフには、この変更とその変更の曲線が表示され、各変更の相対的なパフォーマンスを比較するのに役立ちます。

  

• このページの他の計算は、この変更とあの変更の違いを理解するのに役立つように更新されます。理にかなっている場合は、レートまたはカウント (+11 など) のパーセンテージで増減を示す場合があります。

• 関連する変更の積み上げビューを最大 5 つまで開くことができます。

メトリクスとイベントに対する変更の影響を確認する

導入などの変更がエンティティのメトリクスやイベントにどのような影響を与えるかを確認するには、カスタム トレンド ボードを作成できます。最近の変更に関する意思決定を支援するために、最大 3 つのボードを作成するオプションがあります。

これらのカスタム トレンド ボードで何がわかるでしょうか?エンティティで利用可能なメトリクスまたはイベントから選択し、それに集計関数を適用できます。たとえば、次のような質問に答えるカスタム トレンド ボードを作成できます。

• この変更の前後で、ページビューの平均応答時間はどのように変化しましたか?
• この変更の前後で、ページビューの最大応答時間はどのように変化しましたか?

通常のダッシュボード グラフとは異なり、これらのカスタム トレンド ボードは時間枠と完全に統合され、 Change details [変更の詳細]ページの設定と比較されるグラフです。これらをダッシュボードにエクスポートすることもでき、それらはすべて特定のエンティティおよびユーザー アカウントに関連付けられます。

カスタム トレンド ボードを追加するには:

1. one.newrelic.com > All Entities に移動し、エンティティを選択します。
2. 左側のナビゲーション ペインでChange tracking [変更追跡]をクリックし、変更を選択します。
3. Key impacts [主な影響]のグラフの下で、 Add any metric or event[メトリックまたはイベントを追加]をクリックします。
4. What do you want to track [何を追跡しますか] をクリックし、メトリクスまたはイベントを選択します。
5. How do you want to aggregate that? [どのように集計しますか?] をクリックします。を押して機能を選択します。

Web トランザクションに対する変更の影響を確認する

変更追跡を使用すると、APM アプリケーションの変更によって Web トランザクションがどのような影響を受けたかについて詳細を確認できます。APM アプリケーションの変更を追跡していると、 Web transaction impacts [Web トランザクションの影響] という見出しが表示されます。このセクションの表には、アプリケーションで最も時間のかかる Web トランザクションを最大 10 個までのパフォーマンス指標が表示されます。

テーブルに表示する内容を制御するには:

• Metric [メトリック] ドロップダウンを使用して、この追跡された変更によってさまざまなメトリックがどのように影響を受けたかを確認します。
• テーブル内の前後の時間枠を変更するときは、変更後の時間範囲が将来終了する場合、不完全なトランザクション データが表示される可能性があることに注意してください。
• 別の追跡された変更と並べて比較する表を取得するには、 compared with [比較 で] 別の変更を選択します。
• Transaction name [トランザクション名] 列の値にカーソルを置くと、そのトランザクションの 5 つのメトリックすべてのパフォーマンスを要約するツールヒントが表示されます。ツールチップには APM トランザクションの詳細へのリンクもあるので、詳細なトランザクション レベルのデータを調べることができます。

変更データのクエリ

NRQL (New Relic データベースのクエリ言語) または NerdGraph (New Relic GraphQL API) を介して変更データをクエリすることもできます。

いくつかの例については、以下の NRQL および GraphQL セクションを参照してください。クエリ ツールの使用についてさらにヘルプが必要な場合は、 「NRQL の概要」、 「New Relic NerdGraph の概要」、または 「NerdGraph エンティティ API チュートリアル」を参照してください。

NRQL

GraphQL を使用してマーカーを作成した後、クエリ ビルダーで NRQL を使用して時系列グラフを作成し、一定期間にわたるテレメトリ信号の曲線を描画し、変更をマーカーとしてレンダリングすることができます。

次の例を試すか、独自のクエリを作成します。

SELECT *
FROM Deployment
SINCE 30 days ago

SELECT count(*)
FROM TransactionError
WHERE  appName = 'INSERT_YOUR_APP_NAME' AND http.statusCode > 300
SINCE 1 month ago TIMESERIES

SELECT count(*)
FROM Transaction
WHERE appName = 'INSERT_YOUR_APP_NAME'
FACET name
LIMIT  MAX
SINCE 1 week ago TIMESERIES

NerdGraph（GraphQL）

NerdGraph エクスプローラーで次の NerdGraph クエリを試してください。

{
  actor {
    entity(guid: "INSERT_YOUR_GUID_HERE") {
      deploymentSearch(
        filter: {
          timeWindow: {
            endTime: INSERT_MS_EPOCH_TIMESTAMP
            startTime: INSERT_MS_EPOCH_TIMESTAMP
          }
        }
      ) {
        results {
          version
          entityGuid
          timestamp
        }
      }
    }
  }
}

{
  actor {
    entity(guid: "INSERT_YOUR_GUID_HERE") {
      deploymentSearch(
        filter: {
          timeWindow: {
            endTime: INSERT_MS_EPOCH_TIMESTAMP
            startTime: INSERT_MS_EPOCH_TIMESTAMP
          }
          query: "user = 'Test User'"
        }
      ) {
        results {
          version
          entityGuid
          timestamp
          changelog
          commit
          deepLink
          deploymentId
          description
          deploymentType
          groupId
          user
        }
      }
    }
  }
}

{
  actor {
    entity(guid: "INSERT_YOUR_GUID_HERE") {
      deploymentSearch(
        filter: {
          timeWindow: {
            endTime: INSERT_MS_EPOCH_TIMESTAMP
            startTime: INSERT_MS_EPOCH_TIMESTAMP
          }
          query: "((user = 'Test User' AND version = '1.0') OR deploymentType in ('BLUE_GREEN', 'CANARY'))"
          limit: 200
        }
      ) {
        results {
          changelog
          commit
          deepLink
          deploymentId
          deploymentType
          description
          entityGuid
          groupId
          timestamp
          user
          version
        }
      }
    }
  }
}

次は何ですか？

Webhook を設定して、追跡している変更についてチームに通知することを検討してください。「変更についてチームに通知する」を参照してください。