דוגמאות לכללי מדיניות התראות

במסמך הזה מוצגות דוגמאות למדיניות התראות שמתאימה אישית את התוכן של התראות.

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

להכיר את הגדרת ההתראות למרכז האישי ב-Service Health.

בהפניה לסכימת יומן של Service Health מפורטים השדות שאפשר להגדיר בהתראות ובתנאים.

דוגמאות לתנאים להצגת התראה

בקטעים הבאים מופיעות דוגמאות לתנאים של התראות ברמת פירוט גבוהה שאפשר להשתמש בהם ב-Cloud Logging או ב-Terraform.

הערה: צריך להגדיר את הגרסה של יומני Service Health בתנאי ההתראה. הגרסה הנוכחית היא type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog.

התראה על תקרית חדשה במוצר ספציפי Google Cloud

מגדירים את ALERT_CONDITION לערך הבא:

labels."servicehealth.googleapis.com/new_event"=true AND jsonPayload.detailedCategory = \"CONFIRMED_INCIDENT\" AND jsonPayload.impactedProductIds =~ \"hV87iK5DcEXKgWU2kDri\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

שם המוצר הוא בפורמט Google Cloud הנפוץ. דוגמה לפורמט מופיעה במאמר Google Cloud Service Health.

התראה על תקרית חדשה באזור מסוים

מגדירים את ALERT_CONDITION לערך הבא:

labels."servicehealth.googleapis.com/new_event"=true AND jsonPayload.detailedCategory = \"CONFIRMED_INCIDENT\" AND jsonPayload.impactedLocations =~ \"us-central1\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

שם המיקום הוא בפורמט Google Cloud הנפוץ. דוגמה לפורמט מופיעה במאמר Google Cloud Service Health.

התראה על תקרית חדשה שמתפתחת במוצר ספציפי

מגדירים את ALERT_CONDITION לערך הבא:

labels."servicehealth.googleapis.com/new_event"=true AND jsonPayload.detailedCategory = \"EMERGING_INCIDENT\" AND jsonPayload.impactedProductIds =~ \"ix7u9beT8ivBdjApTif3\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

התראה על כל עדכון או שינוי באירוע

מגדירים את ALERT_CONDITION לערך הבא:

jsonPayload.detailedCategory = \"CONFIRMED_INCIDENT\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

התראה על כל עדכון לגבי אירועים שאושרו

מגדירים את ALERT_CONDITION לערך הבא:

jsonPayload.state =~ \"ACTIVE\" AND jsonPayload.detailedCategory = \"CONFIRMED_INCIDENT\" AND jsonPayload.detailedState != \"EMERGING\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

התראה על עדכונים בסטטוס או ברלוונטיות

מגדירים את ALERT_CONDITION לערך הבא:

jsonPayload.detailedCategory = \"CONFIRMED_INCIDENT\" AND "labels.servicehealth.googleapis.com/updated_fields" =~ \"'state'\" OR labels."servicehealth.googleapis.com/updated_fields" =~ \"'relevance'\" AND jsonPayload.@type = \"type.googleapis.com/google.cloud.servicehealth.logging.v1.EventLog\"

התראה עם פרטים מלאים על האירוע

בהודעת ההתראה הבאה מופיעים פרטים מלאים על האירוע.

{
  "displayName": "ALERT_NAME",
  "combiner": "OR",
  "conditions": [ {
    "displayName": "Log match condition",
    "conditionMatchedLog": {
      "filter": "ALERT_CONDITION",
      "labelExtractors": {
        "description": "EXTRACT(jsonPayload.description)",
        "impactedLocations": "EXTRACT(jsonPayload.impactedLocations)",
        "impactedProducts": "EXTRACT(jsonPayload.impactedProducts)",
        "startTime": "EXTRACT(jsonPayload.startTime)",
        "state": "EXTRACT(jsonPayload.state)",
        "detailedState": "EXTRACT(jsonPayload.detailedState)"
      } } } ],
  "documentation": {
  "content": "# View details at [Service Health dashboard](https://console.cloud.google.com/servicehealth/incidentDetails/projects%2F${resource.labels.resource_container}%2Flocations%2F${resource.labels.location}%2Fevents%2F${resource.labels.event_id}?project=${resource.labels.resource_container}) \n## Description \n${log.extracted_label.description} \n## Impacted locations \n${log.extracted_label.impactedLocations} \n## Impacted products \n${log.extracted_label.impactedProducts} \n## Incident start time \n${log.extracted_label.startTime} \n## Event state \n${log.extracted_label.state} \n## Event detailed state \n ${log.extracted_label.detailedState}",
    "mimeType": "text/markdown"
  },
  "notificationChannels": [ "NOTIFICATION_CHANNEL" ],
  "enabled": true,
  "alertStrategy": { "notificationRateLimit": { "period": "300s" }, "autoClose": "1800s" }
}

השדות labelExtractors ו-content בדוגמה כוללים את כל המידע שזמין לגבי האירוע.

התראה עם קישור למרכז הבקרה Service Health

בדוגמה הבאה מוצג קישור ללוח הבקרה של Service Health.

{
  "displayName": "ALERT_NAME",
  "combiner": "OR",
  "conditions": [ {
    "displayName": "Log match condition",
    "conditionMatchedLog": {
      "filter": "ALERT_CONDITION",
      "labelExtractors": {
        "description": "EXTRACT(jsonPayload.description)",
        "impactedLocations": "EXTRACT(jsonPayload.impactedLocations)",
        "impactedProducts": "EXTRACT(jsonPayload.impactedProducts)",
        "startTime": "EXTRACT(jsonPayload.startTime)",
        "state": "EXTRACT(jsonPayload.state)",
        "detailedState": "EXTRACT(jsonPayload.detailedState)"
      } } } ],
  "documentation": {
  "content": "# View details at [Service Health dashboard](https://console.cloud.google.com/servicehealth/eventDetails/projects%2F${resource.labels.resource_container}%2Flocations%2F${resource.labels.location}%2Fevents%2F${resource.labels.event_id})",
    "mimeType": "text/markdown"
  },
  "notificationChannels": [ "NOTIFICATION_CHANNEL" ],
  "enabled": true,
  "alertStrategy": { "notificationRateLimit": { "period": "300s" }, "autoClose": "1800s" }
}