Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Agent Engine: Support traceparent header propagation for distributed tracing

Aperta
  • Qualcosa non va?
#6,341 1 commento 3 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
google-cloud, python
Ambito
api, cloud, observability

Direzione di ricerca

Inizia al confine google-adk/REST API e verifica come vengono gestiti gli header HTTP in ingresso rispetto alla specifica W3C TraceContext. Coordinati con il team Agent Engine e con il report collegato di Google Issue Tracker; il lavoro è completato quando traceparent viene estratto, gli span interni hanno il parent corretto e i webhook e gli endpoint degli strumenti downstream ricevono il contesto.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

api: vertex-ai

Is your feature request related to a problem? Please describe.

When calling Agent Engine from a service instrumented with OpenTelemetry (e.g., Cloud Run), distributed traces break at the Agent Engine boundary. The traceparent header is sent but Agent Engine does not observe or propagate it.

This makes it impossible to correlate the calling service's spans with Agent Engine's internal operations in Cloud Trace. I can't see end-to-end latency, diagnose where time is spent (model vs. tools vs. queue), or correlate Agent Engine errors with the calling request context.

Describe the solution you'd like

Agent Engine should participate in distributed tracing by:

  1. Extracting the incoming traceparent header per the W3C TraceContext spec
  2. Creating internal spans (model invocation, tool execution) as children of the caller's trace
  3. Propagating trace context to any downstream calls (webhooks, tool endpoints)

This would allow full visibility in Cloud Trace: Cloud Run → Agent Engine → model → tools → response as a single correlated trace.

Describe alternatives you've considered

  • Client-side timing: I can measure round-trip time from the caller, but this gives no visibility into Agent Engine internals (model latency vs. tool execution vs. queuing).
  • Log correlation: I could try to correlate logs by timestamp, but this is fragile and doesn't provide the span-level granularity that tracing offers.
  • Custom instrumentation in tools: I can propagate trace context to my own tool endpoints, but this doesn't help with Agent Engine's internal spans or model calls.

None of these provide the observability that proper trace context propagation would enable.

Additional context

  • Environment: Cloud Run (Python) → Agent Engine via google-adk / REST API, with OpenTelemetry exporting to Cloud Trace
  • Also filed on Google Issue Tracker for visibility with the Agent Engine team: https://issuetracker.google.com/u/4/issues/484226257 – cross-posting here for broader community visibility, and gathering thumbs up to encourage prioritization of this feature.

Thumbs up if you want/need this in Agent Engine.

Lingua principale
Python
Stelle
908
Fork
468
Merge medio
2g 4h
PR unite (30g)
25

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di googleapis/python-aiplatform

Tutte le issue di googleapis/python-aiplatform

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.