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

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

בקשה של יומני שרת proxy

‫Cloud Service Mesh תומך בשני סוגים שונים של יומני גישה ב-Cloud Logging: יומני תנועה (שנקראים גם יומני גישה של Google Cloud Observability) ויומני גישה של Envoy. בדף הזה מוסבר איך להפעיל, להשבית, להציג ולפרש את היומנים האלה. שימו לב: יומני התנועה מופעלים כברירת מחדל.

הפעלה והשבתה של יומני גישה

‫Traffic Director מנוהל

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

יומני גישה של Envoy

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

cat <<EOF | kubectl apply -n istio-system -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: enable-envoy-disable-sd
  namespace: istio-system
spec:
  accessLogging:
  - providers:
      - name: envoy
  - providers:
      - name: stackdriver
    disabled: true
EOF

שימו לב ששם הספק של יומן התנועה הוא stackdriver.

יומני תעבורת נתונים

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

cat <<EOF | kubectl apply -n istio-system -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: disable-envoy-enable-sd
  namespace: istio-system
spec:
  accessLogging:
  - providers:
      - name: envoy
    disabled: true
  - providers:
      - name: stackdriver
EOF

שני הסוגים

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

cat <<EOF | kubectl apply -n istio-system -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: enable-envoy-and-sd-access-log
  namespace: istio-system
spec:
  accessLogging:
  - providers:
      - name: envoy
      - name: stackdriver
EOF

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

cat <<EOF | kubectl apply -n istio-system -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: disable-envoy-and-sd
  namespace: istio-system
spec:
  accessLogging:
  - providers:
      - name: envoy
    disabled: true
  - providers:
      - name: stackdriver
    disabled: true
EOF

יומני גישה ספציפיים לבורר

בערוץ המהיר, כדי להפעיל את הרישום ביומן הגישה רק עבור עומס עבודה ספציפי, צריך קודם להשבית אותו ברמה של כל הרשת על ידי החלת הגדרת טלמטריה במרחב השמות הבסיסי (כי רישום תנועת הנתונים מופעל כברירת מחדל). לאחר מכן, מחילים הגדרה נפרדת עם בורר כדי להפעיל אותה רק עבור עומס העבודה הזה.

# 1. Disable mesh-wide access logging
cat <<EOF | kubectl apply -n istio-system -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: disable-mesh-wide-telemetry
  namespace: istio-system
spec:
  accessLogging:
  - providers:
    - name: stackdriver
    disabled: true
EOF

# 2. Enable access logging for a specific workload
cat <<EOF | kubectl apply -n NAMESPACE -f -
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
  name: workload-specific-telemetry
  namespace: NAMESPACE
spec:
  selector:
    matchLabels:
      app: YOUR_APP_LABEL
  accessLogging:
  - providers:
    - name: stackdriver
EOF

מנוהל `istiod`

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

יומני גישה של Envoy

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

מריצים את הפקודה הבאה כדי להוסיף את accessLogFile: /dev/stdout:

cat <<EOF | kubectl apply -f -
apiVersion: v1
data:
  mesh: |-
    accessLogFile: /dev/stdout
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
```
כדי לוודא שרישום הגישה מופעל, מוודאים שהשורה accessLogFile: /dev/stdout מופיעה בקטע mesh:.
```
...
apiVersion: v1
data:
  mesh: |
    ....
    accessLogFile: /dev/stdout
