‫Cloud Trace ו-Cloud Service Mesh

הערה: המדריך הזה תומך רק ב-Cloud Service Mesh עם ממשקי API של Istio, ולא תומך בממשקי API של Google Cloud . מידע נוסף זמין במאמר סקירה כללית על Cloud Service Mesh.

‫Cloud Trace היא מערכת מעקב מבוזרת שאוספת נתוני זמן אחזור מהאפליקציות ומציגה אותם כמעט בזמן אמת. הוא מאפשר לעקוב אחרי בקשה לדוגמה במערכת המבוזרת, לצפות בקריאות לרשת ולנתח את המערכת מקצה לקצה.

אפשר להשתמש ב-Cloud Trace עם התקנות של Cloud Service Mesh בפלטפורמות הבאות:

• ‫GKE ב- Google Cloud
• אשכולות GKE Enterprise מקומיים אם התקנתם באמצעות רשות אישורים של Cloud Service Mesh

שימו לב ש-Cloud Trace מושבת כברירת מחדל. אחרי שמפעילים את Cloud Trace, בדפים של Cloud Service Mesh במסוף Google Cloud מופיע קישור למעקבים בדף Cloud Trace . למידע מפורט על מחירים, קראו את דף התמחור של Cloud Trace.

הפעלת Cloud Trace

בקטע הזה מוסבר איך להפעיל את Cloud Trace.

מנוהל (TD)

הערה: בערוצים המהירים והרגילים, Cloud Service Mesh עם מישור בקרה מנוהל של Traffic Director תומך בכמה הגדרות של telemetry API. ממשקי API של טלמטריה נתמכים במרחב השמות הבסיסי (ברירת מחדל: istio-system, או כפי שמצוין ב-meshconfig), ברמת מרחב השמות ובבורר ספציפי. העדיפות הכי גבוהה היא לסלקטור והכי נמוכה לרמת הבסיס. בערוצים אחרים, יש תמיכה רק בהגדרת API אחת לטלמטריה ברמת האשכול, ובאופן ספציפי, ב-CR אחד של Istio telemetry API במרחב השמות ברמה הבסיסית (root).

אם כבר יש לכם משאב מותאם אישית של Istio telemetry API, צריך לכלול אותו במשאב המותאם אישית החדש של Istio telemetry API כדי לשמור על הגדרות ההתאמה האישית הקודמות במשאב המותאם אישית הקיים של Istio telemetry.

בקטע הזה מוסבר איך להפעיל את Cloud Trace ב-Cloud Service Mesh עם מישור בקרה מנוהל של Traffic Director.

1. מריצים את הפקודה הבאה כדי להפעיל את Cloud Trace:

   cat <<EOF | kubectl apply -n istio-system -f -
   apiVersion: telemetry.istio.io/v1alpha1
   kind: Telemetry
   metadata:
      name: enable-cloud-trace
      namespace: istio-system
   spec:
      tracing:
      - providers:
        - name: stackdriver
   EOF
   

   כברירת מחדל, תדירות הדגימה היא 1%. כדי לשנות את ברירת המחדל, אפשר לציין את randomSamplingPercentage ולהגדיר ערך בין 0.0 ל-100.0.

   הערה: בהטמעות של TRAFFIC_DIRECTOR, אפשר לשנות את randomSamplingPercentage רק בערוצי ההפצה מהיר ורגיל.

   בדוגמה הבאה מוגדרת תדירות דגימה של 100% (בדרך כלל עושים את זה רק למטרות הדגמה או פתרון בעיות):

   cat <<EOF | kubectl apply -n istio-system -f -
   apiVersion: telemetry.istio.io/v1alpha1
   kind: Telemetry
   metadata:
      name: enable-cloud-trace
      namespace: istio-system
   spec:
      tracing:
      - providers:
        - name: stackdriver
        randomSamplingPercentage: 100.0
   EOF
   

מנוהל (Istiod)

חשוב לדעת: השימוש ב-Managed Cloud Service Mesh באמצעות הטמעה של מישור הבקרה ISTIOD יצא משימוש. צריך לשדרג את כל הציים המנוהלים של ISTIOD להטמעה של מישור הבקרה של TRAFFIC_DIRECTOR.

