# gcp_cloudtrace

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

---
title: gcp_cloudtrace
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: connect/components/tracers/gcp_cloudtrace
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/tracers/gcp_cloudtrace.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/tracers/gcp_cloudtrace.adoc
page-git-created-date: "2024-09-09"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/connect/components/tracers/gcp_cloudtrace.md -->

**Available in:** Cloud, [Self-Managed](https://docs.redpanda.com/connect/components/tracers/gcp_cloudtrace/%20%22View%20the%20Self-Managed%20version%20of%20this%20component%22)

Send tracing events to a [Google Cloud Trace](https://cloud.google.com/trace).

#### Common

```yml
tracers:
  gcp_cloudtrace:
    project: "" # No default (required)
    sampling_ratio: 1
    flush_interval: "" # No default (optional)
```

#### Advanced

```yml
tracers:
  gcp_cloudtrace:
    project: "" # No default (required)
    sampling_ratio: 1
    tags: {}
    flush_interval: "" # No default (optional)
```

## [](#fields)Fields

### [](#flush_interval)`flush_interval`

The period of time between each flush of tracing spans.

**Type**: `string`

### [](#project)`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)`sampling_ratio`

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

**Type**: `float`

**Default**: `1`

```yaml
# Examples:
sampling_ratio: 1
```

### [](#tags)`tags`

A map of tags to add to tracing spans.

**Type**: `string`

**Default**: `{}`