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

Statsd (deprecated) 🔗

注意

This integration is deprecated and will be removed in a future release. During this period only critical security and bug fixes are provided. When End of Support is reached, the monitor will be removed and no longer be supported, and you won’t be able to use it to send data to Splunk Observability Cloud.

To forward statsd metrics to Splunk Observability Cloud use the StatsD レシーバー instead.

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the statsd monitor type to collect statsd metrics. It listens on a configured address and port to receive the statsd metrics.

This integration supports certain Stats types, which are dispatched as counter or gauges types in Splunk Observability Cloud, as displayed in the table. Statsd extensions such as tags are not supported.

Statsd type

Splunk Observability Cloud type

Counter

counter

Timer

counter

Gauge

gauge

Set

gauge

このインテグレーションは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.

メトリクス 🔗

By default this monitor has no fixed metrics. Instead, it will create metrics based on your configuration.

All metrics are custom. See the section below to learn how metrics can be collected with this monitor.

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年10月21日.