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 を追加します:

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

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

YAML
service:
  pipelines:
    metrics:
      receivers: [redis]

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

以下の設定が必要です:

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

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

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

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

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

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

  • tls

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

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

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

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

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

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

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

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

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

YAML
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

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.