‫Anthos Service Mesh ו-Traffic Director נקראים עכשיו Cloud Service Mesh. מידע נוסף זמין בסקירה הכללית על Cloud Service Mesh.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

‫Cloud Trace ו-Cloud Service Mesh

<0x0 Google Cloud מידע נוסף זמין במאמר סקירה כללית על Cloud Service Mesh.

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

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

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

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

הפעלת Cloud Trace

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

מנוהל (TD)

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

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

מריצים את הפקודה הבאה כדי להפעיל את 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.

בדוגמה הבאה נקבע קצב דגימה של 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`)

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

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

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

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).

מריצים את הפקודה הבאה כדי להציג את ה-configmap:
```
kubectl get configmap istio-release-channel -n istio-system -o yaml
```

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

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

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

הערה: הגדרת כלי המעקב היא חלק מההגדרה של bootstrap של שרת ה-proxy, ולכן כל פוד צריך להפעיל מחדש ולהוסיף אותו מחדש כדי לקבל את העדכון של כלי המעקב. לדוגמה, אתם יכולים להשתמש בפקודה הבאה כדי להפעיל מחדש 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, צריך לפרוס מחדש את מישור הבקרה בניהול הלקוח באמצעות קובץ השכבה הבא. מידע נוסף על קובצי שכבת-על זמין במאמר מידע על קובצי שכבת-על.

ברירת מחדל

מריצים את הפקודה הבאה כדי להפעיל את 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

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

למרות שפרוקסי מסוג 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.

גישה למעקבים

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

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

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

כניסה לדף Cloud Service Mesh
בקטע Services (שירותים), בוחרים את השם של השירות שרוצים לבדוק.

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

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

הצגת כל המעקבים

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

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

כניסה לדף Cloud Service Mesh
בקטע Services (שירותים), בוחרים את השם של השירות שרוצים לבדוק.
עוברים לדף מדדים.
מציינים טווח זמן בתפריט הנפתח טווח זמן או מגדירים טווח מותאם אישית באמצעות ציר הזמן.
לוחצים על View traces (הצגת נתוני מעקב).

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

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

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

צפייה במעקבים במסוף Google Cloud

‫Cloud Trace ו-Cloud Service Mesh

הפעלת Cloud Trace

מנוהל (TD)

מנוהל (Istiod)

באשכול

ברירת מחדל

בהתאמה אישית

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

דוגמה

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

גישה למעקבים

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

הצגת כל המעקבים

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

מנוהל (`Istiod`)