ניהול ומעקב אחר AlloyDB Omni

בוחרים גרסת תיעוד:

בדף הזה מוסבר איך לנהל את תפקידי המשתמשים ב-AlloyDB Omni, לעקוב אחרי הפעילות של שרת AlloyDB Omni ולעדכן או להסיר את ההתקנה של AlloyDB Omni.

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

אלה התפקידים ב-AlloyDB Omni:

  • ‫AlloyDB Omni כולל תפקיד של משתמש-על בשם alloydbadmin, ותפקיד של משתמש רגיל בשם alloydbmetadata.

  • למשתמש postgres שמוגדר כברירת מחדל יש תפקיד של משתמש-על.

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

הגדרת מסד נתונים ב-AlloyDB Omni

מומלץ לפעול לפי השלבים הבאים כשמגדירים מסד נתונים של AlloyDB Omni:

  1. מגדירים או מייבאים את מסדי הנתונים באמצעות תפקיד המשתמש postgres. בהתקנה חדשה, לתפקיד הזה יש הרשאות של משתמש-על.

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

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

אתם יכולים ליצור ולהגדיר כמה תפקידי משתמשים חדשים שאתם צריכים. אל תשנו או תמחקו את תפקידי המשתמשים שמגיעים עם AlloyDB Omni.

מידע נוסף זמין במאמר ניהול משתמשים ותפקידים ב-AlloyDB Omni.

מעקב אחרי AlloyDB Omni

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

‫AlloyDB Omni שפועל ב-Kubernetes מספק קבוצה של מדדים בסיסיים שזמינים כנקודות קצה (endpoints) של Prometheus. רשימת המדדים של AlloyDB Omni

בנוסף, AlloyDB Omni שפועל ב-Kubernetes חושף מדדים ממשאבים בהתאמה אישית באמצעות kube-state-metrics ‏(KSM). כדי להפעיל מדדים של משאבים בהתאמה אישית, קראו את המאמר מעקב אחרי משאבים בהתאמה אישית של אופרטור AlloyDB Omni Kubernetes.

‏Kubernetes

איך מוצאים את קובצי היומן של אשכול מסד הנתונים

הקבצים postgresql.audit ו-postgresql.log נמצאים במערכת הקבצים של pod מסד הנתונים. השדה postgresql.audit מופיע רק אם הפעלתם את pgaudit.

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

  1. מגדירים משתנה סביבה שמכיל את השם של ה-Pod של מסד הנתונים.

    export DB_POD=`kubectl get pod -l alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/task-type=database -o jsonpath='{.items[0].metadata.name}'`

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

  2. מריצים מעטפת ב-pod של מסד הנתונים כמשתמש root.

    kubectl exec ${DB_POD} -it -- /bin/bash
  3. מאתרים את קובצי היומן בספרייה /obs/diagnostic/:

    • /obs/diagnostic/postgresql.audit
    • /obs/diagnostic/postgresql.log

רשימת שירותי מעקב

v1.0

כשיוצרים אשכול של מסדי נתונים, AlloyDB Omni יוצר את שירות המעקב הבא לכל משאב מותאם אישית של מכונה באשכול של מסדי הנתונים באותו מרחב שמות:

al-INSTANCE_NAME-monitoring-system

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

kubectl get svc -n NAMESPACE | grep monitoring

מחליפים את NAMESPACE במרחב השמות שאליו שייך האשכול.

בתגובה לדוגמה הבאה מוצגים השירותים al-1060-dbc-monitoring-system,‏ al-3de6-dbc-monitoring-system ו-al-4bc0-dbc-monitoring-system. כל שירות תואם למכונה אחת.

al-1060-dbc-monitoring-system   ClusterIP   10.0.15.227   <none>        9187/TCP   7d20h
al-3de6-dbc-monitoring-system   ClusterIP   10.0.5.205    <none>        9187/TCP   7d19h
al-4bc0-dbc-monitoring-system   ClusterIP   10.0.15.92    <none>        9187/TCP   7d19h

גרסה < 1.0

