トレース オブザーバーをセットアップする

分散トレーシングを設定する手順に従い、無限トレーシングと呼ばれる詳細オプションの手順を続行する場合は、トレース オブザーバーを設定する必要があります。トレース オブザーバーは、Infinite Tracing 用の AWS ベースのサービスで、テレメトリ データを New Relic に送信する低レイテンシかつ低コストの方法を提供します。トレース オブザーバーはトレース データを受信すると、テールベースのサンプリングを使用して何を保持し、New Relic に送信するかを決定します。

データ ソースの種類 (サービス、アプリ、またはエンティティ) に合ったトレース オブザーバーのセットアップを完了します。さまざまなタイプがある場合は、複数のセクションで手順を実行する必要がある場合があります。

• APM エージェントとサードパーティのテレメトリ ツールを備えたサービス
• New Relic ブラウザー、モバイル、および Lambda を備えたサービス
• (オプション) すべてのサービス タイプの追加構成

APM エージェントとサードパーティのテレメトリ ツールを備えたサービス

New Relic APMエージェントまたはサードパーティのインテグレーションを使用している場合に新しいトレース オブザーバーを作成するには:

1. one.newrelic.com > All capabilities > Infinite Tracing settingsに移動します。

2. 左上のドロップダウンでアカウントを選択します。複数のアカウントにアクセスできる場合は、無限トレースを有効にするアカウントにいることを確認してください。オブザーバーを追加できない場合は、 リージョンごと、アカウント ファミリーごとに 1 つのオブザーバーしか許可されていない可能性があります。

3. トレース オブザーバーがまだ存在しない場合は、 New trace observerをクリックして追加し、情報を入力してCreateをクリックします。 以下の地域が対象となりますのでご注意ください。

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     EU のリクエストからデータを収集しており、EU データセンターでレポートする EU ベースの New Relic アカウントがある場合は、この地域を選択します。

   • eu-west-1 (US):

     EU のリクエストからデータを収集しており、米国のデータセンターでレポートする米国ベースの New Relic アカウントがある場合は、この地域を選択します。

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Endpointsドロップダウンで、 For other integrationsの下のエンドポイント値をコピーして準備します。 この値はコード例ではYOUR_TRACE_OBSERVER_URLとして参照されています。 これは、トレース オブザーバーをテストするだけでなく、テレメトリ インテグレーションを構成して、トレースAPI経由でデータを送信するために使用されます。

5. APMエージェントを設定する場合は、For language agentsの下の ヒント 値もコピーして準備しておく必要があります。 この値はコード例ではYOUR_TRACE_OBSERVER_HOSTとして参照されています。 これは、言語エージェントがトレース オブザーバーにデータを送信するように構成するために使用されます。

6. (オプション) トレース オブザーバーが機能していることを確認するには、サンプル トレース ペイロードを送信することをお勧めします。 Trace API を 直接使用している場合は、API の仕組みを理解するのに役立ちます。

   サンプル ペイロードの送信

   重要

   Zipkin 形式のデータを使用している場合は、 「Zipkin ペイロードを送信する」を参照してください。

   このテストは、 Test Service Aという名前のサービスから、1 つのトレースと 2 つのスパンを含むサンプル トレース ペイロードを送信します。

   このサンプル リクエストを送信するには:

   1. データのレポート先となるアカウントのライセンスキーを取得して準備しておきます。

   2. 次の curl リクエストをテキスト エディタにコピーします。

      bash

      コピー

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. curl リクエストに独自の値を挿入します。

      価値	説明
      YOUR_LICENSE_KEY	これを ingest ライセンスキーに置き換えます。
      YOUR_TRACE_OBSERVER_URL	これを、前の手順でコピーしたFor other integrationsエンドポイント値に置き換えます。

   4. curl リクエストをターミナルにコピーして実行します。

   5. テストは成功を示す HTTP/1.1 202 Acceptedを返します。そうでない場合は、次の一般的な問題を確認してください。

      • For other integrations

        エンドポイント値を使用したことを確認してください。

      • YOUR_TRACE_OBSERVER_URLを一重引用符で囲んでいることを確認してください。

      • 正しい API キーを使用していることを確認してください。

   6. テストで HTTP/1.1 202 Acceptedが返された場合は、New Relic UI に移動して、span 属性 service.name = Test Service A を使用したサンプル ペイロード データのクエリを確認します (そのクエリのリンクはここにあります)。サンプル ペイロードにはエラー属性が含まれているため、エラー サンプラーはそれを保持するようにマークします。ペイロードを変更してエラー属性を削除すると、ランダム サンプラーはこの特定のトレースを保持しない場合があります。

      ヒント

      トレースが UI に表示されるまでに最大 1 分かかる場合があります。

7. Infinite Tracing を試した後にそれらに戻ることができるように、以下の オプションの構成を ブックマークしてください。

8. エージェントまたはサードパーティのテレメトリ ツールの元の分散トレース セットアップ手順に戻り、各サービスの構成に新しいエンドポイント値を挿入します。

9. New Relic ブラウザー、モバイル、および Lambda でインストルメント化されたサービスもある場合は、そのセクションの手順に従って、トレース オブザーバーでデータ ソース (サービス、アプリ、またはエンティティ) を選択します。

New Relic ブラウザー、モバイル、および Lambda を備えたサービス

New Relic ブラウザー、モバイル、または Lambda を使用している場合に新しいトレース オブザーバーを作成するには、 APM エージェントおよびサードパーティの統合の場合と同様の手順に従います。この設定が異なる点は、各サービスの構成に新しいトレース オブザーバー エンドポイントを挿入する必要がないことです。代わりに、Infinite Tracing トレース オブザーバーにデータを送信するデータ ソース (サービス、アプリ、またはエンティティ) を指定するトレース オブザーバーで個別の構成を完了します。

