Kafka メトリクスレシーバー

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するようにレシーバーを設定します。

3. Collector を再起動します。

サンプル構成

Kafkaメトリクスレシーバーを有効にするには、次の例のように、設定ファイルの kafkametrics セクションに receivers を追加します：

receivers:
  kafkametrics:
    protocol_version: 2.0.0
    scrapers:
      - brokers
      - topics
      - consumers

設定を完了するには、構成ファイルの service セクションの metrics パイプラインにレシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers: [kafkametrics]

設定オプション

以下の設定が必要です：

• protocol_versionします。デフォルトなしKafka プロトコルバージョン、たとえば 2.0.0。

• scrapersします。デフォルトなし以下のスクレイパーの任意の組み合わせを有効にできます。

  • topics

  • consumers

  • brokers

以下の設定はオプションです：

• brokers。デフォルトでは localhost:9092 です。読み込み元のブローカーのリスト。

• resolve_canonical_bootstrap_servers_only。デフォルトでは false です。起動時にブローカー IP を解決してからルックアップするかどうかを決定します。

• topic_match。デフォルトでは ^[^_].*$) です。メトリクスコレクションでフィルタ処理するトピックの正規表現パターン。デフォルトのフィルタでは、_ で始まる内部トピックは除外されます。

• group_match。デフォルトでは .*) です。メトリクス用にフィルタ処理するコンシューマグループの正規表現パターン。

• client_id。デフォルトでは otel-metrics-receiver です。コンシューマクライアント ID。

• collection_interval。デフォルトでは 1m です。メトリクス収集とスクレイピングの頻度。

• initial_delay。デフォルトでは 1s です。このレシーバーが開始するまでの待ち時間を決定します。

• authします。デフォルトなし次のいずれかを使用します。

  • plain_textします。次のフィールドがあります。

    • usernameします。使用するユーザー名。

    • passwordします。使用するパスワード。

  • tlsします。次のフィールドがあります。

    • ca_fileします。insecure が false に設定されている場合にのみ使用します。CA 証明書へのパスで、クライアントではサーバー証明書を検証します。

    • cert_fileします。insecure が false に設定されている場合にのみ使用します。TLS 必須接続に使用する TLS 証明書へのパス。

    • key_fileします。insecure が false に設定されている場合にのみ使用します。TLS 必須接続に使用する TLS キーへのパス。

    • insecure。デフォルトでは false です。TLS 設定で、サーバーの証明書チェーンとホスト名、InsecureSkipVerify の検証をオフにします。

    • server_name_overrideします。バーチャルホスティングをサポートするためにクライアントが要求したサーバー名を示します。

  • kerberosします。次のフィールドがあります。

    • service_nameします。Kerberos サービス名。

    • realmします。Kerberos レルム。

    • use_keytabします。true の場合、パスワードの代わりに keytab が使われます。

    • usernameします。KDC での認証に使用する Kerberos ユーザー名。

    • passwordします。KDC での認証に使用する Kerberos パスワード。

    • config_fileします。Kerberos 設定へのパス、たとえば /etc/krb5.conf。

    • keytab_fileします。keytab ファイルへのパス、たとえば /etc/security/kafka.keytab。

    • disable_fast_negotiation。デフォルトでは false です。PA-FX-FAST ネゴシエーション（事前認証フレームワーク：高速）をオフにします。一般的な Kerberos 実装の一部は、PA-FX-FAST ネゴシエーションをサポートしていません。

設定例：認証と収集間隔を5秒に設定します

この例では、すべてのスクレイパーの収集間隔を5秒に設定し、TLS認証を設定しています：

receivers:
  kafkametrics:
    brokers: 10.10.10.10:9092
    protocol_version: 2.0.0
    scrapers:
      - brokers
      - topics
      - consumers
    auth:
      tls:
        ca_file: ca.pem
        cert_file: cert.pem
        key_file: key.pem
    collection_interval: 5s

設定

以下の表に、Kafkaメトリクスレシーバーの設定オプションを示します：

メトリクス

以下のメトリクス、リソース属性、および属性が使用できます。

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true

トラブルシューティング