OpenTelemetryコレクターは、テレメトリーデータを受信、処理、エクスポートするためのベンダーに依存しないツールです。 オブザーバビリティ パイプラインでコレクターを実行することをお勧めします。 コレクターの要件と設定はさまざまですが、 APM OpenTelemetryデータをコレクター経由でルーティングするのが一般的です。 これにより、オーバーヘッドがアプリケーションから離れ、追加の環境コンテキスト データ、フィルタリング、変換などでテレメトリーを強化する場所が提供されます。 インフラストラクチャモニタリングにコレクターを使用することも一般的ですが、このドキュメントではデータ処理の使用例に焦点を当てています。 詳細については、 「インフラストラクチャモニタリングのコレクター」を参照してください。
以下はコレクターをゲートウェイとして使用する例ですが、アプリケーションと同じホスト上で実行されるエージェントとしてコレクターを設定することもできます。
コレクターには、レシーバー、プロセッサ、エクスポーター、拡張機能、およびコネクタの広範なセットがあります。 これらのコンポーネントは、事前に構築されたディストリビューションにバンドルされています。 ただし、特定の要件に合わせてカスタム コンポーネントを構築したり、特定のコンポーネント セットをパッケージ化するカスタム コレクター ディストリビューションを構築したりすることも可能です。
設定は要件に応じて異なりますが、 New Relicにデータを送信するコレクターには次のような共通点があるはずです。
OTLPエクスポーター
OpenTelemetryコレクターは、 OTLP/HTTPエクスポーターを使用したデータのエクスポートをサポートしています。 エクスポーターの設定がNew Relic OTLP 要件と一致していることを確認します。
注:OTLP gRPC エクスポータはサポートされていますが、テレメトリー データの送信には OTLP/gRPC の代わりに OTLP/HTTP プロトコルを使用することをお勧めします。
バッチプロセッサ
バッチ プロセッサを使用してレコードをバッチでエクスポートするようにコレクターを構成します。 バッチ サイズと頻度がNew Relic OTLP 要件に一致するように設定されていることを確認します。
最小限の例
コレクターをインストールするには、 OpenTelemetryドキュメントに従ってください。
以下の設定でコレクターを実行し、次の内容を必ず置き換えてください。
<INSERT_NEW_RELIC_OTLP_ENDPOINT>
適切なNew Relic OTLP エンドポイントに置き換えます。<INSERT_NEW_RELIC_LICENSE_KEY>
ライセンスキーに置き換えます。
receivers: otlp: protocols: grpc: http:
processors: batch:
exporters: otlphttp: endpoint: <INSERT_NEW_RELIC_OTLP_ENDPOINT> headers: api-key: <INSERT_NEW_RELIC_LICENSE_KEY>
service: pipelines: traces: receivers: [otlp] processors: [batch] exporters: [otlphttp] metrics: receivers: [otlp] processors: [batch] exporters: [otlphttp] logs: receivers: [otlp] processors: [batch] exporters: [otlphttp]
実際の例については、 New Relic OpenTelemetry サンプル リポジトリを参照してください。
その他のコレクターの例については、 「インフラストラクチャモニタリングのコレクター」を参照してください。