Docs » Splunk Observability Cloud でサポートされているインテグレーション » ネットワーク用アプリケーション・レシーバーの設定 » Statsd

Statsd 🔗

Splunk Distribution of OpenTelemetry Collector は、Smart Agent レシーバーstatsd モニタータイプを使用して statsd メトリクスを収集します。設定されたアドレスとポートでリッスンし、statsd メトリクスを受信します。

このインテグレーションでは、CounterTimerGaugeSet のタイプをサポートしており、それぞれ Splunk Observability Cloud のタイプ countergaugegaugegauge としてディスパッチされます。タグなどの Statsd 拡張はサポートされていません。

このインテグレーションはKubernetesとLinuxで利用できます。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります:

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください:

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

  2. 設定のセクションで説明するように、モニターを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

インストールの確認 🔗

インストールを確認するには、netcat で statsd メトリクスをローカルに以下のように送信し、Splunk Observability Cloud でメトリクスが到着したことを確認します:

$ echo "statsd.test:1|g" | nc -w 1 -u 127.0.0.1 8125

Kubernetes環境では、status.hostIP 環境変数を使用してインストールを確認します。この環境変数は、ポッドが稼働しているノードのIPアドレスです。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います:

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します:

receivers:
  smartagent/statsd:
    type: statsd
    ...  # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します:

service:
  pipelines:
    metrics:
      receivers: [smartagent/statsd]

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

次の表は、statsd モニターの設定オプションを示します:

オプション

必須

タイプ

説明

listenAddress

いいえ

string

statsdデータグラムを受け入れる UDPリスナーをバインドするホストまたは

アドレス。デフォルト値は localhost です。

listenPort

いいえ

integer

statsd メッセージをリッスンするポート。デフォルト

値は 8125 です。

metricPrefix

いいえ

string

メトリクス名の変換の前に削除する必要があるメトリクス名の

接頭辞。

converters

いいえ

list of objects (see below)

statsd のメトリクス名を SignalFx メトリクス名とディメンションに変換する

コンバータのリスト。

ネストされた converters コンフィギュレーション・オブジェクトには以下のフィールドがあります:

オプション

必須

タイプ

説明

pattern

いいえ

string

statsd メトリクス名とマッチするパターン。

metricName

いいえ

string

Splunk Observability Cloudに報告するメトリクス名を作成するための

Splunk Observability Cloud.

メトリクス 🔗

This integration doesn’t produce any metrics unless configured.

このモニターでどのようにメトリクスを収集できるかについては、以下のセクションを参照してください。

statsdメトリクスにディメンションを追加する 🔗

statsdモニターは、次の例に示すように、ユーザーによって設定されたコンバーターのセットによって、statsdメトリクス名からキーワードを解析することができます:

converters:
  - pattern: "cluster.cds_{traffic}_{mesh}_{service}-vn_{}.{action}"
    ...

このコンバータは、trafficmeshserviceaction を、cluster.cds_egress_ecommerce-demo-mesh_gateway-vn_tcp_8080.update_success メトリクスのディメンションとして解析します。セクションに名前のない括弧のペアしかない場合、それはディメンションをキャプチャしません。

複数のコンバータが提供されている場合、メトリクスは、メトリクス名に一致するパターンを持つ最初のコンバータによって変換されます。

メトリクス名のフォーマット 🔗

以下の例に示すように、コンバーターの設定内でフォーマット文字列を指定することで、メトリクス名をカスタマイズすることができます:

converters:
  - pattern: "cluster.cds_{traffic}_{mesh}_{service}-vn_{}.{action}"
    metricName: "{traffic}.{action}"

指定されたパターンに一致するメトリクスは、{traffic}.{action} として Infrastructure Monitoring に報告されます。例えば、メトリクス cluster.cds_egress_ecommerce-demo-mesh_gateway-vn_tcp_8080.update_successegress.update_success として報告されます。

metricName はコンバーター構成に必要です。 metricName が提供されない場合、コンバーターは非アクティブになります。

データポイントは、statsd メトリクスが送信されたホストではなく、エージェントが実行されている現在のホストの host ディメンションを取得します。このため、statsd メトリクスをローカル・エージェント・インスタンスに送信します。 host ディメンションが不要な場合は、モニター構成で disableHostDimensions: true を設定できます。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

This page was last updated on 2024年05月31日.