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

注意

このインテグレーションは非推奨となっており、将来のリリースで削除されます。この期間中は、重要なセキュリティおよびバグ修正のみが提供されます。サポートが終了すると、モニターは削除され、サポート対象外となり、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` config オプションで指定できます。(デフォルト: `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`

メトリクス 🔗

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

備考 🔗

Splunk Observability Cloudで利用可能なメトリクスタイプの詳細は、メトリクスタイプを参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloudのホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されず、料金が発生する場合があります。詳細については、メトリクスカテゴリを参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日に最終更新されました。

Related Topics