Prerequisites
1
Healthy connector
A Cloud Connector with discovery enabled for the workload types you want.
2
OTLP destination
At least one OTLP destination on that connector. See Add an OTLP destination. Workload instrumentation is destination-gated; without a usable OTLP endpoint the connector will not attach instrumentation.
3
Reachable endpoint
Instrumented workloads export OTLP to that destination from the cloud environment (for example from Lambda or Cloud Run). Point the destination at an endpoint those workloads can reach — for example a collector or backend with appropriate public or VPC access. See Telemetry export.
Add an OTLP destination
Before you create Sources, add at least one destination on the connector so instrumented workloads have somewhere to export telemetry. Lambda and Cloud Run support OTLP destinations only. For more information, see Telemetry export. Follow the Destinations overview for how to add and configure a destination, then apply that setup on the connector in Central. The endpoint must be reachable from the cloud workloads themselves (not only from the Central cluster).Browse discovered workloads
Open the connector in Central and review discovered workloads. Each candidate typically includes kind, name, region/location, and whether it is already a Source or instrumented.Create Sources
Select the workloads to instrument and create Sources. A Source is the instrumentation intent for one cloud resource. Identity includes:- Name: the provider resource name
- Kind: for example
aws.lambdaorgcp.cloud-run - Region: the resource’s region or location
Check Source status
After you create a Source, it appears under Sources in Central. Open it to see details and health. The Source details typically include:- Identity: kind (e.g. AWS Lambda), name, region, and service name, plus whether the Source is Enabled
- Health: a status banner such as Success And Emitting Telemetry when the Source is instrumented, healthy, and telemetry has been observed
- Instrumentation: detected language and version (e.g.
python • 3.13), and whether the workload is Instrumented
Uninstrument workloads
To remove instrumentation from one or more Sources, select them with the checkboxes and click Uninstrument. The connector removes the Odigos OTEL SDK, collector components, and related configuration it applied earlier, so the workloads stop exporting telemetry through that Source.Troubleshooting
No instrumentation applied
No instrumentation applied
Confirm an OTLP destination exists on the connector and the Source is enabled. See Destinations overview for how to add and configure destinations.
GCP: permission denied on update
GCP: permission denied on update
Grant
iam.serviceAccounts.actAs (or roles/iam.serviceAccountUser on the runtime service account). See Add GCP connector.GCP: traces missing intermittently
GCP: traces missing intermittently
Cloud Run CPU throttling or scale-to-zero can delay or drop background OTLP export. Prefer a reachable destination and, if needed, keep CPU allocated or a minimum instance warm on low-traffic services.
AWS: test connection passed but instrumentation fails
AWS: test connection passed but instrumentation fails
Test connection validates discovery permissions. Grant the Lambda instrumentation IAM actions listed on the Add AWS page.
Next steps
Manage and remove
Understand connector health and how deletion policies affect cloud instrumentation.