OpenCensus tracer

    As of Envoy v1.18 the v2 API has been removed and is no longer supported.

    If you are upgrading from v2 API config you may wish to view the v2 API documentation:

    [config.trace.v3.OpenCensusConfig proto]

    Configuration for the OpenCensus tracer.

    This extension may be referenced by the qualified name

    Note

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

    Tip

    This extension extends and can be used with the following extension category:

    trace_config

    (.opencensus.proto.trace.v1.TraceConfig) Configures tracing, e.g. the sampler, max number of annotations, etc.

    stdout_exporter_enabled

    () Enables the stdout exporter if set to true. This is intended for debugging purposes.

    stackdriver_exporter_enabled

    stackdriver_project_id

    (string) The Cloud project_id to use for Stackdriver tracing.

    stackdriver_address

    () (optional) By default, the Stackdriver exporter will connect to production Stackdriver. If stackdriver_address is non-empty, it will instead connect to this address, which is in the gRPC format: https://github.com/grpc/grpc/blob/master/doc/naming.md

    stackdriver_grpc_service

    () (optional) The gRPC server that hosts Stackdriver tracing service. Only Google gRPC is supported. If target_uri is not provided, the default production Stackdriver address will be used.

    zipkin_exporter_enabled

    () Enables the Zipkin exporter if set to true. The url and service name must also be set. This is deprecated, prefer to use Envoy’s native Zipkin tracer.

    zipkin_url

    () The URL to Zipkin, e.g. “http://127.0.0.1:9411/api/v2/spans”. This is deprecated, prefer to use Envoy’s .

    ocagent_exporter_enabled

    (bool) Enables the OpenCensus Agent exporter if set to true. The ocagent_address or ocagent_grpc_service must also be set.

    ocagent_address

    () The address of the OpenCensus Agent, if its exporter is enabled, in gRPC format: https://github.com/grpc/grpc/blob/master/doc/naming.md

    ocagent_grpc_service

    incoming_trace_context

    (repeated ) List of incoming trace context headers we will accept. First one found wins.

    outgoing_trace_context

    (repeated config.trace.v3.OpenCensusConfig.TraceContext) List of outgoing trace context headers we will produce.

    Enum config.trace.v3.OpenCensusConfig.TraceContext

    [config.trace.v3.OpenCensusConfig.TraceContext proto]

    NONE

    (DEFAULT) ⁣No-op default, no trace context is utilized.

    TRACE_CONTEXT

    ⁣W3C Trace-Context format “traceparent:” header.

    GRPC_TRACE_BIN

    ⁣Binary “grpc-trace-bin:” header.

    CLOUD_TRACE_CONTEXT

    ⁣”X-Cloud-Trace-Context:” header.

    B3

    ⁣X-B3-* headers.