Agent Engine: Support traceparent header propagation for distributed tracing
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- google-cloud, python
- Lĩnh vực
- api, cloud, observability
Hướng nghiên cứu
Bắt đầu tại ranh giới google-adk/REST API và xác minh cách các HTTP header gửi đến được xử lý theo đặc tả W3C TraceContext. Phối hợp với nhóm Agent Engine và báo cáo Google Issue Tracker được liên kết; công việc được xem là hoàn tất khi traceparent được trích xuất, các span nội bộ được gán parent chính xác, và các webhook cùng tool endpoint downstream nhận được context.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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:
- Extracting the incoming traceparent header per the W3C TraceContext spec
- Creating internal spans (model invocation, tool execution) as children of the caller's trace
- 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.
- Ngôn ngữ chính
- Python
- Star
- 907
- Fork
- 467
- Merge trung bình
- 1 ngày 13 giờ
- Pull request đã merge (30 ngày)
- 44
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của googleapis/python-aiplatform
-
Protobuf 7.35.1+ support Đang mởapi: vertex-ai
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
googleapis/python-aiplatform#7132 ·
-
api: vertex-ai
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
googleapis/python-aiplatform#7097 · 1 bình luận ·
-
CustomContainerTrainingJob.run drops max_wait_duration=0 instead of requesting indefinite DWS wait Đang mởapi: vertex-ai
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
googleapis/python-aiplatform#7067 · 1 bình luận ·
-
api: vertex-ai
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
googleapis/python-aiplatform#6877 ·
-
api: vertex-ai
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
googleapis/python-aiplatform#6865 · 1 bình luận ·
Tất cả issue của googleapis/python-aiplatform
Issue tương tự
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
use-agent-os/agent-os#3314 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
BasedHardware/omi#15662 · 1 bình luận ·
-
documentation help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 90/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
AiursoftWeb/AnduinOS-2#19 ·