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以上で動作します。

メリット

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

メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。

インストール

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

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetes にインストールする
- Linux にインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：Collector を理解して使用する」を参照してください。

例

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

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

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

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

設定オプション

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

{"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 の設定方法を参照してください。

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______