בקטע הזה נסביר איך להפעיל את Cloud Trace ב-Cloud Service Mesh עם מישור בקרה מנוהל של Istiod.

אזהרה: אתם יכולים לדרוס את השינויים שלכם. אם כבר יש לכם configmap, אתם צריכים לכלול את כל הגדרות ההתאמה האישית הקודמות בקטע mesh: כדי לשמור את השינויים.

1. מריצים את הפקודה הבאה:

   cat <<EOF | kubectl apply -f -
   apiVersion: v1
   data:
      mesh: |-
         defaultConfig:
           tracing:
             stackdriver: {}
   kind: ConfigMap
   metadata:
      name: istio-release-channel
      namespace: istio-system
   EOF
   

   כאשר release-channel הוא ערוץ ההפצה (asm-managed,‏ asm-managed-stable או asm-managed-rapid).

2. מריצים את הפקודה הבאה כדי להציג את ה-configmap:

   kubectl get configmap istio-release-channel -n istio-system -o yaml
   

3. כדי לוודא ש-Cloud Trace מופעל, צריך לוודא שהשורות הבאות מופיעות בקטע mesh:.

   ...
   apiVersion: v1
   data:
      mesh: |
      ....
      defaultConfig:
         tracing:
            stackdriver:{}
   ...
   

4. מפעילים מחדש את שרתי ה-proxy.

   שימו לב שהגדרת המעקב היא חלק מהגדרת ה-bootstrap של שרת ה-proxy, ולכן צריך להפעיל מחדש כל pod ולהזריק אותו מחדש כדי לקבל את עדכון המעקב. לדוגמה, אפשר להשתמש בפקודה הבאה כדי להפעיל מחדש pod-ים ששייכים לפריסה:

   kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

באשכול

חשוב לדעת: השימוש ב-Cloud Service Mesh באשכול באמצעות מישור הבקרה של ISTIOD ב-GKE ב- Google Cloud הוצא משימוש. אנחנו ממשיכים לתמוך ב-Cloud Service Mesh עם מישור בקרה בתוך האשכול ב-Google Distributed Cloud (תוכנה בלבד), כמו שמתואר במאמר פלטפורמות נתמכות.

בקטע הזה מוסבר איך להפעיל את Cloud Trace ב-Cloud Service Mesh עם מישור בקרה בתוך האשכול.

כדי להפעיל את Cloud Trace, פורסים מחדש את מישור הבקרה בניהול הלקוח באמצעות קובץ שכבת-העל הבא. מידע נוסף על קובצי שכבת-על זמין במאמר בנושא קובצי שכבת-על.

זהירות: שימוש ב-asmcli install מחליף את ההגדרות הקיימות של מישור הבקרה. כשמפעילים תכונות אופציונליות בהתקנה קיימת, חשוב לציין את כל הקבצים שרוצים לשמור בהגדרה המקורית, וגם את קובצי השכבות של התכונות שרוצים להפעיל. מומלץ לשמור את קובצי שכבת-העל שמשמשים להתקנה בניהול מקורות, כדי שתוכלו להחיל את אותן הגדרות על מישור הבקרה כשאתם משדרגים או מפעילים תכונות אופציונליות נוספות.

ברירת מחדל

מריצים את הפקודה הבאה כדי להפעיל את Cloud Trace:

 ./asmcli install \
    OTHER_FLAGS \
    --option cloud-tracing

הפקודה הזו מחילה את קובץ שכבת-העל הבא כדי להפעיל מעקב עם אפשרויות ברירת המחדל. שימו לב: תדירות הדגימה שמוגדרת כברירת מחדל היא 1%. כדי לשנות את ברירת המחדל, צריך להשתמש ב---custom-overlay.

 apiVersion: install.istio.io/v1alpha1
 kind: IstioOperator
 spec:
   meshConfig:
     enableTracing: true
   values:
     global:
       proxy:
         tracer: stackdriver

