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

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

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

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

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

למידע נוסף על kube-state-metrics, ראו סקירה כללית. במאמר Custom Resource State Metrics מוסבר איך kube-state-metrics עוקב אחרי משאבים בהתאמה אישית של Kubernetes.

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

כברירת מחדל, מדדי משאבים בהתאמה אישית לא מופעלים. אתם יכולים להפעיל מדדי משאבים בהתאמה אישית באמצעות תרשים Helm של אופרטור AlloyDB Omni Kubernetes. כשמפעילים מדדי משאבים בהתאמה אישית, נוצר פריסת 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=$(curl https://storage.googleapis.com/$GCS_BUCKET/latest)
    export OPERATOR_VERSION="${HELM_PATH%%/*}"
    
  3. מורידים את האופרטור של AlloyDB Omni ל-Kubernetes:

    curl https://storage.googleapis.com/$GCS_BUCKET/$HELM_PATH --output alloydbomni-operator-${OPERATOR_VERSION}.tgz
    
  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 operator שהורדתם. הקובץ נקרא alloydbomni-operator-VERSION_NUMBER.tgz והוא נמצא בספריית העבודה הנוכחית.

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

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

  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. מורידים את האופרטור של הגרסה שצוינה:

    curl https://storage.googleapis.com/$GCS_BUCKET/$HELM_PATH --output alloydbomni-operator-${OPERATOR_VERSION}.tgz
    
  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.

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