המעקב ב-Spanner Omni פועל באופן דומה למעקב ב-Spanner, עם כמה חריגים. במאמר הזה נסביר על החריגים האלה ונפנה אתכם למידע רלוונטי במסמכי התיעוד של Spanner בנושא מעקב. כשאתם קוראים את המאמרים בנושא Spanner, כדאי לחזור לדף הזה כדי לבדוק מה ההבדלים ב-Spanner Omni.
תכונות של Spanner שלא נתמכות
Spanner Omni תומך בכל תכונות המעקב של Spanner, חוץ ממעקב מקצה לקצה.
תיעוד אותות טלמטריה
כדי לקבל תובנות לגבי הביצועים, השימוש ובעיות פוטנציאליות, אתם יכולים לתעד אותות ממסד הנתונים של Spanner Omni.
סקירה כללית על זיהוי אותות
אותות טלמטריה עוזרים לכם להבין את הביצועים של מסד הנתונים.
האותות הבאים זמינים ל-Spanner Omni:
| סוג האות | תיאור |
|---|---|
| מדדים | נתונים מספריים על התקינות או הביצועים של מסד הנתונים. |
| יומנים | רשומות שנוצרו לגבי פעילות המערכת לאורך זמן. |
| עקבות | נתיבי בקשות דרך האפליקציה. |
| טבלאות של נתונים סטטיסטיים | טבלאות מובנות לשליחת שאילתות על מידע במסד הנתונים. |
ב-Spanner Omni אין תמיכה במדדים בצד הלקוח. המדדים בצד הלקוח כוללים זמני אחזור של מדדי GFE, איסוף מדדים בצד הלקוח ואיסוף מדדים בהתאמה אישית בצד הלקוח. מידע נוסף זמין במאמר סקירה כללית על תיעוד אותות במסמכי התיעוד של Spanner.
איסוף נתוני מעקב
מעקבים מייצגים את הנתיב של בקשה דרך האפליקציה. הם מאפשרים לעקוב אחרי תהליך הבקשה ועוזרים לזהות את שורש הבעיה. לדוגמה, המעקב יכול לספק מידע על כל בקשה מלקוח, כמו טווחי זמן עם חותמות זמן של המועד שבו הלקוח שלח וקיבל בקשות RPC. כך אפשר לעקוב אחרי בקשות למסד הנתונים ולנפות בהן באגים.
מידע נוסף זמין במאמר סקירה כללית על איסוף נתוני מעקב במסמכי התיעוד של Spanner.
הגדרת איסוף מעקבים באמצעות OpenTelemetry
אתם יכולים להגדיר את ספריות הלקוח של Spanner כך שייצאו את המעקבים באמצעות ממשקי ה-API של OpenTelemetry. התהליך הזה כולל הגדרה של OpenTelemetry SDK ושימוש בייצוא כדי לשלוח נתוני מעקב לקצה העורפי של יכולת התצפית.
מעקב בצד הלקוח לא זמין ב-Spanner Omni.
למידע נוסף, קראו את המאמר הגדרת איסוף נתוני מעקב באמצעות OpenTelemetry במסמכי התיעוד של Spanner.
ייצוא מעקבים של השרת לאוסף
שרתי Spanner Omni יכולים לייצא את המעקבים שלהם בפורמט OTLP לאוסף מעקבים, כמו Jaeger. כדי להגדיר את ה-collector, מבצעים אחת מהפעולות הבאות:
במכונות וירטואליות, מגדירים את משתנה הסביבה
SPANNER_TRACE_EXPORTER_ENDPOINTלפני שמפעילים את השרתים. מידע נוסף זמין במאמר איסוף וניתוח של נתוני מעקב.ב-Kubernetes, מגדירים את ערך Helm של
deployment.traceExporterEndpoint:helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \ --version 2.0.0 \ --namespace NAMESPACE \ --reuse-values \ --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORTאם מתקינים את תרשים Helm באמצעות
monitoring.enabled=trueולא מגדירים אתdeployment.traceExporterEndpoint, השרתים מייצאים את המעקבים לאוסף Jaeger שמותקן על ידי תרשים Helm, בכתובתdns:///jaeger.monitoring.svc.cluster.local:4317.
השרתים מייצאים את נתוני המעקב לנקודת קצה של שקע דומיין של Unix (יעד שמתחיל ב-unix: או ב-unix-abstract:) בלי TLS, כי נתוני המעקב לא עוזבים את המארח. השרתים מתייחסים לכל אוסף אחר כמרוחק, כולל אוסף ב-localhost, כתובת IP של לולאה חוזרת, pod או שירות אחר, או כתובת ה-IP של צומת Kubernetes (לדוגמה, $HOST_IP:4317 לאוסף DaemonSet).
ייצוא של נתוני מעקב באמצעות TLS
החל מגרסה 2026.r4-lts.3 של Spanner Omni, שרתים בפריסה עם הצפנת TLS מייצאים עקבות לאספן מרוחק רק דרך TLS. בגרסאות קודמות, המערכת מייצאת את נתוני המעקב לאספנים מרוחקים כטקסט פשוט, ואין תמיכה בייצוא נתוני מעקב באמצעות TLS. כדי לייצא נתוני מעקב לאספן מרוחק:
יוצרים את רשות האישורים של אוסף המעקב (
ca-otlp.crt) ואישור לאוסף עבור שם המארח של האוסף בנקודת הקצה של ייצוא המעקב:- במכונות וירטואליות, ראו יצירת רשויות אישורים ויצירת האישור של אוסף המעקב.
- ב-Kubernetes, קראו את המאמרים יצירת רשויות אישורים ויצירת האישור של אוסף המעקב.
מפעילים את TLS במקלט OTLP gRPC של ה-collector באמצעות האישור של ה-collector. בדוגמאות הבאות נעשה שימוש בקבצים
collector.crtו-collector.keyבספרייהotlp-certs. מריצים את הפקודות מהספרייה שבה יצרתם את האישורים, או מחליפים אתotlp-certsבנתיב המלא לספרייה הזו.ב-Jaeger v1 (
jaeger-all-in-one) במכונה וירטואלית:export COLLECTOR_OTLP_ENABLED=true export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key jaeger-all-in-oneבמקום זאת, ב-Jaeger v2 מגדירים את TLS בקובץ התצורה. מידע נוסף זמין במסמכי האבטחה של Jaeger.
לאספן Jaeger שמותקן באמצעות תרשים Helm עם
monitoring.enabled=true, יוצרים סוד TLS בשםjaeger-tlsבמרחב השמותmonitoring:kubectl create secret tls jaeger-tls -n monitoring \ --cert=otlp-certs/collector.crt --key=otlp-certs/collector.keyהחל מגרסה 2.0.0 של תרשים Helm, אוסף Jaeger משרת TLS כברירת מחדל בפריסות עם הצפנת TLS, באמצעות הסוד
jaeger-tls. בפריסות האלה, הפעולותhelm installו-helm upgradeנכשלות אם הסוד לא קיים, אלא אם מגדירים אתdeployment.traceExporterEndpointלאוסף משלכם. כדי להשתמש בסוד עם שם אחר, מגדירים אתmonitoring.jaeger.tls.secretName. Jaeger טוען מחדש את האישור כלmonitoring.jaeger.tls.reloadInterval(ברירת המחדל:1h), כך שאפשר להחליף את האישור בלי להפעיל מחדש.גרסה 2.0.0 של תרשים Helm דורשת את גרסה
2026.r4-lts.3של Spanner Omni או גרסה חדשה יותר. בגרסאות קודמות, צריך להשתמש בגרסה 1.x של תרשים Helm.
מפיצים את
ca-otlp.crtלשרתים יחד עם האישורים האחרים:- במכונות וירטואליות, מעתיקים אותו לספריית האישורים של כל שרת. מידע נוסף זמין במאמר הפצת האישורים לכל השרתים.
ב-Kubernetes, מוסיפים אותו לסוד
tls-certs. מידע נוסף זמין במאמר העברת האישורים, קבוצת מפתחות ה-wrapper וסיסמת האדמין לאשכול Kubernetes. כדי להוסיף אותו לסוד קיים שלtls-certsבלי לשנות את המפתחות האחרים, מריצים את הפקודה הבאה:kubectl patch secret tls-certs -n NAMESPACE --type=merge \ -p "{\"data\":{\"ca-otlp.crt\":\"$(base64 -w 0 certs/ca-otlp.crt)\"}}"
מפעילים או מפעילים מחדש את השרתים. השרתים מחליטים אם להשתמש ב-TLS בזמן ההפעלה, על סמך קיומו של
ca-otlp.crt, כך שהוספה או הסרה של הקובץ נכנסת לתוקף רק אחרי הפעלה מחדש. שינויים בקובץ קיים, כמו רוטציה של אישורים, נכנסים לתוקף בלי הפעלה מחדש.ב-Kubernetes, הוספת מפתח לסוד
tls-certsלא מפעילה מחדש את השרתים. כדי להפעיל אותם מחדש, מריצים את הפקודה הבאה:kubectl rollout restart statefulset -n NAMESPACE \ -l app.kubernetes.io/instance=spanner-omni
השרתים מאמתים שהאישור של ה-collector הונפק על ידי ca-otlp.crt ושהוא תואם לשם המארח בנקודת הקצה של ייצוא המעקב. השרתים לא מציגים אישור לקוח, לכן אל תגדירו את ה-collector כך שידרוש אישורי לקוח. אם ca-otlp.crt קיים, השרתים משתמשים ב-TLS גם לאוספים מרוחקים בפריסות ללא הצפנת TLS.
מעקב אחרי עקבות שהושמטו
בפריסה עם הצפנת TLS, אם ca-otlp.crt לא קיים, השרתים לא מייצאים עקבות לאספן מרוחק. השרתים מתעדים ביומן אזהרה על הגבלת קצב של יצירת בקשות, שמסבירה איך לתקן את ההגדרה, וסופרים את המעקבים שהושמטו במדד opentelemetry_dropped_spans של Prometheus, כשהתווית reason מוגדרת לערך secure_mode.
לפני שיוצרים את הפריסה, השרתים לא יכולים לקבוע אם הפריסה משתמשת בהצפנת TLS. עד אז, אם ca-otlp.crt לא קיים, השרתים לא מייצאים את נתוני המעקב לאספן מרוחק וסופרים אותם כשהתווית reason מוגדרת ל-deployment_state_unavailable.
אם ca-otlp.crt הוא לא אישור CA תקין, או אם האישור של ה-collector לא הונפק על ידי ca-otlp.crt או לא תואם לשם המארח בנקודת הקצה של ייצוא המעקב, החיבורים ל-collector ייכשלו עד שתתקנו את ההגדרה. המדד opentelemetry_dropped_spans לא סופר את הכשלים האלה. כדי לזהות אותן, צריך לבדוק אם יש שגיאות ביומני השרת של לחיצת היד בפרוטוקול TLS ושל ייצוא המעקב. בנוסף, השרתים רושמים אזהרה ביומן בזמן ההפעלה אם ca-otlp.crt לא מכיל אישור PEM.
יומני ביקורת
יומני ביקורת עוקבים אחרי שינויים אדמיניסטרטיביים ואירועי גישה לנתונים, למטרות אבטחה ותאימות. אתם יכולים להשתמש ביומני הביקורת כדי לעקוב אחרי זמני האחזור של הבקשות, באמצעות השדות של משך העיבוד. מידע נוסף זמין במאמר יומני ביקורת.
מופעי מעקב
כדאי לעקוב אחרי המכונות כדי לוודא שהן פועלות כמצופה, וכדי לפתור בעיות אפשריות.
מעקב אחרי ביצועי המכונה באמצעות תובנות
בלוח הבקרה של תובנות המערכת מוצגים תרשימים ומדדים של זמן אחזור, ניצול מעבד, נפח אחסון, קצב העברת נתונים ונתונים סטטיסטיים אחרים של ביצועים. אתם יכולים להשתמש במרכז הבקרה הזה כדי לעקוב אחרי מכונות ומסדי נתונים של Spanner Omni. למידע נוסף, קראו את המאמר מעקב אחרי מכונות באמצעות תובנות מערכת במסמכי התיעוד של Spanner.