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

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

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

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

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

מידע נוסף על kube-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 operator כדי לשלוט בהתקנה ובהסרה של מדדים של משאבים בהתאמה אישית:

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

crdMetrics.enabled

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

crdMetrics.ksmImage

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

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

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

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

    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.

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