OpenTelemetry を使用して独自のアプリまたはサービスをセットアップする

始める前に

• まだ行っていない場合は、無料のNewRelicアカウントにサインアップしてください。
• データを報告するNewRelicアカウントのライセンスキーを取得します。

OpenTelemetry を使用してアプリまたはサービスを計測する

インストルメンテーションの開始を支援するために、OpenTelemetry は言語固有の製品と SDK を提供します。多くの言語は、一般的なライブラリとフレームワーク用のすぐに使用できるインストルメンテーションを提供します。各言語には、コードを手動で計測してテレメトリを収集するのに役立つ API も用意されています。

言語のリポジトリに移動し、指示に従ってコードを計測します。完了したら、ここに戻って「ステップ 3: テレメトリ データを New Relic にエクスポートするための構成を確認する」を完了してください。

• C ++
• Erlang
• Go
• Java
• Javascript / Node.js
• .NET
• PHP
• Python
• Ruby
• さび
• 迅速
• ...GitHubの言語の完全なリストを参照してください

テレメトリデータをNewRelicにエクスポートするための構成を確認する

テレメトリーデータのエクスポートは、 OpenTelemetry Protocol (略して OTLP) に依存します。 これは、OpenTelemetry プロジェクト用に設計された汎用テレメトリーデータ配信プロトコルです。 このプロトコルは、テレメトリーデータをエンコードして送信する方法を記述しており、データ転送に自然な選択肢となります。 各言語 SDK は、OTLP 経由でデータをエクスポートするように構成できる OTLP エクスポーターを提供します。

テレメトリー データをエクスポートする前に、ライセンスキーと適切な OTLP エンドポイントを取り込む必要があります。 次の手順では両方の情報が必要になるため、この情報をテキスト ファイルに貼り付けることをお勧めします。 OTLP 経由で New Relic にデータをエクスポートするには、次の 2 つの選択肢があります。

• アプリから直接：

  

• OpenTelemetry コレクターからのエクスポート:

  

  アプリから直接エクスポートする場合でも、コレクターからエクスポートする場合でも、次のことを行う必要があります。

1. ヘッダー（ api-key ）を追加するようにOTLPエクスポーターを構成する準備をします。値は、データを送信するNewRelicアカウントのライセンスキーです。

2. 統合に基づいて、エクスポーターが New Relic にデータを送信するエンドポイントを設定する準備をします。 エンドポイントは地域固有であるため、New Relic 組織が拠点を置いているエンドポイントを使用してください。 たとえば、EU データセンター リージョンを使用している場合は、EU エンドポイントを使用します。 以下の表をガイドとして使用し、ポートとエンドポイントに関する追加の考慮事項を参照してください。

   ポートとエンドポイント

   統合	gRPC	HTTP	終点	サポートされているポート	APIヘッダー名	APIヘッダー値	TLS暗号化が必要
   US OTLP	✅	✅	https://otlp.nr-data.net	443、 4317 、 4318	api-key	ライセンスキー	✅
   EU OTLP	✅	✅	https://otlp.eu01.nr-data.net	443、 4317 、 4318	api-key	ライセンスキー	✅
   US FedRAMP OTLP （詳細については、 FedRAMPへの準拠を参照してください）	✅	✅	https://gov-otlp.nr-data.net	443、 4317 、 4318	api-key	ライセンスキー	✅
   無限のトレース （エンドポイントの詳細については、 ベストプラクティスを参照してください	✅	✅	https://{trace-observer}	443	api-key	ライセンスキー	✅

   なぜ 3 つのポートがあるのでしょうか?

   OTLP 標準では、gRPC トラフィックはポート4317に、HTTP トラフィックはポート4318に指定されています。New Relic US FedRamp ネイティブ OTLP エンドポイントは、これらの仕様に準拠しています。また、ポート443での gRPC トラフィックと HTTP トラフィックの両方が許可されます。httpsスキームはポート443を自動的に選択するため、簡単にするためにポートを省略できます。

   どのバージョンのプロトコルを使用すればよいですか?

   OTLP には、プロトコルの3 つの異なるバージョンがあります: grpc 、 http/protobuf 、およびhttp/json 。さまざまなバージョンのサポートは言語によって異なります。

   New Relic はすべてのバージョンをサポートしていますが、選択できる場合はhttp/protobufを使用することをお勧めします。これは仕様のデフォルトの推奨事項であり、明らかなパフォーマンスの低下はなく、 grpcよりも堅牢であることが証明されています。

   追加のエンドポイントの詳細

   OTLP / HTTPのエンドポイントURLに関するOpenTelemetry仕様による：HTTPトラフィックを送信し、信号ごと以外の環境変数（ OTEL_EXPORTER_OTLP_ENDPOINT ）を使用している場合は、 OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:{port}を設定するだけで、エクスポーターは次の適切なパスを追加する必要があります。信号タイプ（つまり、 v1/tracesまたはv1/metrics ）。

   信号ごとの環境変数（つまり、 OTEL_EXPORTER_OTLP_TRACES_ENDPOINTやOTEL_EXPORTER_OTLP_METRICS_ENDPOINT ）を使用している場合は、適切なパスを設定する必要があります。たとえば、 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://otlp.nr-data.net:4318/v1/traces 。そうしないと、404になります。この環境変数は、シグナルごとではない変数よりも優先されることに注意してください。

   Node.js と TLS

   Node.jsでは、 opentelemetry-collector-exporter-grpcライブラリにTLSを有効にするための追加オプションが必要です。

構成のエクスポート手順を完了します

New Relic 固有のエクスポート設定については理解できたので、次の 2 つのオプションがあります。

• アプリからNewRelicに直接エクスポートする

• コレクターからNewRelicにエクスポート

  アプリからNewRelicに直接エクスポートする

  ご使用の言語については、以下のリンクをクリックして、構成手順を完了してください。完了したら、ここに戻ってステップ5を完了します。NewRelicUIでデータを表示します。

• C ++

• Erlang

• Go

• Java

• Javascript / Node.js

• .NET

• PHP

• Python

• Ruby

• さび

• 迅速

• ...GitHubで追加のOTLP言語サポートを見つける

  コレクターからNewRelicにエクスポート

  コレクターは、さまざまな方法でさまざまな目的に設定できます。セットアップに入る前にコレクターに関する一般的な情報が必要な場合は、概要を参照してください。

  エクスポートするコレクターを設定する例を表示するには、次のいずれかを選択してください。

• Dockerを使用した基本的なコレクターの例

• インフラストラクチャホスト監視用のコレクターのセットアップ

• 追加のコレクター設定例

NewRelicUIでデータを表示する

アプリまたはサービスをインストルメントし、そのデータを New Relic にエクスポートするように構成したら、New Relic UI で トレース、 メトリクス、 ログを監視します。

OpenTelemetry の UI は APM UI といくつかの類似点があるため、慣れている場合はそのまま UI に進むことができます。OpenTelemetry UI オプションを理解するためのヘルプが必要な場合、またはデータが UI に表示されることを確認する方法については、 「 New Relic で OpenTelemetry データを表示する 」を参照してください。