Skip to main content

gcp_cloudtrace

EXPERIMENTAL

This component is experimental and therefore subject to change or removal outside of major version releases.

Send tracing events to a Google Cloud Trace.

# Common config fields, showing default values
tracer:
  gcp_cloudtrace:
    project: "" # No default (required)
    sampling_ratio: 1
    flush_interval: "" # No default (optional)

Fields​

project​

The google project with Cloud Trace API enabled. If this is omitted then the Google Cloud SDK will attempt auto-detect it from the environment.

Type: string

sampling_ratio​

Sets the ratio of traces to sample. Tuning the sampling ratio is recommended for high-volume production workloads.

Type: float
Default: 1

# Examples

sampling_ratio: 1

tags​

A map of tags to add to tracing spans.

Type: object
Default: {}

flush_interval​

The period of time between each flush of tracing spans.

Type: string

credentials​

Optional manual configuration of GCP credentials to use. More information can be found in this document.

Type: object
Requires version 1.22.0 or newer

credentials.impersonate_service_account​

The email address of a service account to impersonate. The base credentials (Application Default Credentials) must be granted roles/iam.serviceAccountTokenCreator on this service account, or on the first delegate when impersonate_delegates is set.

Type: string
Default: ""

# Examples

impersonate_service_account: target@my-project.iam.gserviceaccount.com

credentials.impersonate_delegates​

An optional chain of service account email addresses to delegate through when impersonating. Each service account must be granted roles/iam.serviceAccountTokenCreator on the next service account in the chain, with the final one granted on impersonate_service_account.

Type: array
Default: []