| Status | |
|---|---|
| Distributions | contrib, k8s |
| Issues |   |
| Code Owners | @akats7, @fatsheep9146 |
| Exporter Pipeline Type | Receiver Pipeline Type | Stability Level |
|---|---|---|
| traces | traces | alpha |
| metrics | metrics | alpha |
| logs | logs | alpha |
Allows for health based routing between trace, metric, and log pipelines depending on the health of target downstream exporters.
If you are not already familiar with connectors, you may find it helpful to first visit the Connectors README.
The following settings are available:
priority_levels (required): list of pipeline level priorities in a 1 - n configuration, multiple pipelines can sit at a single priority level.retry_interval (optional): the frequency at which the pipeline levels will attempt to reestablish connection with all higher priority levels. Default value is 10 minutes. (See Example below for further explanation)retry_gap (optional): * Deprecated * the amount of time between trying two separate priority levels in a single retry_interval timeframe. Default value is 30 seconds. (See Example below for further explanation)max_retries (optional): Deprecated * the maximum retries per level. Default value is 10. Set to 0 to allow unlimited retries.
The connector intakes a list of priority_levels each of which can contain multiple pipelines.
If any pipeline at a stable level fails, the level is considered unhealthy and the connector will move down one priority level and route all data to the new level (assuming it is stable).
The connector will periodically try to reestablish a stable connection with the higher priority levels. retry_interval will be the frequency at which the connector will try to iterate through all unhealthy higher priority levels.
connectors:
failover:
priority_levels:
- [traces/first, traces/also_first]
- [traces/second]
- [traces/third]
retry_interval: 10s
service:
pipelines:
traces:
receivers: [otlp]
exporters: [failover]
traces/first:
receivers: [failover]
exporters: [otlp/first]
traces/second:
receivers: [failover]
exporters: [otlp/second]
traces/third:
receivers: [failover]
exporters: [otlp/third]
traces/also_first:
receivers: [failover]
exporters: [otlp/fourth]