שיטה: v1.traces.post

שולחים נתוני מעקב לפרויקט באמצעות Telemetry (OTLP) API, שמטמיע את פרוטוקול OpenTelemetry OTLP. מידע על ה-API הזה זמין במאמר סקירה כללית על v1.traces.

נקודת קצה של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. יכול להיות שלשירות אחד יהיו כמה נקודות קצה של שירות. השירות הזה תומך בנקודת קצה גלובלית.

בקשת HTTP

POST https://telemetry.googleapis.com/v1/traces

גוף הבקשה

גוף הבקשה מכיל מופע של ExportTraceServiceRequest. מידע על המבנה הזה מופיע במאמרים trace_service.proto וtrace.proto.

אם מוסיפים את attributes אל Span, צריך לפעול לפי ההוראות של OpenTelemetry. מידע נוסף זמין במאמר מושגים נפוצים במפרט: מאפיין.

מידע על שליחת בקשות ועל פרוטוקול OTLP זמין במאמר פרטי הפרוטוקול.

גוף התשובה

גוף התשובה יכיל מופע של ExportTraceServiceResponse. מידע על המבנה הזה זמין במאמר trace_service.proto.

התשובה יכולה לציין הצלחה מלאה, הצלחה חלקית או כשל. מידע נוסף זמין במאמר בנושא תגובת OTLP/gRPC.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/cloud-platform

מידע נוסף זמין במאמר בנושא Authentication Overview.