> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sawmills.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup fallback endpoint

> Configure fallback endpoints on pipeline sources so an HAProxy sidecar automatically reroutes telemetry data when the primary collector is unavailable.

Setting up fallback endpoints for your **sources** ensures that no logs are lost when your collector becomes unavailable or unhealthy. This is achieved by configuring a fallback endpoint that will receive your logs when the primary collector is not operational.

## How It Works

When you configure a fallback endpoint, the following components are automatically set up:

1. An HAProxy sidecar container is deployed alongside your collector pod
2. The HAProxy continuously monitors the health of your collector through periodic health checks and observing any response errors from the collector
3. If the collector is deemed unhealthy, HAProxy automatically routes all incoming data to the fallback endpoint
4. Once the collector is healthy again, HAProxy resumes sending data to the primary collector

This automatic failover mechanism ensures continuous log collection without any data loss.

## Configuration

Fallback endpoints are configured at the source level, allowing you to specify different fallback endpoints for different sources based on your requirements.

### Setting Up a Fallback Endpoint

1. Navigate to your pipeline in the UI
2. Choose the source you want to configure
3. Open the "Advanced Settings" section
4. Choose the Fallback Endpoint URL for this source
   <img src="https://mintcdn.com/sawmills/F46sh3cTrweQEfKi/images/Screenshot_2025-04-21_14.06.59.png?fit=max&auto=format&n=F46sh3cTrweQEfKi&q=85&s=fb5cd7964eaf52bdf232cf5694fc4984" alt="" width="1950" height="1396" data-path="images/Screenshot_2025-04-21_14.06.59.png" />

Fallback endpoints are supported for the following sources:

* **Coralogix**
* **Datadog**
* **Elastic**
* **Grafana Loki**

<Note>
  {" "}

  When configuring a custom fallback endpoint for a URL-based source (for
  example, Elastic or Grafana Loki), the endpoint URL should be with the
  protocol and without the path part (e.g.
  [http://loki-gateway.default.svc.cluster.local).\{](http://loki-gateway.default.svc.cluster.local\).\{)" "}
</Note>

For **Coralogix** sources, select the Coralogix region that should receive
fallback traffic. You can choose a supported region from the dropdown or enter a
custom hostname. The UI formats custom hostnames with the Coralogix `ingress.`
prefix and `:443` port.

### Configuring Custom Values

For some sources, such as Datadog, it's possible to control some of the HAProxy configurations such as timeouts.
Those advanced configurations can be setup via the values your helm chart.
To modify values, update the `managedChartsValues.sawmills-collector.haproxy` section in your `values.yaml` file and then upgrade the remote operator.

```yaml theme={null}
managedChartsValues:
  sawmills-collector:
    haproxy:
      fallback_config:
        server:
          fall: 4
          interval: null
          rise: null
        timeout:
          client: null
          connect: 5000
          server: null
```

* **Connect Timeout**
  * *Description*: The maximum time to wait for a connection attempt for the collector and fallback (in milliseconds, default: 5000).
  * *Type*: number

* **Server Timeout**
  * *Description*: The maximum inactivity time on the server side for the collector and fallback endpoint (in milliseconds, default: 5000).
  * *Type*: number

* **Client Timeout**
  * *Description*: The maximum inactivity time on the client side for the collector and fallback endpoint (in milliseconds, default: 5000).
  * *Type*: number

* **Server Interval**
  * *Description*: The interval between health checks of the collector (in milliseconds, default: 2000).
  * *Type*: number

* **Server Rise**
  * *Description*: The number of successful health checks to the collector before marking it up (default: 10).
  * *Type*: number

* **Server Fall**
  * *Description*: The number of failed health checks to the collector before marking it down (default: 1).
  * *Type*: number

## Benefits

* **Zero Data Loss**: Ensures all logs are captured even when the primary collector is down
* **Automatic Failover**: Seamless switching between primary and fallback endpoints
* **Per-Source Configuration**: Flexibility to configure different fallback endpoints for different sources

<Note>
  {" "}

  Fallback endpoints are currently only available for **Coralogix**,
  **Datadog**, **Elastic**, and **Grafana Loki** sources. If you would like to
  add a different source, please contact Sawmills support.{" "}
</Note>