רשימת האפשרויות מופיעה בחבילה anthos-service-mesh.

בהתאמה אישית

אפשר לשנות את ברירת המחדל על ידי ציון ערך של tracing.sampling. הערך צריך להיות בטווח 0.0 עד 100.0, עם דיוק של 0.01. לדוגמה, כדי לעקוב אחרי 5 בקשות מתוך כל 10,000, משתמשים ב-0.05.

בדוגמה הבאה מוצג קצב דגימה של 100% (שמשתמשים בו רק למטרות הדגמה או פתרון בעיות).

 apiVersion: install.istio.io/v1alpha1
 kind: IstioOperator
 spec:
   meshConfig:
     enableTracing: true
     defaultConfig:
        tracing:
        sampling: 100
   values:
     global:
       proxy:
         tracer: stackdriver

מריצים את הפקודה הבאה כדי להפעיל את Cloud Trace:

 ./asmcli install \
    OTHER_FLAGS \
    --custom_overlay PATH_TO_FILE

שימו לב שהגדרת המעקב היא חלק מהגדרת ה-bootstrap של שרת ה-proxy, ולכן צריך להפעיל מחדש את ה-pods ולהזריק אותם מחדש כדי לקבל את עדכון המעקב. כדי להפעיל מחדש פודים ששייכים לפריסה, משתמשים בפקודה הבאה:

kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

הפצה של הקשר יומן מעקב

למרות ששרתי ה-proxy של ה-sidecar יכולים לשלוח באופן אוטומטי את טווחי המעקב, הם צריכים כמה רמזים כדי לקשור יחד את כל המעקב. האפליקציות צריכות להפיץ את כותרות ה-HTTP המתאימות, כדי שכאשר שרתי ה-proxy ישלחו מידע על span, יהיה אפשר לקשר את ה-spans בצורה נכונה למעקב יחיד.

כדי לעשות את זה, האפליקציה צריכה לאסוף ולהפיץ את הכותרות המתאימות מהבקשה הנכנסת לכל הבקשות היוצאות. הגדרת המעקב של Cloud Service Mesh Stackdriver תקבל כל אחד מהפורמטים הבאים של כותרות, ותפיץ את כל הפורמטים הבאים:

• ‫B3 ‏ (x-b3-traceid, x-b3-spanid, x-b3parentspanid, x-b3-sampled, x-b3-flags)
• ‫W3C TraceContext ‏ (traceparent)
• ‫Google Cloud Trace ‏ (x-cloud-trace-context)
• ‫gRPC TraceBin ‏ (grpc-trace-bin)

כלומר, האפליקציות שלכם יכולות להשתמש בכל אחד מהפורמטים האלה כדי להפיץ את הקשר יומן המעקב, ויומני המעקב ייווצרו ויוגדרו ל-Stackdriver בהתאם.

דוגמה

הנה דוגמה לבקשת HTTP-Get עם כותרת traceparent בבקשה המקורית. שימו לב לכותרות הנוספות של הקשר יומן המעקב שנוספו על ידי שרת ה-proxy.

$ kubectl exec -it sleep-557747455f-n6flv -- curl "httpbin:8000/anything?freeform=" -H "accept: application/json" -H "Traceparent: 00-7543d15e09e5d61801d4f74cde1269b8-604ef051d35c5b3f-01" -vv
*   Trying 10.12.3.52:8000...
* Connected to httpbin (10.12.3.52) port 8000 (#0)
> GET /anything?freeform= HTTP/1.1
> Host: httpbin:8000
> User-Agent: curl/7.80.0-DEV
> accept: application/json
> Traceparent: 00-7543d15e09e5d61801d4f74cde1269b8-604ef051d35c5b3f-01
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< server: envoy
< date: Wed, 10 Nov 2021 20:36:04 GMT
< content-type: application/json
< content-length: 1032
< access-control-allow-origin: *
< access-control-allow-credentials: true
< x-envoy-upstream-service-time: 5
<
{
  "args": {
    "freeform": ""
  },
  "data": "",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/json",
    "Grpc-Trace-Bin": "AAB1Q9FeCeXWGAHU90zeEmm4AaDHmGRtdM7wAgE",
    "Host": "httpbin:8000",
    "Traceparent": "00-7543d15e09e5d61801d4f74cde1269b8-a0c798646d74cef0-01",
    "User-Agent": "curl/7.80.0-DEV",
    "X-B3-Sampled": "1",
    "X-B3-Spanid": "a0c798646d74cef0",
    "X-B3-Traceid": "7543d15e09e5d61801d4f74cde1269b8",
    "X-Cloud-Trace-Context": "7543d15e09e5d61801d4f74cde1269b8/11585396123534413552;o=1",
    "X-Envoy-Attempt-Count": "1",
    "X-Forwarded-Client-Cert": "<REDACTED>"
  },
  "json": null,
  "method": "GET",
  "origin": "127.0.0.6",
  "url": "http://httpbin:8000/anything?freeform="
}

