⚠️ ⚠️ ⚠️ Warning⚠️ ⚠️ ⚠️ The
check_collector_pipeline
feature of this extension is not working as expected. It is recommended to not use the feature. The work to add a new version of the healthcheck extension that relies on individual component status is in progress. To avoid breaking backwards compatibility, the configuration will not be changed until the new extension is available as a replacement for this one. See open-telemetry#11780 for more details.
Status | |
---|---|
Stability | beta |
Distributions | core, contrib, aws, liatrio, observiq, redhat, splunk, sumo |
Issues | |
Code Owners | @jpkrohling |
Health Check extension enables an HTTP url that can be probed to check the status of the OpenTelemetry Collector. This extension can be used as a liveness and/or readiness probe on Kubernetes.
There is an optional configuration check_collector_pipeline
which allows
users to enable health check for the collector pipeline. This feature can
monitor the number of times that components failed send data to the destinations.
It only supports monitoring exporter failures and will support receivers and
processors in the future.
The following settings are required:
endpoint
(default = 0.0.0.0:13133): Address to publish the health check status. For full list ofHTTPServerSettings
refer here.path
(default = "/"): Specifies the path to be configured for the health check server.response_body
(default = ""): Specifies a static body that overrides the default response returned by the health check service.check_collector_pipeline:
(optional): Settings of collector pipeline health checkenabled
(default = false): Whether enable collector pipeline check or notinterval
(default = "5m"): Time interval to check the number of failuresexporter_failure_threshold
(default = 5): The failure number threshold to mark containers as healthy.
Example:
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
The full list of settings exposed for this exporter is documented here with detailed sample configurations here.