tracing.proto

Package: tracing.options.gloo.solo.io

Types:

Source File: github.com/solo-io/gloo/projects/gloo/api/v1/options/tracing/tracing.proto

ListenerTracingSettings

Contains settings for configuring Envoy’s tracing capabilities at the listener level. See here for additional information on Envoy’s tracing capabilities. See here for additional information about configuring tracing with Gloo Gateway.

"requestHeadersForTags": []google.protobuf.StringValue
"verbose": .google.protobuf.BoolValue
"tracePercentages": .tracing.options.gloo.solo.io.TracePercentages
"zipkinConfig": .solo.io.envoy.config.trace.v3.ZipkinConfig
"datadogConfig": .solo.io.envoy.config.trace.v3.DatadogConfig
"openTelemetryConfig": .solo.io.envoy.config.trace.v3.OpenTelemetryConfig
"openCensusConfig": .solo.io.envoy.config.trace.v3.OpenCensusConfig
"environmentVariablesForTags": []tracing.options.gloo.solo.io.TracingTagEnvironmentVariable
"literalsForTags": []tracing.options.gloo.solo.io.TracingTagLiteral

Field Type Description
requestHeadersForTags []google.protobuf.StringValue Optional. If specified, Envoy will include the headers and header values for any matching request headers.
verbose .google.protobuf.BoolValue Optional. If true, Envoy will include logs for streaming events. Default: false.
tracePercentages .tracing.options.gloo.solo.io.TracePercentages Requests can produce traces by random sampling or when the x-client-trace-id header is provided. TracePercentages defines the limits for random, forced, and overall tracing percentages.
zipkinConfig .solo.io.envoy.config.trace.v3.ZipkinConfig Only one of zipkinConfig, datadogConfig, openTelemetryConfig, or openCensusConfig can be set.
datadogConfig .solo.io.envoy.config.trace.v3.DatadogConfig Only one of datadogConfig, zipkinConfig, openTelemetryConfig, or openCensusConfig can be set.
openTelemetryConfig .solo.io.envoy.config.trace.v3.OpenTelemetryConfig Only one of openTelemetryConfig, zipkinConfig, datadogConfig, or openCensusConfig can be set.
openCensusConfig .solo.io.envoy.config.trace.v3.OpenCensusConfig Only one of openCensusConfig, zipkinConfig, datadogConfig, or openTelemetryConfig can be set.
environmentVariablesForTags []tracing.options.gloo.solo.io.TracingTagEnvironmentVariable Optional. If specified, Envoy will include the environment variables with the given tag as tracing tags.
literalsForTags []tracing.options.gloo.solo.io.TracingTagLiteral Optional. If specified, Envoy will include the literals with the given tag as tracing tags.

RouteTracingSettings

Contains settings for configuring Envoy’s tracing capabilities at the route level. Note: must also specify ListenerTracingSettings for the associated listener. See here for additional information on Envoy’s tracing capabilities. See here for additional information about configuring tracing with Gloo Gateway.

"routeDescriptor": string
"tracePercentages": .tracing.options.gloo.solo.io.TracePercentages
"propagate": .google.protobuf.BoolValue

Field Type Description
routeDescriptor string Optional. If set, will be used to identify the route that produced the trace. Note that this value will be overridden if the “x-envoy-decorator-operation” header is passed.
tracePercentages .tracing.options.gloo.solo.io.TracePercentages Requests can produce traces by random sampling or when the x-client-trace-id header is provided. TracePercentages defines the limits for random, forced, and overall tracing percentages.
propagate .google.protobuf.BoolValue Optional. Default is true, If set to false, the tracing headers will not propagate to the upstream.

TracePercentages

Requests can produce traces by random sampling or when the x-client-trace-id header is provided. TracePercentages defines the limits for random, forced, and overall tracing percentages.

"clientSamplePercentage": .google.protobuf.FloatValue
"randomSamplePercentage": .google.protobuf.FloatValue
"overallSamplePercentage": .google.protobuf.FloatValue

Field Type Description
clientSamplePercentage .google.protobuf.FloatValue Percentage of requests that should produce traces when the x-client-trace-id header is provided. optional, defaults to 100.0 This should be a value between 0.0 and 100.0, with up to 6 significant digits.
randomSamplePercentage .google.protobuf.FloatValue Percentage of requests that should produce traces by random sampling. optional, defaults to 100.0 This should be a value between 0.0 and 100.0, with up to 6 significant digits.
overallSamplePercentage .google.protobuf.FloatValue Overall percentage of requests that should produce traces. optional, defaults to 100.0 This should be a value between 0.0 and 100.0, with up to 6 significant digits.

TracingTagEnvironmentVariable

Requests can produce traces with custom tags. TracingTagEnvironmentVariable defines an environment variable which gets added as custom tag.

"tag": .google.protobuf.StringValue
"name": .google.protobuf.StringValue
"defaultValue": .google.protobuf.StringValue

Field Type Description
tag .google.protobuf.StringValue Used to populate the tag name.
name .google.protobuf.StringValue Environment variable name to obtain the value to populate the tag value.
defaultValue .google.protobuf.StringValue When the environment variable is not found, the tag value will be populated with this default value if specified, otherwise no tag will be populated.

TracingTagLiteral

Requests can produce traces with custom tags. TracingTagLiteral defines a literal which gets added as custom tag.

"tag": .google.protobuf.StringValue
"value": .google.protobuf.StringValue

Field Type Description
tag .google.protobuf.StringValue Used to populate the tag name.
value .google.protobuf.StringValue Static literal value to populate the tag value.