Documentazione di Oracle Cloud Infrastructure

Creazione di un allarme di assenza

Creare un allarme assenza in Monitoraggio per inviare notifiche quando una metrica non emette dati per un intervallo specificato.

La statistica absent() in un allarme di assenza restituisce 1 (true) quando la metrica è assente per l'intero intervallo. Dopo i valori 1 continui per la durata del periodo di rilevamento assenza, la statistica smette di restituire i valori. Quando la metrica è presente durante l'intervallo, la statistica restituisce 0 (falso).

Il periodo di rilevamento delle assenze predefinito è di due ore. Per ulteriori informazioni sul periodo di rilevamento delle assenze, vedere Esempio di allarme assenza.

Esempio
La query di metrica seguente dispone di un allarme di assenza per un'istanza di computazione impostata su un intervallo di 1 minuto (con il periodo di rilevamento assenza predefinito):
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
La query di metrica riportata di seguito imposta il periodo di rilevamento delle assenze su 20 ore.
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20h)
Nota

Si consiglia di includere groupBy nella query dell'allarme assenza. L'utilizzo di groupBy impedisce trigger di allarme irrilevanti quando OCI introduce nuove dimensioni. Una nuova dimensione crea un flusso di metriche inizialmente vuoto.

Con groupBy, l'allarme monitora solo i flussi di metriche raggruppati. La query di esempio precedente attiva l'allarme quando non esistono flussi di metriche per l'istanza. Se OCI Compute aggiunge una dimensione a CpuUtilization e altri flussi di metriche (da altre dimensioni) non sono assenti, l'allarme non viene attivato.

Senza groupBy, l'allarme controlla tutti i flussi di metriche. Ad esempio, considerare la query CpuUtilization[1m].absent(). Se OCI Compute aggiunge una dimensione a CpuUtilization, l'allarme viene attivato, indipendentemente dalla presenza di altri flussi di metriche.

Nel grafico delle metriche della pagina Crea allarme, una linea rossa tratteggiata indica la soglia di assenza. L'esempio riportato di seguito mostra un valore 1 per un flusso di metriche, che indica che l'istanza di computazione corrispondente a questo flusso di metriche non ha emesso dati di metrica CpuUtilization fino alle 1:30.
Dati delle metriche assenti in un grafico, pagina Crea allarme.

Per la risoluzione dei problemi di allarme, vedere Risoluzione dei problemi relativi agli allarmi.

    1. Nella pagina di elenco Definizioni allarmi, selezionare Crea allarme. Per informazioni su come trovare la pagina dell'elenco, vedere Elenco di allarmi.
    2. Nella sezione Regola trigger in Crea allarme, configurare il trigger di assenza.
      • Operatore: selezionare assente.
      • Minuti ritardo trigger: immettere il numero di minuti durante il quale la condizione deve essere gestita prima che l'allarme si trovi nello stato di attivazione.

      In alternativa, selezionare Passa alla modalità avanzata per utilizzare MQL.

    3. Per personalizzare il periodo di rilevamento delle assenze:
      Il periodo di rilevamento delle assenze predefinito è di due ore. Per ulteriori informazioni sul periodo di rilevamento delle assenze, vedere Esempio di allarme assenza.
      1. Nella parte superiore della pagina, selezionare Passa alla modalità avanzata.
        La query viene visualizzata nel linguaggio MQL (Monitoring Query Language) nella casella Editor di codici query. Ad esempio:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      2. Sostituire absent() con absent(<number-and-unit).
        I valori validi vanno da un minuto (1m) a tre giorni (3d o 72h). Specificare il periodo di tempo nel periodo di rilevamento delle assenze utilizzando un numero e un'unità (m, h o d per il minuto, l'ora o il giorno).
        Esempio (periodo di rilevamento delle assenze di 20 ore):
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent(20h)
    4. (Facoltativo) Per evitare trigger di allarme non pertinenti quando OCI introduce nuove dimensioni (consigliato):
      1. Passare all'area Dimensioni metrica e fornire i valori riportati di seguito.
        • Nome dimensione: selezionare un qualificatore specificato nella definizione della metrica. Ad esempio, la dimensione resourceId viene specificata nella definizione della metrica per CpuUtilization.
        • Valore dimensione: selezionare il valore da utilizzare per la dimensione specificata. Ad esempio, se è stata selezionata la dimensione resourceId, selezionare l'identificativo della risorsa per l'istanza che si sta monitorando.
      2. Nella parte superiore della pagina, selezionare Passa alla modalità avanzata.
        La query viene visualizzata nel linguaggio MQL (Monitoring Query Language) nella casella Editor di codici query. Ad esempio:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      3. Nella casella Editor di codici query, prima di .absent(), inserire .groupBy(<dimension_name>).
        Ad esempio:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
    5. Fornire i valori per i campi rimanenti.
      Per informazioni, vedere Creazione di un allarme di base.
    6. Selezionare Salva allarme.

  • Utilizzare il comando oci monitoring Alarm create e i parametri richiesti per creare un allarme di soglia. Per il parametro obbligatorio --query-text, utilizzare un'espressione MQL che specifica una regola trigger assenza:

    oci monitoring alarm create --query-text <mql_expression_specifying_absence_trigger_rule> [...]

    Per un elenco completo dei parametri e dei valori per i comandi CLI, vedere Command Line Reference for Monitoring.

  • Eseguire l'operazione CreateAlarm per creare un allarme di assenza.

    Quando si definiscono i dettagli per CreateAlarmDetails, impostare query su un'espressione MQL che specifica una regola di trigger assenza.