סקירה כללית של מעקב

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

  1. יוצרים את רשות האישורים של אוסף המעקב (ca-otlp.crt) ואישור לאוסף עבור שם המארח של האוסף בנקודת הקצה של ייצוא המעקב:

  2. מפעילים את 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.

  3. מפיצים את ca-otlp.crt לשרתים יחד עם האישורים האחרים:

  4. מפעילים או מפעילים מחדש את השרתים. השרתים מחליטים אם להשתמש ב-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.

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