שימו לב שבקבוצת כותרות הבקשה שמוחזרת, מופיעה הקבוצה המלאה של כותרות הקשר של יומן המעקב.

דוגמאות נוספות להפצת הכותרות מופיעות במאמר בנושא הפצת הקשר של מעקב.

יצירת מעקב מלקוח עם מזהה מותאם אישית

כדי ליצור מעקב מלקוח עם מזהה בהתאמה אישית, משתמשים בפקודה curl כדי ליצור בקשה עם לקוח חיצוני ולאלץ אותה להציג מעקב. לדוגמה:

curl $URL --header "x-client-trace-id: 105445aa7843bc8bf206b12000100000"

מידע נוסף על x-client-trace-id זמין במסמכי התיעוד של Envoy.

הערה: אם אתם בודקים את קונטיינרי ה-sidecar של Cloud Service Mesh ששולחים נתונים של Cloud Trace באמצעות microservices-demo של Google, הקפידו להשבית את הפונקציונליות המובנית של Cloud Trace. הדמו של מיקרו-שירותים יכול לשלוח נתונים של Cloud Trace בלי Istio. אם לא תשביתו את הפונקציונליות הזו, ייווצרו עקבות כפולים כי גם קונטיינר האפליקציה וגם הקונטיינר המשני ישלחו עקבות. יש כמה DISABLE_TRACING משתנים שצריך להגדיר בקובץ השחרור של microservices-demo.

גישה למעקבים

צפייה בדוגמאות של מעקב בשירות

כדי לראות דגימה של נתוני מעקב של שירות באפליקציה:

1. נכנסים אל הדף Cloud Service Mesh במסוף Google Cloud .

   כניסה לדף Cloud Service Mesh

2. בקטע Services, בוחרים את שם השירות שרוצים לבדוק.

   בצילום המסך הבא מוצגת דוגמה ל-frontend Service.

   

3. בקטע בקשות למעקב, לוחצים על בקשה כלשהי כדי לראות מידע נוסף.

   בצילום המסך הבא מוצגת דוגמה לחלונית המשנה של בקשת המעקב.

   

הצגת כל העקבות

כדי לראות את כל העקבות של שירות מסוים:

1. נכנסים אל הדף Cloud Service Mesh במסוף Google Cloud .

   כניסה לדף Cloud Service Mesh

2. בקטע Services, בוחרים את שם השירות שרוצים לבדוק.

3. עוברים לדף Metrics.

4. בוחרים טווח זמן מהתפריט הנפתח Time Span או מגדירים טווח זמן מותאם אישית באמצעות ציר הזמן.

5. לוחצים על View traces (הצגת נתוני מעקב).

הנתונים של מעקב אחר שירות ב-Cloud Service Mesh כוללים את המידע הבא:

• זמני האחזור של בקשות בשירותים שונים ברשת.
• מאפיינים של בקשת HTTP, כולל מזהה, כתובת URL, גודל, זמן אחזור ופרוטוקול.
• שם השירות, מרחב השמות ומזהה הרשת כחלק מהתוויות istio.canonical_service, istio.namespace ו-istio.mesh_id, בהתאמה.

המאמרים הבאים

• הצגת עקבות במסוף Google Cloud