別の種類のサービス (APMエージェントなど) をセットアップしているときにすでにトレース オブザーバーを作成している場合は、トレース オブザーバーの作成手順をスキップして、 browser 、モバイル、Lambda の初期トレース オブザーバー設定に進み、データ ソースを選択できます。

トレース オブザーバーを作成する

トレース オブザーバーをまだ設定していない場合は、次の手順を実行します。

1. one.newrelic.com > All capabilities > Infinite Tracing settingsに移動します。

2. 左上のドロップダウンでアカウントを選択します。複数のアカウントにアクセスできる場合は、無限トレースを有効にするアカウントにいることを確認してください。オブザーバーを追加できない場合は、 リージョンごと、アカウント ファミリーごとに 1 つのオブザーバーしか許可されていない可能性があります。

3. トレース オブザーバーがまだ存在しない場合は、 New trace observerをクリックして追加し、情報を入力してCreateをクリックします。 以下の地域が対象となりますのでご注意ください。

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     EU のリクエストからデータを収集しており、EU データセンターでレポートする EU ベースの New Relic アカウントがある場合は、この地域を選択します。

   • eu-west-1 (US):

     EU のリクエストからデータを収集しており、米国のデータセンターでレポートする米国ベースの New Relic アカウントがある場合は、この地域を選択します。

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Endpointsドロップダウンで、 For other integrationsの下のエンドポイント値をコピーして準備します。 この値はコード例ではYOUR_TRACE_OBSERVER_URLとして参照されています。 これはトレースオブザーバーをテストするために使用されます。

5. (オプション) トレース オブザーバーが機能していることを確認するには、サンプル トレース ペイロードを送信することをお勧めします。

   サンプル ペイロードの送信

   重要

   Zipkin 形式のデータを使用している場合は、 「Zipkin ペイロードを送信する」を参照してください。

   このテストは、 Test Service Aという名前のサービスから、1 つのトレースと 2 つのスパンを含むサンプル トレース ペイロードを送信します。

   このサンプル リクエストを送信するには:

   1. データのレポート先となるアカウントのライセンスキーを取得して準備しておきます。

   2. 次の curl リクエストをテキスト エディタにコピーします。

      bash

      コピー

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. curl リクエストに独自の値を挿入します。

      価値	説明
      YOUR_LICENSE_KEY	これをライセンスキーに置き換えます。
      YOUR_TRACE_OBSERVER_URL	これを、前の手順でコピーしたFor other integrationsエンドポイント値に置き換えます。

   4. curl リクエストをターミナルにコピーして実行します。

   5. テストは成功を示す HTTP/1.1 202 Acceptedを返します。そうでない場合は、次の一般的な問題を確認してください。

      • For other integrations

        エンドポイント値を使用したことを確認してください。

      • YOUR_TRACE_OBSERVER_URLを一重引用符で囲んでいることを確認してください。

      • 正しい API キーを使用していることを確認してください。

   6. テストで HTTP/1.1 202 Acceptedが返された場合は、New Relic UI に移動して、span 属性 service.name = Test Service A を使用したサンプル ペイロード データのクエリを確認します (そのクエリのリンクはここにあります)。サンプル ペイロードにはエラー属性が含まれているため、エラー サンプラーはそれを保持するようにマークします。ペイロードを変更してエラー属性を削除すると、ランダム サンプラーはこの特定のトレースを保持しない場合があります。

      ヒント

      トレースが UI に表示されるまでに最大 1 分かかる場合があります。

ブラウザー、モバイル、および Lambda の初期トレース オブザーバー構成

トレース オブザーバーを作成したら、Infinite Tracing トレース オブザーバーにデータを送信するデータ ソース (サービス、アプリ、またはエンティティ) を指定する必要があります。データ ソースを選択する前に、次のことをよく理解しておいてください。

以下の手順は New Relic UI を使用するためのものですが、プログラムによるアプローチを好む場合は、 GraphQL でデータ ソースを指定できます。GraphQL を使用する場合は、この手順に戻り、以下のステップ 4 (オプションの構成) に進みます。

UI でブラウザ、モバイル、および Lambda の設定を完了するには:

1. トレース オブザーバー アプリ ( one.newrelic.com > All capabilities > Infinite Tracing settings ) に戻ります。

2. トレース オブザーバーの場合は、行の末尾に移動し、省略記号アイコン...をクリックしてから、 Edit mobile, browser, lambda sourcesをクリックします。

   

3. 次の点に注意して、含めるデータ ソースを選択します。

   • フィルターを使用してオプションを絞り込むことができます。

   • browserアプリが複数の名前を持つ

     APM

     エージェントに接続されている場合、選択できる名前は 1 つだけです。

   • エントリが灰色の場合、別のトレース オブザーバーによって既に使用されています。

4. Infinite Tracing を試した後にそれらに戻ることができるように、以下の オプションの構成を ブックマークしてください。
5. New Relic 分散トレーシング UIで Infinite Tracing データを表示します。
6. APM エージェントまたはサードパーティのテレメトリ ツールで計測されたサービスも ある場合は、そのセクションの手順に従って、それらのデータが New Relic にレポートされるようにします。

(オプション) すべてのサービス タイプの追加構成

さまざまな構成でトレース オブザーバーの動作を制御できます。構成できる機能の一部を次に示します。

• トレース オブザーバーの監視を構成する: 表示および保持されるトレースの量を確認できます。
• スパン属性トレース フィルターの構成: スパンのカスタム フィルター ルールを作成します。
• 無限トレース: ランダム トレース フィルターの構成: ランダム トレース フィルターで使用されるパーセンテージを調整します。