מעקב אחרי משאבים מותאמים אישית של אופרטור Kubernetes ב-AlloyDB Omni

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

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

הפעלת KSM באמצעות אופרטור Kubernetes מאפשרת לכם:

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

מידע נוסף על kube-state-metrics זמין במאמר סקירה כללית. מידע על האופן שבו kube-state-metrics מנטר משאבים מותאמים אישית של Kubernetes מופיע במאמר מדדי מצב של משאבים מותאמים אישית.

איך פועלים משאבים בהתאמה אישית של אופרטור AlloyDB Omni Kubernetes

כברירת מחדל, מדדים מותאמים אישית של מקורות מידע לא מופעלים. אפשר להפעיל מדדי משאבים בהתאמה אישית באמצעות תרשים Helm של AlloyDB Omni Kubernetes Operator. כשמפעילים מדדי משאבים מותאמים אישית, נוצר פריסת KSM עם configmap שמגדיר את מדדי המשאבים המותאמים אישית ושירות מסוג ClusterIP כדי לחשוף את נקודת הקצה של המדדים של פריסת KSM. הכלי לאיסוף נתונים של Prometheus יכול לאסוף את המדדים, ואפשר להציג את המדדים האלה יחד עם מדדים אחרים של AlloyDB Omni. מידע נוסף זמין במאמר בנושא מדדים של משאבים בהתאמה אישית לאופרטור AlloyDB Omni Kubernetes.

לפני שמתחילים

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

  • כלי לגירוד מדדים שתואם ל-Prometheus ופועל באשכול Kubernetes.
  • גישה לתמונת kube-state-metrics שמתארחת בכתובת registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0. אפשר למשוך מראש את התמונה למאגר הפרטי.
  • helm כלי לניהול חבילות. מריצים פקודות Helm בטרמינל של שורת פקודה ב-Linux.

התקנת אופרטור Kubernetes עם הפעלה של מדדי משאבים מותאמים אישית

משתמשים במשתנים הבאים בתרשים Helm של אופרטור AlloyDB Omni Kubernetes כדי לשלוט בהתקנה ובהסרה של מדדים של משאבים בהתאמה אישית:

משתנה סוג תיאור ברירת מחדל

crdMetrics.enabled

ערך בוליאני (true/false) הפעלה והשבתה של מדדי משאבים מותאמים אישית ‫false (השבתה)

crdMetrics.ksmImage

String הנתיב המלא של ksmImage

registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0

אם עדיין לא התקנתם את תרשים Helm של האופרטור, צריך להגדיר את המשתנים כשמריצים את הפקודה Helm install.

כדי להתקין את Kubernetes operator עם מדדים של משאבים מותאמים אישית, צריך לבצע את השלבים הבאים:

  1. פותחים טרמינל של שורת פקודה ב-Linux.
  2. מגדירים את משתני הסביבה הבאים על ידי הרצת הפקודות הבאות:

    export GCS_BUCKET=alloydb-omni-operator
    export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
    export OPERATOR_VERSION="${HELM_PATH%%/*}"
    
  3. מורידים את אופרטור AlloyDB Omni Kubernetes:

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive
    
  4. אם מראש מושכים את תמונת ה-KSM הציבורית בכתובת registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0 למאגר הפרטי, מדלגים על השלב הזה ועוברים לשלב הבא. אחרת, מתקינים את אופרטור AlloyDB Omni Kubernetes עם מדדי משאבים מותאמים אישית, ואז ממשיכים לשלב האחרון בתהליך הזה.

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
    --create-namespace \
    --namespace alloydb-omni-system \
    --set crdMetrics.enabled=true \
    --atomic \
    --timeout 5m
    
  5. מייצאים את משתנה הסביבה:

    export KSM_IMAGE=<full path to your KSM image>
    
  6. כדי להתקין את AlloyDB Omni Kubernetes operator עם מדדי משאבים בהתאמה אישית ומיקום משלכם של תמונת KSM, מריצים את הפקודה הבאה:

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
    --create-namespace \
    --namespace alloydb-omni-system \
    --set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \
    --atomic \
    --timeout 5m
    

    התקנה מוצלחת מחזירה את הפלט הבא:

    NAME: alloydbomni-operator
    LAST DEPLOYED: CURRENT_TIMESTAMP
    NAMESPACE: alloydb-omni-system
    STATUS: deployed
    REVISION: 1
    TEST SUITE: None
    
  7. כדי לנקות את ההתקנה, מוחקים את קובץ ההתקנה של אופרטור AlloyDB Omni Kubernetes שהורד. שם הקובץ הוא alloydbomni-operator-VERSION_NUMBER.tgz, והוא נמצא בספריית העבודה הנוכחית.

הפעלת מדדים של משאבים בהתאמה אישית באופרטור Kubernetes קיים

אם כבר התקנתם את AlloyDB Omni Kubernetes operator בגרסה 1.3.0 (או בגרסה מתקדמת יותר), תוכלו לשדרג את האופרטור הקיים כדי להפעיל מדדים של משאבים מותאמים אישית.

  1. פותחים טרמינל של שורת פקודה ב-Linux.
  2. כדי למצוא את הגרסה הנוכחית של אופרטור AlloyDB Omni Kubernetes ולהגדיר את משתני הסביבה, מריצים את הפקודות הבאות:

    export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system  -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]')
    
    OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"}
    
    echo $OPERATOR_VERSION
    
    export GCS_BUCKET=alloydb-omni-operator
    
    export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz
    

    הפלט הוא גרסת האופרטור של AlloyDB Omni Kubernetes שהתקנתם, לדוגמה, 1.3.0.

  3. מורידים את אופרטור הגרסה שצוין:

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive
    
  4. כדי לשדרג את אופרטור AlloyDB Omni Kubernetes, מריצים את הפקודות הבאות ואז עוברים לשלב האחרון בתהליך הזה. אם מורידים מראש את תמונת ה-KSM הציבורית בכתובת registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0 למאגר הפרטי, מדלגים על השלב הזה ועוברים ישירות לשלב הבא.

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
    --namespace alloydb-omni-system \
    --reuse-values \
    --set crdMetrics.enabled=true \
    --atomic \
    --timeout 5m
    
  5. מייצאים את משתנה הסביבה:

    export KSM_IMAGE=<full path to your KSM image>
    
  6. כדי לבצע את השדרוג, מריצים את הפקודה הבאה:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
    --namespace alloydb-omni-system \
    --reuse-values \
    --set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \
    --atomic \
    --timeout 5m
    

    אם השדרוג יושלם בהצלחה, יתקבל הפלט הבא:

    NAME: alloydbomni-operator
    LAST DEPLOYED: CURRENT_TIMESTAMP
    NAMESPACE: alloydb-omni-system
    STATUS: deployed
    REVISION: 2
    TEST SUITE: None
    

השבתה של מדדי משאבים בהתאמה אישית באופרטור קיים של Kubernetes

  1. פותחים טרמינל של שורת פקודה ב-Linux.
  2. מריצים את הפקודה הבאה:

    export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system  -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]')
    
    OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"}
    
  3. כדי להשבית מדדים מותאמים אישית של משאבים, מריצים את הפקודה הבאה:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
    --namespace alloydb-omni-system \
    --reuse-values \
    --set crdMetrics.enabled=false \
    --atomic \
    --timeout 5m
    

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

הוראות להצגת המדדים מופיעות במאמר הצגת מדדים באמצעות Prometheus API.

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