Creazione di un criterio di avviso

I criteri di avviso per la burn rate del budget di errore si basano sul selezionatore delle serie temporali select_slo_burn_rate, descritto in Recupero dei dati dello SLO. Esistono altri selettori delle serie temporali e puoi utilizzarne alcuni come base per i criteri di avviso. Per una discussione sui criteri di avviso basati su SLO, consulta Avvisi sul burn rate.

Puoi creare criteri di avviso utilizzando il metodo alertPolicies.create. L'utilizzo generale di questo metodo è descritto in Gestire i criteri di avviso.

I criteri di avviso per gli SLO sono simili ad altri criteri di avviso per soglie di metriche, ma differiscono in un modo specifico: il filter nella specifica MetricThreshold della condizione utilizza un selettore di serie temporali anziché una coppia di tipi di metrica e risorsa monitorata.

Condizioni per i criteri di avviso basati su SLO

Un criterio di avviso deve avere almeno una condizione. Per una condizione basata su SLO, utilizza una condizione di tipo MetricThreshold.

Una condizione di soglia metrica può contenere due coppie di configurazioni di serie temporali: filter e aggregations. Poiché i dati SLO vengono recuperati in modo diverso rispetto ad altri dati delle serie temporali, l'unico campo utilizzato in una condizione per uno SLO è il campo filter.

Una condizione per un SLO imposta i campi comparison, thresholdValue, duration e trigger.

Questo esempio crea una condizione che viene violata quando il tasso di burn supera il doppio della tariffa normale. La struttura ha il seguente aspetto:

  "conditions": [
    {
      "displayName":"SLO burn rate alert for ${SLO_ID} exceeds 2",
      "conditionThreshold": {
        "filter": DATA_RETRIEVAL_FILTER_FOR_SLO,
        "comparison":"COMPARISON_GT",
        "thresholdValue": 2,
        "duration": {
          "seconds":"0",
        },
      },
    }
  ],

Per impostare il campo filter, devi avere il nome della risorsa di un SLO specifico. Questo valore è nel formato projects/${PROJECT}/services/${SERVICE_ID}/serviceLevelObjectives/${SLO_ID}. Per informazioni su come trovare l'ID SLO, consulta Elenco degli SLO.

Per creare un avviso sul burn rate, utilizza il selettore delle serie temporaliselect_slo_burn_rate. Questo selettore accetta due valori, l'obiettivo SLO target e il periodo di riferimento. Per ulteriori informazioni, consulta select_slo_burn_rate.

Ad esempio, il seguente filtro recupera il tasso di utilizzo dello SLO target con un periodo di riferimento di 1 ora:

"filter":"select_slo_burn_rate(\"projects/${PROJECT}/services/${SERVICE_ID}/serviceLevelObjectives/${SLO_ID}\", \"60m\")"

Il resto del criterio di avviso

Per completare il criterio di avviso, specifica i valori per i campi rimanenti:

• displayName: una descrizione del criterio di avviso.
• combiner: descrive la logica di combinazione delle condizioni. Questo criterio ha una sola condizione, quindi AND o OR vanno bene.
• notificationChannels: un array di canali di notifica esistenti da utilizzare quando viene attivato il criterio di avviso. Per informazioni su come trovare e creare canali di notifica, consulta Canali di notifica.
• documentation: informazioni inviate quando la condizione viene violata per aiutare i destinatari a diagnosticare il problema. Per maggiori dettagli, consulta Documentation.

Creazione del criterio di avviso

L'esempio seguente utilizza l'API per creare un criterio di avviso relativo al tasso di utilizzo. Per informazioni su come elencare, modificare ed eliminare i criteri di avviso, consulta Gestire i criteri di avviso tramite API.

Protocollo

Per creare il criterio di avviso utilizzando curl, invia un messaggio POST all'endpoint https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/alertPolicies e fornisci il criterio di avviso nel corpo della richiesta. Il codice JSON nel corpo della richiesta descrive un criterio di avviso che utilizza una condizione di soglia in base al selettore delle serie temporali select_slo_burn_rate con un periodo di riferimento di un'ora.

1. Crea una variabile per contenere il corpo della richiesta:

   CREATE_ALERT_POST_BODY=$(cat <<EOF
   {
     "displayName":"SLO burn-rate alert for ${SLO_ID} with a threshold of 2",
     "combiner":"AND",
     "conditions": [
       {
         "displayName":"SLO burn rate alert for ${SLO_ID} exceeds 2",
         "conditionThreshold": {
           "filter":"select_slo_burn_rate(\"projects/${PROJECT}/services/${SERVICE_ID}/serviceLevelObjectives/${SLO_ID}\", \"60m\")",
           "comparison":"COMPARISON_GT",
           "thresholdValue": 2,
           "duration": {
             "seconds":"0",
           },
         },
       }
     ],
     "notificationChannels": ["${NOTIFICATION_CHANNEL}", ],
     "documentation": {
        "content": "SLO burn for the past 60m exceeded twice the acceptable budget burn rate.",
        "mime_type": "text/markdown",
     },
   }
   EOF
   )
   

2. Pubblica la richiesta nell'endpoint:

   curl  --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}" --header "Content-Type: application/json" -X POST -d "${CREATE_ALERT_POST_BODY}" https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/alertPolicies