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

בוחרים גרסה של מאמרי העזרה:

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

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

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

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

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

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

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

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

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

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

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

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

מעקב אחרי AlloyDB Omni

מעקב אחרי ההתקנה של AlloyDB Omni כולל קריאה וניתוח של קובצי יומן של AlloyDB Omni.

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

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

שרת יחיד

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

Docker

  docker logs CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

כדי להגדיר את אופן הרישום ביומן של AlloyDB Omni, קראו את המאמר התאמה אישית של התקנת AlloyDB Omni.

Podman

  podman logs CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

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

Podman

  podman logs CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

כדי להגדיר את אופן הרישום ביומן של AlloyDB Omni, קראו את המאמר התאמה אישית של התקנת AlloyDB Omni.

‏Kubernetes

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

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

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

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

    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. מריצים מעטפת (shell) ב-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 API

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

מידע נוסף על השימוש ב-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

שדרוג של AlloyDB Omni

כדי לשדרג מגרסה 15.5.2 או גרסה קודמת של AlloyDB Omni לגרסה 15.5.4, פועלים לפי ההוראות במאמר מעבר מגרסה קודמת של AlloyDB Omni לגרסה העדכנית.

כדי לשדרג מגרסה 15.5.4 ואילך:

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

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

הסרת AlloyDB Omni

שרת יחיד

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

Docker

 docker container stop CONTAINER_NAME
   docker container rm CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

Podman

 podman container stop CONTAINER_NAME
   podman container rm CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

Podman

 podman container stop CONTAINER_NAME
   podman container rm CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.

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