健全性チェック エクステンション 🔗
health_check エクステンションは、OpenTelemetry Collector のステータスをチェックするためにプローブ可能な HTTP URL を有効にします。このエクステンションは、Kubernetes 上で有効性または準備状況のプローブとして使用することができます。
はじめに 🔗
注釈
このコンポーネントは、ホスト監視 (エージェント) モードでデプロイする場合、Splunk Distribution of the OpenTelemetry Collector のデフォルト設定に含まれます。詳細は Collector のデプロイモード を参照してください。
デフォルト設定の詳細については、Helmで Collector for Kubernetes を設定する、Collector for Linux のデフォルト設定、または Collector for Windows のデフォルト設定 を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように、
basicauthエクステンションを設定します。Collector を再起動します。
サンプル構成 🔗
コンポーネントをアクティブにするには、設定ファイルの extensions セクションに health_check を追加します：
extensions:
health_check:
設定を完了するには、設定ファイルの service セクションに拡張子を含めます：
service:
extensions: [health_check]
エクステンションの設定には以下の設定が必要です：
endpoint.ヘルスチェックのステータスを公開するアドレス。デフォルトでは0.0.0.0:13133です。path.ヘルスチェックサーバーに設定するパス。デフォルトでは"/"です。response_body。ヘルスチェックサービスが返すデフォルトのレスポンスをオーバーライドする静的ボディ。デフォルトでは""です。enabled.Collectorパイプラインチェックを有効にするかどうか。デフォルトではfalseです。interval。障害数をチェックする間隔。デフォルトでは5mです。exporter_failure_threshold。コンテナを正常としてマークする障害数のしきい値。デフォルトでは5です。
設定例 🔗
これはエクステンションの基本的な設定例です：
extensions:
health_check:
health_check/1:
endpoint: "localhost:13"
tls:
ca_file: "/path/to/ca.crt"
cert_file: "/path/to/cert.crt"
key_file: "/path/to/key.key"
path: "/health/status"
check_collector_pipeline:
enabled: true
interval: "5m"
exporter_failure_threshold: 5
これは詳細な設定例です：
health_check:
health_check/1:
endpoint: "localhost:13"
tls:
ca_file: "/path/to/ca"
key_file: "/path/to/key"
cert_file: "/path/to/cert"
check_collector_pipeline:
enabled: false
interval: "5m"
exporter_failure_threshold: 5
health_check/missingendpoint:
endpoint: ""
check_collector_pipeline:
enabled: false
interval: "5m"
exporter_failure_threshold: 5
health_check/invalidthreshold:
endpoint: "localhost:13"
check_collector_pipeline:
enabled: false
interval: "5m"
exporter_failure_threshold: -1
health_check/invalidpath:
endpoint: "localhost:13"
path: "invalid"
check_collector_pipeline:
enabled: false
interval: "5m"
exporter_failure_threshold: 5
Collectorのパイプラインをチェックする 🔗
オプションで、設定パラメータ check_collector_pipeline を使用して Collector パイプラインのヘルスチェックを有効にできます。有効にすると、コンポーネントが宛先へのデータ送信に失敗した回数を監視できます。
エクスポーターの故障にのみ対応し、レシーバーやプロセッサーには対応しないことに注意してください。
設定 🔗
次の表は、health_check エクステンションの設定オプションを示しています：
トラブルシューティング 🔗
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。
Splunk Observability Cloudをご利用のお客様
Splunk サポートポータル でケースを送信する
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。