כשיוצרים אשכול של מסדי נתונים, AlloyDB Omni יוצר את שירותי המעקב הבאים באותו מרחב שמות של אשכול מסדי הנתונים:

  • DB_CLUSTER-monitoring-db

  • DB_CLUSTER-monitoring-system

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

kubectl get svc -n NAMESPACE | grep monitoring

מחליפים את NAMESPACE במרחב השמות שאליו שייך האשכול.

בתגובה לדוגמה הבאה מוצגים השירותים al-2953-dbcluster-foo7-monitoring-system ו-al-2953-dbcluster-foo7-monitoring-db.

al-2953-dbcluster-foo7-monitoring-db           ClusterIP   10.36.3.243    <none>        9187/TCP   44m
al-2953-dbcluster-foo7-monitoring-system       ClusterIP   10.36.7.72     <none>        9187/TCP   44m

הצגת מדדי Prometheus משורת הפקודה

היציאה 9187 נקראת metricsalloydbomni בכל שירותי המעקב.

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

    kubectl port-forward service/MONITORING_SERVICE -n NAMESPACE MONITORING_METRICS_PORT:metricsalloydbomni
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫MONITORING_SERVICE: השם של שירות המעקב שרוצים להעביר, לדוגמה al-1060-dbc-monitoring-system.

    • ‫NAMESPACE: מרחב השמות שאליו שייך האשכול.

    • ‫MONITORING_METRICS_PORT: יציאת TCP מקומית זמינה.

    התגובה הבאה מראה שהשירותים מועברים.

    Forwarding from 127.0.0.1:9187 -> 9187
    Forwarding from [::1]:9187 -> 9187
    
  2. בזמן שהפקודה הקודמת פועלת, אפשר לגשת למדדי המעקב דרך HTTP ביציאה שציינתם. לדוגמה, אפשר להשתמש ב-curl כדי לראות את כל המדדים כטקסט פשוט:

    curl http://localhost:MONITORING_METRICS_PORT/metrics
    

    אתם יכולים גם להציג את המדדים האלה של Prometheus בדף System Insights בממשק המשתמש של AlloyDB Omni באינטרנט. כשנקודת הקצה של שירות המעקב (יציאה 9187) נסרקת על ידי מכונת Prometheus, ממשק המשתמש באינטרנט שולח שאילתות ל-Prometheus כדי להציג תרשימים בזמן אמת של המעבד, הזיכרון, האחסון והקלט/פלט של הדיסק. מידע נוסף זמין במאמר הצגת מדדי המערכת באמצעות System Insights.

הצגת מדדים באמצעות Prometheus API

מפתח התווית alloydbomni.internal.dbadmin.goog/task-type והיציאה metricsalloydbomni זמינים כברירת מחדל לכל שירותי המעקב ב-AlloyDB Omni. אתם יכולים להשתמש בהם יחד עם משאב מותאם אישית אחד של serviceMonitor כדי לבחור את כל השירותים לכל מרחבי השמות באשכול מסד הנתונים.

כשמגדירים את Prometheus לאיסוף נתונים מהיציאה metricsalloydbomni באמצעות Prometheus API, אפשר לחבר את נקודת הקצה של Prometheus לממשק המשתמש באינטרנט של AlloyDB Omni כדי לעקוב אחרי ניצול המשאבים של המארח והמכונה ב-System Insights ‏ (/system-insights). ב-System Insights, אפשר לסנן מדדים במכונות שנאספו מהן נתונים באמצעות התפריט Filter by: Instances ולשנות את חלון התצפית (שעה אחת, 6 שעות, יום אחד או 7 ימים) כדי לבדוק את השימוש ב-CPU, השימוש בזיכרון, הזיכרון הזמין, מגבלת הזיכרון, נפח האחסון הנדרש וקצב הקריאה והכתיבה של קלט/פלט בדיסק. מידע נוסף זמין במאמר הצגת מדדי המערכת באמצעות System Insights.

מידע נוסף על השימוש ב-Prometheus API זמין במסמכי התיעוד של Prometheus Operator.

הדוגמה הבאה היא שדה spec של המשאב בהתאמה אישית serviceMonitor, שכולל את מפתח התווית alloydbomni.internal.dbadmin.gdc.goog/task-type ואת היציאה metricsalloydbomni. המשאב המותאם אישית serviceMonitor עוקב אחרי כל שירותי Kubernetes בכל מרחבי השמות ואוסף אותם

