.. _envoy_api_file_envoy/config/trace/v2/lightstep.proto:

LightStep tracer
================


.. _envoy_api_msg_config.trace.v2.LightstepConfig:

config.trace.v2.LightstepConfig
-------------------------------

`[config.trace.v2.LightstepConfig proto] <https://github.com/envoyproxy/envoy/blob/cffb095d59d7935abda12b9509bcd136808367bb/api/envoy/config/trace/v2/lightstep.proto#L16>`_

Configuration for the LightStep tracer.

.. _extension_envoy.tracers.lightstep:


This extension may be referenced by the qualified name *envoy.tracers.lightstep*

.. note::
  

  This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted.

.. code-block:: json

  {
    "collector_cluster": "...",
    "access_token_file": "...",
    "propagation_modes": []
  }

.. _envoy_api_field_config.trace.v2.LightstepConfig.collector_cluster:

collector_cluster
  (`string <https://developers.google.com/protocol-buffers/docs/proto#scalar>`_, *REQUIRED*) The cluster manager cluster that hosts the LightStep collectors.
  
  
.. _envoy_api_field_config.trace.v2.LightstepConfig.access_token_file:

access_token_file
  (`string <https://developers.google.com/protocol-buffers/docs/proto#scalar>`_, *REQUIRED*) File containing the access token to the `LightStep
  <https://lightstep.com/>`_ API.
  
  
.. _envoy_api_field_config.trace.v2.LightstepConfig.propagation_modes:

propagation_modes
  (**repeated** :ref:`config.trace.v2.LightstepConfig.PropagationMode <envoy_api_enum_config.trace.v2.LightstepConfig.PropagationMode>`) Propagation modes to use by LightStep's tracer.
  
  

.. _envoy_api_enum_config.trace.v2.LightstepConfig.PropagationMode:

Enum config.trace.v2.LightstepConfig.PropagationMode
----------------------------------------------------

`[config.trace.v2.LightstepConfig.PropagationMode proto] <https://github.com/envoyproxy/envoy/blob/cffb095d59d7935abda12b9509bcd136808367bb/api/envoy/config/trace/v2/lightstep.proto#L18>`_

Available propagation modes

.. _envoy_api_enum_value_config.trace.v2.LightstepConfig.PropagationMode.ENVOY:

ENVOY
  *(DEFAULT)* ⁣Propagate trace context in the single header x-ot-span-context.
  
  
.. _envoy_api_enum_value_config.trace.v2.LightstepConfig.PropagationMode.LIGHTSTEP:

LIGHTSTEP
  ⁣Propagate trace context using LightStep's native format.
  
  
.. _envoy_api_enum_value_config.trace.v2.LightstepConfig.PropagationMode.B3:

B3
  ⁣Propagate trace context using the b3 format.
  
  
.. _envoy_api_enum_value_config.trace.v2.LightstepConfig.PropagationMode.TRACE_CONTEXT:

TRACE_CONTEXT
  ⁣Propagation trace context using the w3 trace-context standard.