Creazione di un criterio di avviso

I criteri di avviso per il burn rate del budget di errore si basano sul selettore di serie temporali select_slo_burn_rate, descritto in Recupero dei dati SLO. Esistono altri selettori di 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.

Crea criteri di avviso utilizzando il metodo alertPolicies.create. L'utilizzo generale di questo metodo è documentato in Gestione dei criteri di avviso.

I criteri di avviso per gli SLO sono simili ad altri criteri di avviso basati su soglie delle metriche, ma differiscono in un modo specifico: 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 delle 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 consumo supera il doppio del tasso normale. La struttura è la seguente:

  "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 disporre del 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, vedi Elenco degli SLO.

Per creare un avviso sul burn rate, utilizza il selettore delle serie temporali select_slo_burn_rate. Questo selettore accetta due valori: lo SLO target e il periodo di analisi. Per ulteriori informazioni, vedi select_slo_burn_rate.

Ad esempio, il seguente filtro recupera il burn rate dello SLO target con un periodo di analisi 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 per combinare le condizioni. Questo criterio ha una sola condizione, quindi funziona AND o OR.
• 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 in caso di violazione della condizione per aiutare i destinatari a diagnosticare il problema. Per maggiori dettagli, vedi Documentation.

Creazione del criterio di avviso

L'esempio seguente utilizza l'API per creare un criterio di avviso sul burn rate. Per informazioni su come elencare, modificare ed eliminare i criteri di avviso, consulta la pagina Gestione dei 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 JSON nel corpo della richiesta descrive un criterio di avviso che utilizza una condizione di soglia basata sul selettore di serie temporali select_slo_burn_rate con un periodo di analisi 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. Invia la richiesta all'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