OpenTelemetry は、アプリやサービスからテレメトリ データを収集し、そのデータを New Relic にエクスポートするために使用できるツールキットです。OpenTelemetry に精通していて、アプリまたはサービスのセットアップを開始する準備ができている場合は、適切な場所にいます。
デモ アプリで OpenTelemetry を試してみたい場合、または他のセットアップ オプションを確認したい場合は、「 OpenTelemetry の使用を開始する方法」を参照してください。
次の 5 つの手順は、OpenTelemetry を使用して独自のアプリまたはサービスをインストルメント化するのに役立ちます。
- 前提条件
- OpenTelemetry を使用してアプリまたはサービスを計測する
- テレメトリデータをNewRelicにエクスポートするための構成を確認する
- 構成のエクスポート手順を完了します
- NewRelicUIでデータを表示する
ステップ 1: 始める前に
- まだ行っていない場合は、無料のNewRelicアカウントにサインアップしてください。
- データを報告するNewRelicアカウントのライセンスキーを取得します。
ステップ 2: OpenTelemetry を使用してアプリまたはサービスを計測する
インストルメンテーションの開始を支援するために、OpenTelemetry は言語固有の製品と SDK を提供します。多くの言語は、一般的なライブラリとフレームワーク用のすぐに使用できるインストルメンテーションを提供します。各言語には、コードを手動で計測してテレメトリを収集するのに役立つ API も用意されています。
言語のリポジトリに移動し、指示に従ってコードを計測します。完了したら、ここに戻って「ステップ 3: テレメトリ データを New Relic にエクスポートするための構成を確認する」を完了してください。
ステップ3：テレメトリデータをNewRelicにエクスポートするための構成を確認する
テレメトリデータのエクスポートを設定する前に、まずNewRelicの設定のこのセクションを確認してブックマークする必要があります。この情報は、後でエクスポート手順を説明している他のページに移動するときに必要になります。
エクスポートは、OpenTelemetryプロジェクト用に設計された汎用テレメトリデータ配信プロトコルであるOpenTelemetryプロトコル（略してOTLP）に依存しています。このプロトコルでは、テレメトリデータをエンコードおよび送信する方法について説明します。これにより、テレメトリデータはデータ転送に自然に選択されます。各言語SDKは、OTLPを介してデータをエクスポートするように構成できるOTLPエクスポーターを提供します。
OTLPを介してNewRelicにデータをエクスポートするには、次の2つの選択肢があります。
アプリから直接：
アプリまたはサービスの OTLP エクスポーターは、New Relic OTLP レシーバーに直接エクスポートできます。
OpenTelemetry コレクターからのエクスポート:
コレクターを、New Relic OTLPレシーバーを受信、処理、およびエクスポートするゲートウェイとして設定できます。または、アプリケーションで実行されるエージェントまたは同じホストで実行されるエージェントとしてコレクターを設定することもできます。
アプリから直接エクスポートする場合でも、コレクターからエクスポートする場合でも、次のことを行う必要があります。
- ヘッダー（
api-key）を追加するようにOTLPエクスポーターを構成する準備をします。値は、データを送信するNewRelicアカウントのライセンスキーです。 - 統合に基づいて、エクスポーターが New Relic にデータを送信するエンドポイントを設定する準備をします。エンドポイントは地域固有であるため、New Relic 組織が拠点を置いているエンドポイントを使用してください。たとえば、EU データセンター地域を使用している場合は、EU エンドポイントを使用します。以下の表をガイドとして使用し、次の ポート と エンドポイント に関する追加の考慮事項を参照してください。
統合 | gRPC | HTTP | 終点 | サポートされているポート | APIヘッダー名 | APIヘッダー値 | TLS暗号化が必要 |
|---|---|---|---|---|---|---|---|
US OTLP | ✅ | ✅ |
|
|
| ライセンスキー | ✅ |
EU OTLP | ✅ | ✅ |
|
|
| ライセンスキー | ✅ |
US FedRAMP OTLP | ✅ | ✅ |
|
|
| ライセンスキー | ✅ |
無限のトレース | ✅ | ✅ |
|
|
| ライセンスキー | ✅ |
ステップ4：エクスポート構成ステップを完了します
エクスポートするためのNewRelic固有の構成に慣れたので、データをエクスポートする方法の手順に従います。
アプリからNewRelicに直接エクスポートする
ご使用の言語については、以下のリンクをクリックして、構成手順を完了してください。完了したら、ここに戻ってステップ5を完了します。NewRelicUIでデータを表示します。
コレクターからNewRelicにエクスポート
コレクターは、さまざまな方法でさまざまな目的に設定できます。セットアップに入る前にコレクターに関する一般的な情報が必要な場合は、概要を参照してください。
エクスポートするコレクターを設定する例を表示するには、次のいずれかを選択してください。
ステップ5：New Relic UIでデータを見る
アプリまたはサービスをインストルメントし、そのデータを New Relic にエクスポートするように構成したら、New Relic UI で トレース、 メトリクス、 ログを監視します。
OpenTelemetry の UI は APM UI といくつかの類似点があるため、慣れている場合はそのまま UI に進むことができます。OpenTelemetry UI オプションを理解するためのヘルプが必要な場合、またはデータが UI に表示されることを確認する方法については、 「 New Relic で OpenTelemetry データを表示する 」を参照してください。
このドキュメントはインストールで役立ちましたか。
サポートされていない仕様
New Relicは現在、いくつかの例外を除いて、 opentelemetry-specification v1.8.0をサポートしています。
- New Relicからの成功した応答には、データ型に基づいてProtobufでエンコードされた応答ではなく、応答本体がありません。New Relicは、認証後、デコードと検証の前に、成功を収めて応答します。
- OTLPクライアントは
Statusオブジェクトを使用しないため、NewRelicからの失敗応答にはStatus.messageまたはStatus.detailsは含まれません。
次は何ですか？
初期設定が完了したら、 エンドツーエンド実装ガイド とその他の ベスト プラクティス ガイドを確認してください。これらは、OpenTelemetry の使用を最適化するのに役立ちます。