למידע נוסף על ההגדרה המלאה של ServiceMonitor, קראו את הגדרת המשאב בהתאמה אישית של ServiceMonitor .

v1.0

    spec:
      selector:
        matchLabels:
          alloydbomni.internal.dbadmin.goog/task-type: monitoring
      namespaceSelector:
        any: true
      endpoints:
        - port: metricsalloydbomni

גרסה < 1.0

    spec:
      selector:
        matchExpressions:
        - key: alloydbomni.internal.dbadmin.gdc.goog/task-type
          operator: Exists
          values: []
      namespaceSelector:
        any: true
      endpoints:
      - port: metricsalloydbomni

הצגת מדדים באמצעות Grafana

כדי לראות ייצוג חזותי של המדדים ב-AlloyDB Omni ב-Kubernetes, אתם יכולים להשתמש בלוח הבקרה של המעקב. לוח הבקרה למעקב מסתמך על סטאק בסיסי של יכולת תצפית, שמורכב מ-Prometheus ומ-Grafana. כדי להגדיר את לוח הבקרה של המעקב לאיסוף מדדים מ-AlloyDB Omni:

  1. כדי להוריד את מרכז הבקרה של Grafana, משתמשים בפקודה wget:

    wget https://raw.githubusercontent.com/GoogleCloudPlatform/alloydb-omni-samples/refs/heads/main/monitoring-dashboards/grafana/alloydbomni_dashboard.yaml
    
  2. לפני שפורסים את Grafana ב-Kubernetes, צריך להוריד ולהתקין את grafana-operator. הוראות מפורטות זמינות במאמר התקנה.

  3. מוסיפים את התווית monitoring.dashboard/product=alloydb-omni למכונה של Grafana שבה מתקינים את לוח הבקרה:

    kubectl label grafana/GRAFANA_INSTANCE_NAME monitoring.dashboard/product=alloydb-omni -n NAMESPACE
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫GRAFANA_INSTANCE_NAME: השם של מכונת Grafana שבה נמצא מרכז הבקרה.
    • ‫NAMESPACE: מרחב השמות שבו פרסתם את האופרטור של Grafana.
  4. כדי להחיל את ההגדרות של לוח הבקרה של Grafana על אשכול AlloyDB Omni ב-Kubernetes, משתמשים בפקודה הבאה:

    kubectl apply -f alloydbomni_dashboard.yaml -n NAMESPACE
    

    במסמכי התיעוד של Grafana Operator מוסבר איך משתמשים ב-Grafana Operator.

  5. כדי להגדיר את Grafana להשתמש ב-Prometheus כמקור נתונים, ראו מקורות נתונים.

  6. כדי לוודא ש-Grafana מוגדרת כמו שצריך, מבצעים אחת מהפעולות הבאות:

    • צפו באוסף של לוחות Grafana במרכז הבקרה של AlloyDB Omni.
    • אחזור מידע על מרכז הבקרה של Grafana באשכול Kubernetes:

      kubectl get grafanadashboard alloydb-omni-dashboard -n NAMESPACE -o jsonpath='{.status.conditions[?(@.type=="DashboardSynchronized")].status}'
      

      אם הפקודה מחזירה את הערך True, סימן שה-alloydb-omni-dashboard נפרס בהצלחה במכונה של Grafana.

הצגת מדדי המערכת באמצעות "תובנות לגבי המערכת"

