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

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

メトリクス

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

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

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

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

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 メトリクスからのディメンションとして解析します。セクションに名前のない括弧のペアしかない場合、それはディメンションをキャプチャしません。

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

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

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

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 を設定できます。

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

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

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