OpenTelemetry コレクター

概要

OpenTelemetry は、テレメトリーデータのベンダーに依存しない標準です。Datadog は、OpenTelemetry コレクターと Datadog Agent を通じて、OpenTelemetry データの取り込みをサポートしています。このタイルでは、Datadog Exporter OpenTelemetry コレクター Datadog エクスポーターを使用して OpenTelemetry コレクターから Datadog にデータをエクスポートする方法を説明します。また、Datadog Agent で OTLP トレースを取り込む方法については、Datadog Agent における OTLP の取り込みを参照してください。

OpenTelemetry コレクターは、ベンダーに依存しない Agent プロセスで、Datadog エクスポーターを通じてテレメトリーデータを Datadog サーバーに直接エクスポートします (Agent のインストールは必要ありません)。インスツルメンテーションされたアプリケーションからのメトリクスとトレース、および一般的なシステムメトリクスをレポートします。

ホストメトリクスは OpenTelemetry ホストメトリクスのデフォルトダッシュボードに表示されますが、OpenTelemetry コレクターを使用して任意のメトリクスを Datadog に送信することができます。ホストメトリクスレシーバーで生成されるような system.* や process.* 以下のメトリクスは、Datadog Agent からのメトリクスと衝突しないように、otel.system.* や otel.process.* に名前変更されています。さらに、OpenTelemetry コレクターのメトリクスは、OpenTelemetry コレクターメトリクスのデフォルトダッシュボードに表示されます。

セットアップ

インストール

OpenTelemetry コレクターのドキュメントに従って opentelemetry-collector-contrib ディストリビューションをインストールするか、Datadog Exporter を含むその他のディストリビューションを使用してください。

このセットアップでテレメトリーデータを Datadog にエクスポートするには、Datadog Agent は必要ありません。Datadog Agent を使用する場合は、Datadog Agent における OTLP の取り込みを参照してください。

コンフィギュレーション

OpenTelemetry コレクターからテレメトリーデータを Datadog にエクスポートするには、Datadog エクスポーターをお使いのメトリクスおよびトレースパイプラインに追加します。 この時必要な設定は API キーのみです。

システムメトリクスの取得に最低限必要なコンフィギュレーションファイルは以下の通りです。

receivers:
  hostmetrics:
    scrapers:
      load:
      cpu:
      disk:
      filesystem:
      memory:
      network:
      paging:
      process:

processors:
  batch:
    timeout: 10s

exporters:
  datadog:
    api:
      key: "<Your API key goes here>"

service:
  pipelines:
    metrics:
      receivers: [hostmetrics]
      processors: [batch]
      exporters: [datadog]

Datadog エクスポーターの設定とパイプラインの構成方法についての詳細は、OpenTelemetry コレクター向け Datadog エクスポーターをご覧ください。

メトリクスの種類についてはメトリクスセクションを、このチェックで提供されるメトリクスの一覧については metadata.csv を参照してください。上記のサンプル構成のように hostmetrics レシーバーを使用している場合、他のOpenTelemetry Collector のコンポーネントで任意のメトリクスを送信することができます。

ホストメトリクスレシーバーの説明に従って、異なるグループのメトリクスを有効にし、カスタマイズすることができます。 CPU とディスクのメトリクスは、macOS では利用できません。

検証

OpenTelemetry コレクターのログで Datadog エクスポーターが有効化されており、正常に起動したことを確認してください。 たとえば、上記のコンフィギュレーションの場合は以下のようなログメッセージを確認することができます。

Exporter is enabled.    {"component_kind": "exporter", "exporter": "datadog"}
Exporter is starting... {"component_kind": "exporter", "component_type": "datadog", "component_name": "datadog"}
Exporter started.   {"component_kind": "exporter", "component_type": "datadog", "component_name": "datadog"}
Everything is ready. Begin running and processing data.

収集データ

メトリクス

サービスのチェック

OpenTelemetry コレクターには、サービスのチェック機能は含まれません。

イベント

OpenTelemetry コレクターには、イベントは含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。