שימוש ביומני פלטפורמה

בדף הזה נסביר איך לצפות ביומני הפלטפורמה שנוצרו על ידי App Lifecycle Manager. יומני פלטפורמה ב- Google Cloud הם יומנים ספציפיים לשירות, שאפשר להשתמש בהם כדי לנפות באגים ולפתור בעיות, וכדי להבין טוב יותר את השירותים שבהם אתם משתמשים. Google Cloud

פרטים על יומני פלטפורמה נתמכים של App Lifecycle Manager זמינים במאמר בנושא Google Cloud יומני פלטפורמה. למידע נוסף על הבנת הנתונים בטבלאות של יומן הפלטפורמה, ראו מבנה של רשומות ביומן.

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

  1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
  2. מוודאים שהחיוב מופעל בפרויקט Google Cloud .
  3. מפעילים את App Lifecycle Manager API.
  4. כדי לקבל את ההרשאות שדרושות להצגת יומנים וליצירת התראות, צריך לבקש מהאדמין להקצות לכם את התפקידים הבאים בניהול זהויות והרשאות גישה (IAM) בפרויקט:
    • כלי לצפייה ביומנים (roles/logging.viewer)
    • עריכה ב-Monitoring (roles/monitoring.editor)

יצירת התראות שמבוססות על יומנים

כדי ליצור התראה שמבוססת על יומן, יוצרים שאילתה ב-Logs Explorer שמחזירה את רשומות היומן שרוצים לקבל לגביהן התראה, ואז מגדירים את מדיניות ההתראה.

  1. נכנסים לדף Logs Explorer במסוף Google Cloud .

    כניסה לדף Logs Explorer

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

  3. לוחצים על יצירת התראה.

  4. מזינים שם ותיאור למדיניות ההתראה.

  5. מגדירים את פרטי ההתראה, כולל ערוצי ההתראה.

  6. לוחצים על שמירת ההתראה.

הוראות מפורטות זמינות במאמר יצירת התראה שמבוססת על יומן.

שאילתות לדוגמה ליומני פלטפורמה

בקטע הזה מופיעות דוגמאות לשאילתות לתרחישים נפוצים של התראות שמבוססות על יומני פלטפורמה של App Lifecycle Manager.

התראות על פעולות SaaS

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

protoPayload.methodName="google.cloud.saasplatform.saasservicemgmt.v1beta1.SaasDeployments.CreateUnitOperation"
protoPayload.response.state="UNIT_OPERATION_STATE_FAILED"

כדי ליצור התראה על מצב סופי של פעולת הקצאת יחידה (הצלחה, כישלון או ביטול), משתמשים בשאילתה:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.UnitOperationLog"
AND (jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_SUCCEEDED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_FAILED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_CANCELLED")
AND jsonPayload.unit_operation_type="PROVISION"

התראות על השקה

כדי ליצור התראת יומן למצב PAUSED של פריסה (כי App Lifecycle Manager זיהה שהפריסה לא תקינה) או למצב FAILED, משתמשים בשאילתה:

resource.type = "saasservicemgmt.googleapis.com/Rollout"
(jsonPayload.currentState = "PAUSED" AND jsonPayload.reason = "SYSTEM_PAUSE")
  OR
jsonPayload.currentState = "FAILED"

כדי ליצור התראה על מדדים של מצב ההשקה כשמצב ההשקה הוא PAUSED (כי App Lifecycle Manager זיהה שההשקה לא תקינה) או FAILED, משתמשים בשאילתה:

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

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