Project: Gloo (Orchestration & Management / API Gateway)
File: opencensus.proto.sk.md

title: "opencensus.proto" weight: 5 <!-- Code generated by solo-kit. DO NOT EDIT. --> Configuration for the OpenCensus tracer. The OpenCensus tracer is capable of reporting metadata to a collector using W3C-standard Trace Context: https://www.w3.org/TR/trace-context/ WARNING: users should take care to note that this plugin has a serious limitation that can cause a configuration freeze of Envoy's dynamic listeners. This plugin can be initialised once after Envoy has started. In order to change this plugin's configuration, users must first apply the new configuration, and then restart Envoy. Users should also be aware that once the new configuration is applied, Envoy will reject any changes to its dynamic listeners configuration until after it has been restarted. [#extension: envoy.tracers.opencensus] ```yaml "traceConfig": .solo.io.envoy.config.trace.v3.TraceConfig "ocagentExporterEnabled": bool "httpAddress": string "grpcAddress": .solo.io.envoy.config.trace.v3.OpenCensusConfig.OcagentGrpcAddress "incomingTraceContext": []solo.io.envoy.config.trace.v3.OpenCensusConfig.TraceContext "outgoingTraceContext": []solo.io.envoy.config.trace.v3.OpenCensusConfig.TraceContext ``` | Field | Type | Description | | -- | - | -- | | `traceConfig` | | Configuration of when to submit traces to the collector. See https://github.com/census-instrumentation/opencensus-proto/blob/3619b5dda8bff26ff1974714c24de8f6d4953811/src/opencensus/proto/trace/v1/trace_config.proto#L29 for full documentation. | | `ocagentExporterEnabled` | `bool` | Enables the OpenCensus agent if set to true. | | `httpAddress` | `string` | Send to upstream over http. Only one of `httpAddress` or `grpcAddress` can be set. | | `grpcAddress` | | Send to upstream over GRPC. Only one of `grpcAddress` or `httpAddress` can be set. | | `incomingTraceContext` | | List of incoming trace context headers to accept. First one found wins. | | `outgoingTraceContext` | | List of outgoing trace context headers we will produce. | ```yaml "targetUri": string "statPrefix": string ``` | Field | Type | Description | | -- | - | -- | | `targetUri` | `string` | URI of the target address. | | `statPrefix` | `string` | Prefix for statistical measurements. | | Name | Description | | -- | -- | | `NONE` | No-op default, no trace context is utilized. | | `TRACE_CONTEXT` | W3C Trace-Context format "traceparent:" header. | | `GRPCTRACEBIN` | Binary "grpc-trace-bin:" header. | | `CLOUDTRACECONTEXT` | "X-Cloud-Trace-Context:"

| | `B3` | X-B3-* headers. | ```yaml "probabilitySampler": .solo.io.envoy.config.trace.v3.ProbabilitySampler "constantSampler": .solo.io.envoy.config.trace.v3.ConstantSampler "rateLimitingSampler": .solo.io.envoy.config.trace.v3.RateLimitingSampler "maxNumberOfAttributes": int "maxNumberOfAnnotations": int "maxNumberOfMessageEvents": int "maxNumberOfLinks": int ``` | Field | Type | Description | | -- | - | -- | | `probabilitySampler` | | Only one of `probabilitySampler`, `constantSampler`, or `rateLimitingSampler` can be set. | | `constantSampler` | | Only one of `constantSampler`, `probabilitySampler`, or `rateLimitingSampler` can be set. | | `rateLimitingSampler` | | Only one of `rateLimitingSampler`, `probabilitySampler`, or `constantSampler` can be set. | | `maxNumberOfAttributes` | `int` | The global default max number of attributes per span. | | `maxNumberOfAnnotations` | `int` | The global default max number of annotation events per span. | | `maxNumberOfMessageEvents` | `int` | The global default max number of message events per span. | | `maxNumberOfLinks` | `int` | The global default max number of link entries per span. | Sampler that tries to uniformly sample traces with a given probability. The probability of sampling a trace is equal to that of the specified probability. ```yaml "samplingProbability": float ``` | Field | Type | Description | | -- | - | -- | | `samplingProbability` | `float` | The desired probability of sampling. Must be within [0.0, 1.0]. | Sampler that always makes a constant decision on span sampling. ```yaml "decision": .solo.io.envoy.config.trace.v3.ConstantSampler.ConstantDecision ``` | Field | Type | Description | | -- | - | -- | | `decision` | | | How spans should be sampled: Always off Always on Always follow the parent Span's decision (off if no parent). | Name | Description | | -- | -- | | `ALWAYS_OFF` | | | `ALWAYS_ON` | | | `ALWAYS_PARENT` | | Sampler that tries to sample with a rate per time window. ```yaml "qps": int ``` | Field | Type | Description | | -- | - | -- | | `qps` | `int` | Rate per second. | <!-- Start of HubSpot Embed Code --> <script type="text/javascript" id="hs-script-loader" async defer src="//js.hs-scripts.com/5130874.js"></script> <!-- End of HubSpot Embed Code -->