OpenTelemetryを統合してメトリクスを表示する

EMQXは、gRPC OTELプロトコルを介してメトリクスをOpenTelemetry Collectorに直接プッシュする機能を標準でサポートしています。Collectorはその後、データを任意のバックエンドにルーティング、フィルタリング、変換して保存および可視化が可能です。

このページでは、EMQXとOpenTelemetryをダッシュボードを通じて統合し、PrometheusでEMQXのメトリクスを表示する方法を紹介します。

注意

EMQX 6.3.0では、Dynatrace統合はOpenTelemetryメトリクスをサポートしていません。

前提条件

OpenTelemetryとPrometheusを統合する前に、それぞれをデプロイおよび設定する必要があります。

• OpenTelemetry Collectorをデプロイします。
• CollectorのgRPC受信ポート（デフォルトは4317）とPrometheusメトリクスのエクスポートポート（8889）を設定します。

# otel-collector-config.yaml
receivers:
  otlp:
    protocols:
      grpc:

exporters:
  prometheus:
    endpoint: "0.0.0.0:8889"

processors:
  batch:

service:
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [prometheus]

• Prometheusをデプロイします。
• PrometheusがCollectorで収集されたメトリクスをスクレイプするよう設定します。

# prometheus.yaml
scrape_configs:
  - job_name: 'otel-collector'
    scrape_interval: 10s
    static_configs:
      - targets: ['otel-collector:8889'] # EMQXメトリクス
      - targets: ['otel-collector:8888'] # Collectorメトリクス

EMQXでOpenTelemetryメトリクスを有効化する

EMQXのOpenTelemetryメトリクス機能との統合は、EMQXダッシュボードまたは設定ファイルで行えます。ダッシュボードでは、左のナビゲーションメニューからManagement -> Monitoringをクリックし、Integrationタブでメトリクスの設定を行います。

opentelemetry.exporter.endpointには1つのURLを指定します。URLはhttpまたはhttpsスキームを使用し、明示的なポート番号を含める必要があります。例えば、http://localhost:4317は有効ですが、localhost:4317やhttp://localhostは無効です。

EMQXがローカルで動作している場合は、以下の設定をcluster.hoconファイルに追加してください。

opentelemetry {
  exporter {
    endpoint = "http://localhost:4317"
    headers {
      authorization = "Basic dXNlcjpwYXNzd29yZA=="
    }
  }
  metrics {
     interval = "10s"
  }
}

PrometheusでEMQXメトリクスを可視化する

EMQXのメトリクスはPrometheusのWebコンソール（http://otel-collector:9090）で確認できます。