Statsd (非推奨)

Statsd モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

注意: statsd メトリクスを Splunk Observability Cloud に転送するには、代わりに StatsD レシーバを使用します。

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

このインテグレーションでは、特定の統計タイプをサポートしており、テーブルに表示されているように、Splunk Observability Cloud で counter または gauges のタイプとしてディスパッチされます。タグなどの statsd エクステンションはサポートされていません。

Statsdタイプ

Splunk Observability Cloudタイプ

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 でメトリクスが到着したことを確認します：

YAML 
$ 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構成に以下を追加します：

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

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

YAML 
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。

メトリクス

デフォルトでは、このモニターに固定のメトリクスはありません。代わりに、設定に基づいてメトリクスを作成します。

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

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

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

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

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

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

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

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

YAML 
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_success は egress.update_success として報告されます。

metricName はコンバータの設定に必要です。 metricName が指定されていない場合、コンバータは非アクティブ化されます。

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

トラブルシューティング

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.