健全性チェック エクステンション
Health Check 拡張機能を使用することで、HTTP URL を有効化して OpenTelemetry Collector の状態を確認することも可能です。この拡張機能を Kubernetes の稼働状況または準備状況のプローブとして使用することもできます。
health_check 拡張機能を使用することで、HTTP URL を有効化して OpenTelemetry Collector の状態を確認することも可能です。この拡張機能は、Kubernetes の稼働状況あるいは準備状況の確認にも利用できます。
はじめに
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：
-
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: 5Collector のパイプラインをチェックする
必要に応じて、設定パラメータ check_collector_pipeline を使用して、Collector パイプラインの正常性チェックを有効にすることができます。有効化すると、コンポーネントが接続先へのデータ送信に失敗した回数をモニターできます。
エクスポーターの故障にのみ対応し、レシーバーやプロセッサーには対応しないことに注意してください。
設定
次の表は、health_check エクステンションの設定オプションを示しています：
同梱
https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/extension/health_check.yaml
トラブルシューティング
__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____
_________ __ ______ _____________ _____ _________
-
______ _ ____ __ ___ ______ _______ _______
-
_______ ______ ________
_________ __ ___________ _________ ___ ____ _____ _____
-
___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
-
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______