אתם יכולים לעקוב אחרי מדדי תשתית היסטוריים ובזמן אמת של מכונות AlloyDB Omni באמצעות תובנות מערכת בממשק המשתמש של AlloyDB Omni באינטרנט. הכלי System Insights שולח שאילתות למדדי Prometheus שמיוצאים על ידי רכיב מעקב ב-AlloyDB Omni, כדי להציג תרשימים של ניצול המשאבים.

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

  1. מתחברים לממשק המשתמש באינטרנט ובוחרים את האשכול.
  2. בתפריט הניווט, לוחצים על תובנות מערכת.
  3. אופציונלי: באשכול עם כמה צמתים, משתמשים ברשימה Filter by: Instances כדי לבחור נקודת קצה ספציפית של מכונה (לדוגמה, localhost:9187).
  4. בוחרים חלון זמן (שעה, 6 שעות, יום או 7 ימים) כדי לשנות את תקופת התצפית בכל התרשימים.
  5. בודקים את תרשימי הטלמטרייה של המערכת:
    • ‫CPU Usage: אחוז הניצול של המעבד לאורך זמן.
    • ‫Memory Usage: אחוז השימוש בזיכרון המוקצה לאורך זמן.
    • זיכרון זמין: אחוז הזיכרון הפנוי לאורך זמן.
    • ‫Memory Limit: מכסת הזיכרון שהוגדרה למכונה (ב-GB).
    • אחסון וקלט/פלט של דיסק: מוצגים שישה תרשימים נוספים שעוקבים אחרי נפח האחסון הנדרש, מגבלת האחסון, מספר פעולות הקריאה מהדיסק, מספר הבייטים שנקראו, מספר פעולות הכתיבה לדיסק ומספר הבייטים שנכתבו.

הסרת AlloyDB Omni

‏Kubernetes

מחיקת אשכול מסד הנתונים

כדי למחוק את אשכול מסד הנתונים, צריך להגדיר את isDeleted ל-true במניפסט שלו. כדי לעשות את זה, משתמשים בפקודה הבאה:

kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -p '{"spec":{"isDeleted":true}}' --type=merge

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

הסרת אופרטור AlloyDB Omni

כדי להסיר את אופרטור AlloyDB Omni Kubernetes מאשכול Kubernetes:

  1. מוחקים את כל אשכולות מסדי הנתונים:

    for ns in $(kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespaces -o=jsonpath='{range .items[*]}{.metadata.namespace}{"\n"}{end}'); do
    for cr in $(kubectl get dbclusters.alloydbomni.dbadmin.goog -n $ns -o=jsonpath='{range .items[*]}{.metadata.name}{"\n"}{end}'); do
    kubectl patch dbclusters.alloydbomni.dbadmin.goog $cr -n $ns --type=merge -p '{"spec":{"isDeleted":true}}'
    done
    done
  2. מחכים עד שאופרטור AlloyDB Omni Kubernetes ימחק את כל אשכולות מסדי הנתונים. כדי לבדוק אם נשארו משאבים של מסד הנתונים, משתמשים בפקודה הבאה:

    kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespaces
  3. מוחקים משאבים אחרים שנוצרו על ידי אופרטור AlloyDB Omni Kubernetes:

    kubectl delete failovers.alloydbomni.dbadmin.goog --all --all-namespaces
    kubectl delete restores.alloydbomni.dbadmin.goog --all --all-namespaces
    kubectl delete switchovers.alloydbomni.dbadmin.goog --all --all-namespaces
  4. מסירים את האופרטור של AlloyDB Omni Kubernetes:

    helm uninstall alloydbomni-operator --namespace alloydb-omni-system
  5. מוחקים את הסודות, התיאורים של המשאבים בהתאמה אישית ומרחבי השמות שקשורים לאופרטור AlloyDB Omni Kubernetes:

    kubectl delete certificate -n alloydb-omni-system --all
    kubectl get secrets --all-namespaces -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,ANNOTATION:.metadata.annotations.cert-manager\.io/issuer-name | grep -E 'alloydbomni|dbs-al' | awk '{print $1 " " $2}' | xargs -n 2 kubectl delete secret -n
    kubectl delete crd -l alloydb-omni=true
    kubectl delete ns alloydb-omni-system

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

כדי לשנות את הגודל של המעבד (CPU), הזיכרון או האחסון של אשכול מסד הנתונים שמבוסס על Kubernetes, צריך לעדכן את השדה resources של המניפסטים שמגדירים את ה-pod שלו. אופרטור AlloyDB Omni מחיל מיד את המפרטים החדשים על ה-Pod של מסד הנתונים.

מידע נוסף על תחביר המניפסט של אופרטור AlloyDB Omni זמין במאמר יצירת אשכול של מסדי נתונים.

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

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