...
```

יומני תעבורת נתונים

יומני התנועה מופעלים כברירת מחדל.

בתוך האשכול

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

יומני גישה של Envoy

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    accessLogFile: "/dev/stdout"

מידע נוסף זמין במאמר הפעלת יומני גישה של Envoy.

יומני תעבורת נתונים

יומני התנועה מופעלים כברירת מחדל, אלא אם Cloud Service Mesh מותקן ב-Google Distributed Cloud עם Istio CA (שנקרא בעבר Citadel).

כדי להפעיל יומני תנועה ב-Google Distributed Cloud עם Istio CA כשמתקינים את Cloud Service Mesh בתוך האשכול, משתמשים בדגל --option stackdriver. אפשר גם להפעיל יומני תנועה ב-Google Distributed Cloud באמצעות Istio CA אחרי התקנה של Cloud Service Mesh בתוך האשכול.

התאמה אישית של הפורמט והקידוד של יומן הגישה ב-Envoy

אתם יכולים להתאים אישית את התוכן והמבנה של יומני הגישה של Envoy שמועברים לפלט רגיל (/dev/stdout). כך תוכלו לכלול שדות ספציפיים לביקורת או לתאימות (כמו חבילות הצפנה של TLS) ולבחור בין טקסט פשוט או פלט JSON מובנה.

מגבלות

האפשרות להגדיר את פורמט הרישום ביומן הגישה זמינה רק בערוץ ההפצה Rapid.

שדות הגדרה

מגדירים את השדות הבאים ב-MeshConfig:

‫accessLogEncoding: מציינים את מבנה היומנים, TEXT או JSON. ברירת המחדל היא TEXT.
‫accessLogFormat: מחרוזת פורמט של יומן הגישה של Envoy או הגדרת JSON (אופציונלי אם נבחרה האפשרות TEXT).

שימוש בתצורה

אופן ההחלה של ההגדרות האלה תלוי במישור הבקרה:

‫Traffic Director מנוהל

מעדכנים את istio-asm-managed-rapid ConfigMap במרחב השמות istio-system (גם אם משתמשים בערוץ אחר ולא בערוץ המהיר). מוסיפים את accessLogEncoding ואת accessLogFormat בשדה mesh.

cat <<EOF | kubectl apply -f -
apiVersion: v1
data:
  mesh: |-
    accessLogFile: /dev/stdout
    accessLogEncoding: JSON
    accessLogFormat: '{"time": "%START_TIME%","code": "%RESPONSE_CODE%","upstream_cluster": "%UPSTREAM_CLUSTER%"}'
kind: ConfigMap
metadata:
  name: istio-asm-managed-rapid
  namespace: istio-system
EOF

צפייה ביומני הגישה

יומני גישה של Envoy

שורת הפקודה

כדי לראות את יומני הגישה של Envoy ביומן של istio-proxy, מריצים את הפקודה הבאה:

kubectl logs POD_NAME -n NAMESPACE_NAME -c istio-proxy

Logs Explorer

כדי לראות את יומני הגישה של Envoy ב-Logs Explorer:

עוברים אל Logs Explorer:

כניסה לדף Logs Explorer
בוחרים את הפרויקט המתאים Google Cloud .
מריצים את השאילתה הבאה:

resource.type="k8s_container" \
resource.labels.container_name="istio-proxy"
resource.labels.cluster_name="CLUSTER_NAME" \
resource.labels.namespace_name="NAMESPACE_NAME" \
resource.labels.pod_name="POD_NAME"

יומני תעבורת נתונים

כדי לראות את יומני התעבורה ב-Logs Explorer:

עוברים אל Logs Explorer:

כניסה לדף Logs Explorer
בוחרים את הפרויקט המתאים Google Cloud .

מריצים את השאילתה הבאה בהתאם לסוג יומני הגישה שאתם צופים בהם: יומני גישה של לקוח או של שרת:

יומני שרת

resource.labels.cluster_name="CLUSTER_NAME" logName="projects/PROJECT_NAME/logs/server-accesslog-stackdriver"

יומני לקוח

resource.labels.cluster_name="CLUSTER_NAME" logName="projects/PROJECT_NAME/logs/client-accesslog-stackdriver"

כדי לראות את יומני התנועה בדף Cloud Service Mesh של שירות מסוים במהלך פרק זמן מוגדר, פועלים לפי השלבים הבאים:

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

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

יומן התעבורה נקרא server-accesslog-stackdriver והוא מצורף למשאב במעקב המתאים (k8s_container או gce_instance) שבו השירות שלכם משתמש. יומן התנועה מכיל את הפרטים הבאים:

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

דוגמה לרשומה ביומן:

{
  insertId: "1awb4hug5pos2qi"
  httpRequest: {
    requestMethod: "GET"
    requestUrl: "YOUR-INGRESS/productpage"
    requestSize: "952"
    status: 200
    responseSize: "5875"
    remoteIp: "10.8.0.44:0"
    serverIp: "10.56.4.25:9080"
    latency: "1.587232023s"
    protocol: "http"
  }
  resource: {
    type: "k8s_container"
    labels: {
      location: "us-central1-a"
      project_id: "YOUR-PROJECT"
      pod_name: "productpage-v1-76589d9fdc-ptnt9"
      cluster_name: "YOUR-CLUSTER-NAME"
      container_name: "productpage"
      namespace_name: "default"
    }
  }
  timestamp: "2020-04-28T19:55:21.056759Z"
  severity: "INFO"
  labels: {
    destination_principal: "spiffe://cluster.local/ns/default/sa/bookinfo-productpage"
    response_flag: "-"
    destination_service_host: "productpage.default.svc.cluster.local"
    source_app: "istio-ingressgateway"
    service_authentication_policy: "MUTUAL_TLS"
    source_name: "istio-ingressgateway-5ff85d8dd8-mwplb"
    mesh_uid: "YOUR-MESH-UID"
    request_id: "021ce752-9001-4ac6-b6d6-3b15f5d3632"
    destination_namespace: "default"
    source_principal:  "spiffe://cluster.local/ns/istio-system/sa/istio-ingressgateway-service-account"
    destination_workload: "productpage-v1"
    destination_version: "v1"
    source_namespace: "istio-system"
    source_workload: "istio-ingressgateway"
    destination_name: "productpage-v1-76589d9fdc-ptnt9"
    destination_app: "productpage"
  }
  trace: "projects/YOUR-PROJECT/traces/d4197f59b7a43e3aeff3571bac99d536"
  receiveTimestamp: "2020-04-29T03:07:14.362416217Z"
  spanId: "43226343ca2bb2b1"
  traceSampled: true
  logName: "projects/YOUR-PROJECT/logs/server-accesslog-stackdriver"
  receiveTimestamp: "2020-04-28T19:55:32.185229100Z"
}

הסבר על נתוני הטלמטריה של Cloud Service Mesh

בקטעים הבאים מוסבר איך לבדוק את הסטטוס של הרשת ולעיין בנתוני הטלמטריה השונים שמכילים פרטים שימושיים שיעזרו לכם לפתור בעיות.

פרשנות של מדדים במישור הבקרה

‫Traffic Director מנוהל

‫Cloud Service Mesh עם מישור בקרה מנוהל של Traffic Director לא תומך במדדים של מישור הבקרה.

מנוהל `istiod`

‫Cloud Service Mesh עם מישור בקרה מנוהל istiod לא תומך בבדיקת מדדים של מישור הבקרה שמתוארת בקטע הזה.

בתוך האשכול

כשמתקינים את Cloud Service Mesh עם מישור הבקרה בתוך האשכול, istiod מדדים מיוצאים אל Google Cloud Observability לצורך מעקב, כברירת מחדל. המדדים האלה מתחילים בקידומת istiodistio.io/control ומספקים תובנות לגבי מצב מישור הבקרה, כמו מספר השרתים הפרוקסי שמחוברים לכל מופע של מישור הבקרה, אירועי הגדרה, פעולות push ואימותים.

כדי לבדוק את מישור הבקרה או לפתור בו בעיות, פועלים לפי השלבים הבאים.

טעינה של מרכז בקרה לדוגמה:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples && cd monitoring-dashboard-samples/dashboards && git checkout servicemesh

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

gcloud monitoring dashboards create --config-from-file=dashboards/servicemesh/anthos-service-mesh-control-plane-monitoring.json

מחפשים ברשימה את מרכז הבקרה Istio Control Plane Dashboard. מידע נוסף זמין במאמר בנושא צפייה בלוח הבקרה שהותקן.

רשימה מלאה של המדדים הזמינים מופיעה במאמר מדדים מיוצאים.

אבחון של עיכובים בהגדרות

‫Traffic Director מנוהל

ב-Cloud Service Mesh עם מישור בקרה מנוהל של Traffic Director אין תמיכה באבחון של עיכובים בהגדרות.

מנוהל `istiod`

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

בתוך האשכול

בשלבים הבאים מוסבר איך להשתמש במדד pilot_proxy_convergence_time כדי לאבחן עיכוב בין שינוי בהגדרות לבין ההתכנסות של כל השרתים הפרוקסי.

מריצים פקודת shell ב-pod:

kubectl debug --image istio/base --target istio-proxy -it $(kubectl get pod -l app=pilot -o jsonpath='{.items[0].metadata.name}' -n istio-system) -n istio-system -- curl -s

גישה אל localhost:15014 ואל grep עבור convergence במדדים:
```
curl http://localhost:15014/metrics | grep convergence
```

פירוש של יומני תעבורת נתונים

בקטע הבא מוסבר איך להשתמש ביומני התנועה כדי לפתור בעיות בחיבור. יומני התנועה מופעלים כברירת מחדל.

‫Cloud Service Mesh מייצא נתונים ליומני תנועה שיכולים לעזור לכם לנפות באגים בסוגי הבעיות הבאים:

תנועת נתונים וכשלים
ניתוב בקשות מקצה לקצה

יומני תעבורה מופעלים כברירת מחדל בהתקנות של Cloud Service Mesh ב-Google Kubernetes Engine. כדי להפעיל את יומני התנועה, מריצים מחדש את הפקודה asmcli install. משתמשים באותן האפשרויות שבהן השתמשתם בהתקנה המקורית, אבל משמיטים את שכבת העל המותאמת אישית שהשביתה את Stackdriver.

יש שני סוגים של יומני תנועה:

יומני גישה לשרת מספקים תצוגה של בקשות בצד השרת. הם ממוקמים בקטע server-accesslog-stackdriver, ומצורפים למשאב k8s_container שבמעקב. כדי להציג יומני גישה בצד השרת, משתמשים בתחביר כתובת ה-URL הבא:
```
https://console.cloud.google.com/logs/viewer?advancedFilter=logName="projects/PROJECT_ID/logs/server-accesslog-stackdriver"&project=PROJECT_ID
```
יומני גישה של לקוחות מספקים תצוגה של בקשות מצד הלקוח. הם נמצאים בקטע client-accesslog-stackdriver, ומצורפים למשאב במעקב k8s_pod. כדי להציג יומני גישה בצד הלקוח, משתמשים בתחביר כתובת ה-URL הבא:
```
https://console.cloud.google.com/logs/viewer?advancedFilter=logName="projects/PROJECT_ID/logs/client-accesslog-stackdriver"&project=PROJECT_ID
```

יומני הגישה מכילים את המידע הבא:

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

יומני תנועה עשויים להכיל את התוויות הבאות:

route_name
upstream_cluster
X-Envoy-Original-Path

דוגמה לרשומה ביומן:

{
  "insertId": "1j84zg8g68vb62z",
  "httpRequest": {
    "requestMethod": "GET",
    "requestUrl": "http://35.235.89.201:80/productpage",
    "requestSize": "795",
    "status": 200,
    "responseSize": "7005",
    "remoteIp": "10.168.0.26:0",
    "serverIp": "10.36.3.153:9080",
    "latency": "0.229384205s",
    "protocol": "http"
  },
  "resource": {
    "type": "k8s_container",
    "labels": {
      "cluster_name": "istio-e2e22",
      "namespace_name": "istio-bookinfo-1-68819",
      "container_name": "productpage",
      "project_id": "***",
      "location": "us-west2-a",
      "pod_name": "productpage-v1-64794f5db4-8xbtf"
    }
  },
  "timestamp": "2020-08-13T21:37:42.963881Z",
  "severity": "INFO",
  "labels": {
    "protocol": "http",
    "upstream_host": "127.0.0.1:9080",
    "source_canonical_service": "istio-ingressgateway",
    "source_namespace": "istio-system",
    "x-envoy-original-path": "",
    "source_canonical_revision": "latest",
    "connection_id": "32",
    "upstream_cluster": "inbound|9080|http|productpage.istio-bookinfo-1-68819.svc.cluster.local",
    "requested_server_name": "outbound_.9080_._.productpage.istio-bookinfo-1-68819.svc.cluster.local",
    "destination_version": "v1",
    "destination_workload": "productpage-v1",
    "source_workload": "istio-ingressgateway",
    "destination_canonical_revision": "v1",
    "mesh_uid": "cluster.local",
    "source_principal": "spiffe://cluster.local/ns/istio-system/sa/istio-ingressgateway-service-account",
    "x-envoy-original-dst-host": "",
    "service_authentication_policy": "MUTUAL_TLS",
    "destination_principal": "spiffe://cluster.local/ns/istio-bookinfo-1-68819/sa/bookinfo-productpage",
    "response_flag": "-",
    "log_sampled": "false",
    "destination_service_host": "productpage.istio-bookinfo-1-68819.svc.cluster.local",
    "destination_name": "productpage-v1-64794f5db4-8xbtf",
    "destination_canonical_service": "productpage",
    "destination_namespace": "istio-bookinfo-1-68819",
    "source_name": "istio-ingressgateway-6845f6d664-lnfvp",
    "source_app": "istio-ingressgateway",
    "destination_app": "productpage",
    "request_id": "39013650-4e62-9be2-9d25-78682dd27ea4",
    "route_name": "default"
  },
  "logName": "projects/***/logs/server-accesslog-stackdriver",
  "trace": "projects/***t/traces/466d77d15753cb4d7749ba5413b5f70f",
  "receiveTimestamp": "2020-08-13T21:37:48.758673203Z",
  "spanId": "633831cb1fda4fd5",
  "traceSampled": true
}

אפשר להשתמש ביומן הזה בדרכים שונות:

שילוב עם Cloud Trace, שהיא תכונה אופציונלית ב-Cloud Service Mesh.
ייצוא יומני תנועה ל-BigQuery, שבו אפשר להריץ שאילתות כמו בחירת כל הבקשות שנמשכות יותר מ-5 שניות.
יצירת מדדים מבוססי-יומן.
פתרון בעיות שקשורות לשגיאות 404 ו-503

פתרון בעיות שקשורות לשגיאות `404` ו-`503`

בדוגמה הבאה מוסבר איך להשתמש ביומן הזה כדי לפתור בעיות כשבקשה נכשלת עם קוד תגובה 404 או 503.

ביומן הגישה של הלקוח, מחפשים רשומה כמו הבאה:

httpRequest: {
requestMethod: "GET"
requestUrl: "://IP_ADDRESS/src/Util/PHP/eval-stdin.php"
requestSize: "2088"
status: 404
responseSize: "75"
remoteIp: "10.168.0.26:34165"
serverIp: "10.36.3.149:8080"
latency: "0.000371440s"
protocol: "http"
}

עוברים לתוויות ברשומה ביומן הגישה. מחפשים את השדה response_flag שדומה לזה:
```
response_flag: "NR"
```
הערך NR הוא ראשי תיבות של NoRoute, כלומר לא נמצא מסלול ליעד או שלא נמצאה שרשרת מסננים תואמת לחיבור במורד הזרם. באופן דומה, אפשר להשתמש בתווית response_flag כדי לפתור שגיאות 503.
אם מופיעות שגיאות 503 ביומני הגישה של הלקוח ושל השרת, צריך לוודא ששמות היציאות שהוגדרו לכל שירות תואמים לשם הפרוטוקול שנמצא בשימוש ביניהם. לדוגמה, אם לקוח בינארי של golang מתחבר לשרת golang באמצעות HTTP, אבל היציאה נקראת http2, הפרוטוקול לא ינהל משא ומתן אוטומטי בצורה נכונה.

מידע נוסף זמין במאמר בנושא דגלים של תגובות.

פירוש של יומני גישה של Envoy

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

יומני הגישה של Envoy שימושיים לאבחון בעיות כמו:

תנועת נתונים וכשלים
ניתוב בקשות מקצה לקצה

יומני הגישה של Envoy לא מופעלים כברירת מחדל ב-Cloud Service Mesh, אבל אפשר להפעיל אותם עבור האשכולות ברשת.

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

אם בקשה מופעלת ומופיעה ביומני ה-proxy של המקור, זה מצביע על כך שהפניית התנועה iptablesפועלת בצורה תקינה ושה-proxy של Envoy מטפל בתנועה. אם מופיעות שגיאות ביומנים, צריך ליצור קובץ dump של הגדרות Envoy ולבדוק את הגדרות האשכול של Envoy כדי לוודא שהן נכונות. אם הבקשה מופיעה אבל אין שגיאות ביומן, צריך לבדוק את יומני ה-proxy של היעד.

אם הבקשה מופיעה ביומני ה-proxy של היעד, זה מצביע על כך שהרשת עצמה פועלת בצורה תקינה. אם מופיעה שגיאה, מריצים dump של הגדרות Envoy ומוודאים שהערכים של יציאת התנועה שהוגדרה בהגדרות של listener נכונים.

אם הבעיה נמשכת אחרי שמבצעים את השלבים הקודמים, יכול להיות ש-Envoy לא מצליח לנהל משא ומתן אוטומטי על הפרוטוקול בין ה-sidecar לבין ה-pod של האפליקציה. מוודאים ששם יציאת השירות של Kubernetes, למשל http-80, זהה לפרוטוקול שבו האפליקציה משתמשת.

שימוש ב-Logs Explorer לשליחת שאילתות ליומנים

אפשר להשתמש בממשק של Logs Explorer כדי לשלוח שאילתות ליומני גישה ספציפיים של Envoy. לדוגמה, כדי לשלוח שאילתה לגבי כל הבקשות שבהן מופעל MULTUAL_TLS ונעשה שימוש בפרוטוקול grpc, מוסיפים את השורה הבאה לשאילתה של יומני הגישה לשרת:

labels.protocol="grpc" labels.service_authentication_policy="MULTUAL_TLS"

הגדרת מדיניות של יומן גישה

‫Traffic Director מנוהל

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

מנוהל `istiod`

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

בתוך האשכול

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

יוצרים IstioOperator קובץ שכבת-על בהתאמה אישית שכולל את הערכים הרלוונטיים של AccessLogPolicyConfig לתרחיש שלכם.
מעבירים את הקובץ הזה אל asmcli באמצעות האפשרות --custom_overlay כדי לעדכן את התצורה של מישור הבקרה באשכול. מידע על הפעלת asmcli install עם קובץ שכבת-על מותאם אישית זמין במאמר התקנה עם תכונות אופציונליות.

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

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

אם יש לכם בעיה בשירות או בעומס עבודה ספציפיים ולא בעיה שמשפיעה על כל הרשת, כדאי לבדוק את שרתי ה-proxy של Envoy ולאסוף מהם מידע רלוונטי. כדי לאסוף מידע על עומס עבודה מסוים ועל שרתי ה-proxy שלו, אפשר להשתמש ב-pilot-agent:

kubectl exec POD_NAME -n NAMESPACE_NAME -c istio-proxy -- pilot-agent request GET SCOPE

בדוגמה, SCOPE הוא אחד מהבאים:

‫certs – אישורים במופע Envoy
‫clusters - אשכולות עם Envoy מוגדר
‫config_dump – יצירת עותק של הגדרות Envoy
‫listeners - Listeners with Envoy configured
logging – צפייה בהגדרות הרישום ביומן ושינוי שלהן
‫stats – נתונים סטטיסטיים של Envoy
‫stats/prometheus – נתונים סטטיסטיים של Envoy כרשומות Prometheus

הצגת מצבי שקע פרוקסי

אפשר לבדוק ישירות את מצב השקעים של Envoy proxy באמצעות התהליך הבא.

הצגת רשימה של שקעים מבוססים, כולל שקעים במצב TIME_WAIT state, שיכולה להשפיע באופן שלילי על יכולת ההתאמה אם המספר שלהם גבוה:
```
kubectl debug --image istio/base --target istio-proxy -it POD_NAME -n NAMESPACE_NAME -- ss -anopim
```

הצגת סיכום של נתוני שקע:

kubectl debug --image istio/base --target istio-proxy -it POD_NAME -n NAMESPACE_NAME -- ss -s

מידע נוסף זמין במאמר מבוא לפקודה ss.

יומנים של `istio-proxy` ו-`istio-init`

בנוסף, כדאי לאחזר את יומני istio-proxy ולבדוק את התוכן שלהם כדי לראות אם יש שגיאות שיכולות להצביע על הגורם לבעיה:

kubectl logs POD_NAME -n NAMESPACE_NAME -c istio-proxy

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

kubectl logs POD_NAME -n NAMESPACE_NAME -c istio-init

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

שילוב עם Cloud Trace. ‫Cloud Trace היא תכונה אופציונלית ב-Cloud Service Mesh.
ייצוא יומני תנועה ל-BigQuery.
יצירת מדדים מבוססי-יומן.

בקשה של יומני שרת proxy

הפעלה והשבתה של יומני גישה

‫Traffic Director מנוהל

יומני גישה של Envoy

יומני תעבורת נתונים

שני הסוגים

יומני גישה ספציפיים לבורר

מנוהל istiod

יומני גישה של Envoy

יומני תעבורת נתונים

בתוך האשכול

יומני גישה של Envoy

יומני תעבורת נתונים

התאמה אישית של הפורמט והקידוד של יומן הגישה ב-Envoy

מגבלות

שדות הגדרה

שימוש בתצורה

‫Traffic Director מנוהל

צפייה ביומני הגישה

יומני גישה של Envoy

שורת הפקודה

Logs Explorer

יומני תעבורת נתונים

יומני שרת

יומני לקוח

הסבר על נתוני הטלמטריה של Cloud Service Mesh

פרשנות של מדדים במישור הבקרה

‫Traffic Director מנוהל

מנוהל istiod

בתוך האשכול

אבחון של עיכובים בהגדרות

‫Traffic Director מנוהל

מנוהל istiod

בתוך האשכול

פירוש של יומני תעבורת נתונים

פתרון בעיות שקשורות לשגיאות 404 ו-503

פירוש של יומני גישה של Envoy

שימוש ב-Logs Explorer לשליחת שאילתות ליומנים

הגדרת מדיניות של יומן גישה

‫Traffic Director מנוהל

מנוהל istiod

בתוך האשכול

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

הצגת מצבי שקע פרוקסי

יומנים של istio-proxy ו-istio-init

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

מנוהל `istiod`

מנוהל `istiod`

מנוהל `istiod`

פתרון בעיות שקשורות לשגיאות `404` ו-`503`

מנוהל `istiod`

יומנים של `istio-proxy` ו-`istio-init`