תוויות מעקב

הכלי Trace מספק מנגנון להוספת נתונים משמעותיים לטווחים. אם אתם משתמשים ב-Cloud Trace API V1, אתם יכולים להוסיף תוויות, שהן צמדי מפתח/ערך, באמצעות השדה labels באובייקט TraceSpan של Cloud Trace API. אם אתם משתמשים ב-Cloud Trace API V2, אתם יכולים להוסיף מידע באמצעות אובייקט Attributes.

כשבוחנים טווח, התוויות של הטווח הזה מוצגות בכרטיסייה מאפיינים. לדוגמה, צילום המסך הבא ממחיש את הכרטיסייה הזו:

דוגמה לטבלת המאפיינים של Cloud Trace.

מידע על גישה לנתונים האלה זמין במאמר בנושא איתור של עקבות וניתוח שלהם.

השדה labels הוא מיפוי של צמדי מפתח/ערך. המפתחות והערכים מאוחסנים כמחרוזות. הגבלות על אורך מחרוזת מפורטות במאמר בנושא הפניית API ל-labels.

אפשר להוסיף עד 32 תוויות לכל טווח.

מפתחות מוגדרים מראש

תוויות קנוניות

בטבלה הבאה מפורטות המקשים המוגדרים מראש שנתמכים, כולל תיאור, ובמקרים מסוימים, כולל דוגמה:

מפתח התוויתתיאור
דוגמה
/agent מזהה סוכן המעקב.
"node@google-cloud/trace-agent v3.0.0"
/component מזהה הרכיב.
"grpc"
/error/message הודעת שגיאה.
"Rendezvous of RPC that terminated with:
status = StatusCode.UNAVAILABLE details = OS Error."
/error/name השם המוצג של השגיאה.
/http/client_city העיר של הלקוח.
"NYC"
/http/client_country המדינה של הלקוח.
"US"
/http/client_protocol מזהה פרוטוקול HTTP.
"1.0"
/http/client_region האזור של הלקוח.
"us-east4"
/http/host הערך של כותרת המארח.
"default.example.com"
/http/method† מוגדר לשיטת בקשת ה-HTTP.
אל תכללו את המפתח הזה בבקשות שאינן בקשות HTTP.
"GET"
/http/path† נתיב כתובת ה-URL של הבקשה.
"/cart/checkout"
/http/redirected_url כתובת ה-URL לפני ההפניה האוטומטית.
במקרה הזה, משתמשים בתווית של כתובת ה-URL של HTTP כדי לאחסן את כתובת ה-URL הסופית.
/http/request/size מספר הבייטים בבקשה.
/http/response/size מספר הבייטים בתשובה.
/http/route† המסלול התואם.
"/cart/checkout/:item_id"
/http/status_code† קוד סטטוס של תגובת HTTP.
"200"
/http/url כתובת ה-URL המלאה של בקשת HTTP.
"http://example.com"
/http/user_agent מידע על סוכן המשתמש של HTTP שממנו נשלחה הבקשה.
"python-requests/2.19.1"
/stacktrace דוח קריסות בפורמט JSON. מעקבי ערימה לא מאונדקסים לחיפוש.
התווית הזו מוצגת בטבלה Call Stack.
התווית /stacktrace משמשת רק ב-V1 API.
ב-V2 API, השדה span מכיל את השדה stackTrace. 
    "stackTrace": {
      "stackFrames": {
        "frame": [
          {
            "functionName": {
              "value": "serverMethodTrace [as func]"
            },
            "fileName": {
              "value":
              "/usr/src/app/node_modules/@google-cloud/trace-agent/build/src/plugins/plugin-grpc.js"
            },
            "lineNumber": "249",
            "columnNumber": "28"
          },
          {
            "functionName": {
              "value": "anonymous function"
            },
            "fileName": {
              "value": "/usr/src/app/node_modules/grpc/src/server.js"
            },
            "lineNumber": "592",
            "columnNumber": "13"
          }
        ]
      }
    },

†התווית הזו והערך שלה מוצגים בטבלת פרטים שכלולה בתצוגה פרטי מעקב.

תוויות קנוניות ל-GKE

בטבלה הבאה מפורטות כל התוויות הקנוניות של קונטיינר GKE:

שם התצוגה בטבלה GKE Container
מפתח התווית		 תיאור
מזהה פרויקט
g.co/r/k8s_container/project_id