健全性チェック エクステンション 🔗
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をご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。