Skip to content

Add troubleshooting section for GCP for APM Agent .NET #6568

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
stevejgordon merged 3 commits into from
May 24, 2026
+9 −0
Merged

Add troubleshooting section for GCP for APM Agent .NET #6568

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
cdb7d11
Add troubleshooting section for GCP
stevejgordon May 19, 2026
f73b2ba
Lint feedback
stevejgordon May 19, 2026
9486651
Merge branch 'main' into dotnet-troubleshooting-2
stevejgordon May 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions troubleshoot/observability/apm-agent-dotnet/apm-net-agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -286,3 +286,12 @@ Elastic APM .NET Agent (and likely also other agents which correctly handle the

We recommend using `trace_continuation_strategy` set to `restart` or `restart_external`, so that the APM .NET Agent will ignore the incoming traceparent header sampling flag.


## Broken distributed traces on Google Cloud Run [gcp-cloud-run-broken-distributed-traces]

Services deployed on Google Cloud Run might show transactions as root transactions rather than child spans, and the APM UI might show "incomplete trace" warnings even when the upstream caller is correctly instrumented.

Google Cloud Run's infrastructure intercepts every inbound HTTP request before it reaches the application. It creates a span in Google Cloud Trace and overwrites the W3C `traceparent` header with a new value referencing that GCP-internal span. The Elastic APM .NET agent reads this overwritten header, so all transactions started by the Cloud Run service become children of a GCP-internal span that Elastic APM has no visibility into.

This is infrastructure-level behavior with no opt-out mechanism currently available in Cloud Run. It is tracked in [Google's issue tracker](https://issuetracker.google.com/issues/253419736). There is no workaround available for the Elastic APM .NET agent at this time.

Loading