Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Generic forwarding

Generic forwarding allows asynchronous replication of ingested traces. The distributor writes received spans to both the ingester and defined endpoints, if enabled. This feature works in a “best-effort” manner, meaning that no retries happen if an error occurs during replication.


Generic forwarding does not work retroactively. Once enabled, the distributor only replicates freshly ingested spans.

Configure generic forwarding

Enabling generic forwarding requires the configuration of the distributor and overrides.

  1. First, define a list of forwarders in the distributor section. Each forwarder must specify a unique name, supported backend, and backend-specific configuration.

  2. Second, reference these forwarders in the overrides section. This allows for fine-grained control over forwarding and makes it possible to enable this feature globally or on a per-tenant basis.

For a detailed view of all the config options for the generic forwarding feature, please refer to distributor and overrides configuration pages.