github.com/Jeffail/benthos/v3@v3.65.0/website/docs/components/tracers/about.md (about)

     1  ---
     2  title: Tracers
     3  sidebar_label: About
     4  ---
     5  
     6  A tracer type represents a destination for Benthos to send tracing events to such as [Jaeger][jaeger].
     7  
     8  When a tracer is configured all messages will be allocated a root span during ingestion that represents their journey through a Benthos pipeline. Many Benthos processors create spans, and so tracing is a great way to analyse the pathways of individual messages as they progress through a Benthos instance.
     9  
    10  Some inputs, such as `http_server` and `http_client`, are capable of extracting a root span from the source of the message (HTTP headers). This is
    11  a work in progress and should eventually expand so that all inputs have a way of doing so.
    12  
    13  A tracer config section looks like this:
    14  
    15  ```yaml
    16  tracer:
    17    jaeger:
    18      agent_address: localhost:6831
    19      sampler_param: 1
    20      sampler_type: const
    21      service_name: benthos
    22  ```
    23  
    24  WARNING: Although the configuration spec of this component is stable the format of spans, tags and logs created by Benthos is subject to change as it is tuned for improvement.
    25  
    26  import ComponentSelect from '@theme/ComponentSelect';
    27  
    28  <ComponentSelect type="tracers" singular="tracing target"></ComponentSelect>
    29  
    30  
    31  [jaeger]: https://www.jaegertracing.io/