Consulデータストア(非推奨)

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

注意: このインテグレーションは非推奨であり、将来のリリースで削除される予定です。この期間中は、重要なセキュリティとバグ修正のみが提供されます。サポート終了日を迎えると、モニターは削除され、サポートも終了するため、Splunk Observability Cloud にデータを送信できなくなります。Consul データストアメトリクスを Splunk Observability Cloud に転送するには、代わりに StatsD レシーバーまたは Prometheus レシーバーを使用します。

Splunk Distribution of OpenTelemetry Collectorは、Smart AgentレシーバーとConsulデータストアモニタータイプを使用して、Consulデータストアを監視し、以下のエンドポイントからメトリクスを収集します：

  • /agent/self

  • /agent/metrics

  • /catalog/nodes

  • /catalog/node/:node

  • /status/leader

  • /status/peers

  • /coordinate/datacenters

  • /coordinate/nodes

  • /health/state/any

このインテグレーションはKubernetesとLinuxでのみ利用可能です。

このインテグレーションはConsul 0.7.0以上で動作します。

メリット

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

インストール

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

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

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

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

設定

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

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

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

例

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

YAML 
receivers:
  smartagent/consul:
    type: collectd/consul
    ...  # Additional config

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

YAML 
service:
  pipelines:
    metrics:
      receivers: [smartagent/consul]

設定オプション

0.9.1 より前のバージョンの Consul を使用している場合は、OpenTelemetry Collector にメトリクスを送信するように、監視したい各 Consul エージェントを設定してください。これを行うには、各 Consul エージェントの設定ファイルに次の設定を追加します。

YAML 
{"telemetry":
   {"statsd_address": "<agent host>:<agent port, default 8125>"}
}

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

次の表に、このインテグレーションの設定オプションを示します：

オプション

必須

タイプ

説明

pythonBinary

いいえ

string

 Pythonコードを実行するために使用するpythonバイナリへの

パスです。設定されていない場合は、組み込みランタイムが使用されます。また、バイナリへの引数を含めることもできます。

host

〇

string

port

〇

integer

aclToken

いいえ

string

Consul ACL トークン

useHTTPS

いいえ

bool

 HTTPS を使って Consul に接続するには、true に設定します。サーバーの

証明書を caCertificate 設定オプションで指定できます。（デフォルト：false）

telemetryServer

いいえ

bool

（デフォルト：false）

telemetryHost

いいえ

string

 テレメトリ UDP パケットを送信するためにConsulが設定されているIPアドレスまたはDNS。

telemetryServer が true に設定されている場合にのみ関連します。（デフォルト：0.0.0.0）

telemetryPort

いいえ

integer

 テレメトリUDPパケットを送信するためにConsulが設定されているポート。

telemetryServer が true に設定されている場合にのみ関連します。（デフォルト：8125）

enhancedMetrics

いいえ

bool

 すべてのメトリクスの収集元を有効にするには、true に設定します。

Consul ランタイムテレメトリは UDP を使用して送信されるか、/agent/metrics エンドポイントから送信されます。（デフォルト：false）

caCertificate

いいえ

string

 ConsulサーバーがAPIに対してHTTPSを有効にしている場合、

CA 証明書へのパスを指定します。

clientCertificate

いいえ

string

 クライアント側認証が有効になっている場合は、証明書ファイルへのパスを指定します。

証明書ファイルへのパス。

clientKey

いいえ

string

 クライアント側認証が有効になっている場合は、証明書ファイルへのパスを指定します。

キーファイルへのパス。

signalFxAccessToken

いいえ

string

メトリクス

これらのメトリクスは、このインテグレーションで利用可能です。

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/collectd/consul/metadata.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

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.