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

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

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

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

  ヒント

  ダッシュボードまたはエンティティの概要ページに移動しても、予期した展開マーカーが表示されない場合は、タイム ピッカーの選択を確認してください。あなたが見ている窓の外にあるかもしれません。

• エンティティ サイドバー: 展開の表を表示するには、展開を記録したエンティティの Deployments[展開] をクリックします。これはデプロイ リスト ページで、時間範囲セレクター、テーブルのフィルター処理および並べ替えオプションを備えています。これらを使用して、展開のフィールドを絞り込んだり、特定の展開を見つけたりします。

  

  ヒント

  展開を表示するには、このページで選択した時間範囲を調整する必要がある場合があることに注意してください。また、デフォルトでは、テーブルは最大 2,000 のデプロイのみを遅延ロードします。フィルタリング、検索、および時間範囲の調整を行うときは、この点に注意してください。

• New Relic Alerts & Detection:展開が問題に関連している場合、問題ページの根本原因分析セクションの展開テーブルに表示されます。

  

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

  

展開の影響を分析する

展開はシステムにどのような影響を与えましたか?デプロイの効果を分析する方法を多数提供しています。

デプロイの詳細ページ

New Relic の実質的に任意の場所 (グラフ、 Issueページなど) でデプロイをクリックすると、デプロイを記録したときに送信したデータとその影響に関する豊富な情報を含むデプロイの詳細ページが開きます。

この展開がこのエンティティの正常性、パフォーマンス、および品質にどのように影響したかについて、さまざまな洞察が得られます。これらの洞察は、エラー、主要な指標、ログ属性の傾向、異常、問題などに基づいています。このページには、進行中の変更に関するより多くのコンテキストを表示して理解するのに役立つ、強力なスコーピング ツールと比較ツールも用意されています。たとえば、この展開が以前の展開とどのように比較されるかを確認できます。

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

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

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

  ヒント

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

• エラー インボックス、ログ監視、AIOps (問題、インシデント、および異常) など、さまざまな New Relic 製品からのファセット調査結果は、この展開が重要なトラブルシューティングおよび分析レコードにどのように影響したか、または関連しているかを示しています。ここで紹介する分析情報とデータのフィルター方法は、エンティティの種類によって異なります。ページ セクションのタイトルにカーソルを合わせると、ここで意味のある洞察がどのように表示されるかについて詳しく知ることができます。

  

  ヒント

  ページレベルのタイムピッカーは、他の New Relic 製品からのファセット インサイトにも影響します。あなたにとって最も重要な展開後の期間に焦点を合わせてみてください。

• このエンティティにフィルターされた前述の展開リスト ページを含むページへのリンク ( [このエンティティのすべての展開を表示] )。これを使用してすばやくズームアウトし、システムのこの部分の最近の変更をすべて確認します。

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

• デプロイが記録されたときに提供されたすべてのデータ。これにより、変更を行ったかどうかに関係なく、誰でもコンテキストをすばやく理解できます。

  ヒント

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

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

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

デプロイメントを別のデプロイメントと比較する

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

展開を比較すると、次のようになります。

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

  

• このページの他の計算は、この展開とその展開の違いを理解するのに役立つように更新されます。割合またはカウントの増加/減少 (+11 など) を表示することが理にかなっている場合があります。

• 関連する展開のスタック ビューを 5 つまで開くことができます。

デプロイ データのクエリ

また、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
        }
      }
    }
  }
}

まだお持ちでない場合は、以下で無料の New Relic アカウントを作成して、今すぐデータの監視を開始してください。