Redis レシーバー

Redis レシーバーは、特定の Redis インスタンスから Redis INFO データを取得し、そこからメトリクスを構築します。

Redis レシーバーは、単一の Redis インスタンスから Redis INFO データを取得し、そのデータからメトリクスを構築し、それらを設定可能な間隔で次のコンシューマに送信するように設計されています。Redis INFO コマンドは、Redis サーバーに関する情報と統計を返します。Redis レシーバーは結果から値を抽出し、それらを OpenTelemetry メトリクスに変換します。

たとえば、Redis INFO コマンドは used_cpu_sys を返し、Redis インスタンスの開始以降に Redis サーバーが消費したシステム CPU を秒数で表します。Redis レシーバーはこのデータを、redis.cpu.time というメトリクス名と秒の単位値を持つゲージに変換します。

詳細については、以下を参照してください。

はじめに

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

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

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

  3. Collector を再起動します。

サンプル構成

Collector 設定で Redis レシーバーを手動でアクティブにするには、次の例に示すように、設定ファイルの receivers セクションに redis を追加します：

receivers:
  redis:
    endpoint: "localhost:6379"
    username: "test"
    password: "test"
    collection_interval: 10s
    tls:
      insecure: true

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

service:
  pipelines:
    metrics:
      receivers: [redis]

コンフィギュレーション設定

以下の設定が必要です：

  • endpoint：Redis インスタンスのホスト名とポートをコロンで区切って指定します。デフォルト値はありません。

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

  • collection_interval：このレシーバーは一定間隔で実行されます。実行されるたびに Redis にクエリを実行し、メトリクスを作成して次のコンシューマに送信します。collection_interval 設定オプションは、実行間の期間をレシーバーに通知します。

    • collection_interval は 1h30m のような Golang の ParseDuration 関数で読める文字列にする必要があります。有効な時間単位は ns、us（または µs）、ms、s、m、h です。デフォルトでは 10s です。

  • password：Redis インスタンスへのアクセスに使用するパスワード。requirepass サーバー設定オプションで指定したパスワードと一致する必要があります。デフォルト値はありません。

  • transport: サーバーへの接続に使用するネットワークを定義します: tcp または unix。デフォルトは tcp です。

  • tls：

    • insecure：エクスポータの接続のクライアント トランスポート セキュリティを無効にするかどうか。デフォルトでは true です。

    • ca_file：CA 証明書へのパス。クライアントの場合は、これによりサーバー証明書を検証します。

      • insecure が false に設定されている場合のみ使用します。

    • cert_file: TLS が必要な接続に使用する TLS 認証へのパス。

      • insecure が false に設定されている場合のみ使用します。

    • key_file: TLSが必要な接続に使用するTLSキーへのパス。

      • insecure が false に設定されている場合のみ使用します。

環境変数を使用してレシーバーを設定する

OpenTelemetry では、環境変数を使用してコンポーネントを構成できます。たとえば、環境変数 REDIS_PASSWORD の値を取得するには、次を使用します。

receivers:
  redis:
    endpoint: "localhost:6379"
    collection_interval: 10s
    password: ${env:REDIS_PASSWORD}

設定

以下の表に、Redis レシーバーの設定オプションを示します：

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/receiver/redis.yaml

メトリクス

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

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/metric-metadata/redisreceiver.yaml

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______