Documentazione dell'infrastruttura Oracle Cloud

Aggiunta di regole trigger a un allarme

Definire una o più regole di trigger o predicati per un allarme. Una regola trigger è una condizione (definita dalla query) che deve essere soddisfatta affinché l'allarme sia in stato di attivazione e include anche la severità, il ritardo del trigger (pendingDuration) e il corpo dell'allarme da includere nelle notifiche. Una condizione in una regola trigger può specificare una soglia, ad esempio il 90% per l'utilizzo della CPU o un'assenza.

Aggiungere fino a due regole di attivazione, o predicati, a un allarme. Ad esempio, aggiungere una regola trigger critica per il 95% e una regola trigger di avvertenza per il 90%.

Nota

Per informazioni su come vengono inviate le notifiche quando un allarme dispone di più regole di attivazione, vedere Raggruppamento delle notifiche per un allarme e Divisione delle notifiche per un allarme.
Regole di trigger di esempio in un allarme
{
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

Per gli operatori predicato validi nelle espressioni MQL, vedere Operatori predicato.

Per la risoluzione dei problemi relativi agli allarmi, vedere Risoluzione dei problemi relativi agli allarmi. Vedere anche Creazione di un allarme di base.

    1. Nella pagina di elenco Definizioni allarmi selezionare l'allarme da utilizzare. Se è necessaria assistenza per trovare la pagina dell'elenco o l'allarme, vedere Elenca allarmi.
    2. Andare a Azioni, quindi selezionare Modifica allarme.
    3. Nell'area Descrizione metrica, verificare che lo spazio di nomi della metrica e il nome della metrica desiderati siano selezionati.
    4. Per definire una regola trigger (predicato) utilizzando la modalità Base (impostazione predefinita), andare all'area Regola trigger e fornire i valori riportati di seguito.
      • Per Operatore, selezionare l'operatore da utilizzare nella soglia della condizione. Vedere Operatori di predicato.
      • Per Valore, immettere il valore da utilizzare per la soglia della condizione. Per gli operatori tra e esterno, immettere entrambi i valori per l'intervallo.
      • Per Minuti di ritardo trigger, immettere il numero di minuti durante i quali la condizione deve essere gestita prima dell'impostazione dello stato di attivazione dell'allarme.
      • Per Severità allarme, selezionare il tipo di risposta percepita richiesto quando l'allarme è in stato di attivazione per questa condizione (regola di attivazione).
      • Per Corpo dell'allarme, immettere il contenuto leggibile dalla persona della notifica per questa condizione (regola trigger).

        Si consiglia di fornire indicazioni agli operatori per la risoluzione della condizione di allarme. Prendere in considerazione l'aggiunta di collegamenti alle procedure di runbook standard. Esempio: avviso di uso elevato della CPU. Segui le istruzioni del runbook per la risoluzione". Facoltativamente, inserire variabili dinamiche per visualizzare il valore dei parametri dei messaggi di allarme associati nei messaggi di allarme. Ad esempio, inserire {{query}} per eseguire il rendering del valore query.

      • Per aggiungere un'altra regola trigger (condizione), selezionare Regola trigger aggiuntiva.
    5. Per definire una regola di trigger (predicato) aggiornando l'espressione MQL, effettuare le operazioni riportate di seguito.
      1. Nella parte superiore della pagina Modifica allarme selezionare Passa alla modalità avanzata.
      2. Fornire i valori riportati di seguito.
        • Per Minuti di ritardo trigger, immettere il numero di minuti durante i quali la condizione deve essere gestita prima dell'impostazione dello stato di attivazione dell'allarme.
        • Per Severità allarme, selezionare il tipo di risposta percepita richiesto quando l'allarme è in stato di attivazione per questa condizione (regola di attivazione).
        • Per l'editor di codice query modificare la query MQL per specificare la regola trigger desiderata.

          La regola di trigger è l'operatore e il frammento di valore nella query MQL. Ad esempio, il frammento > 90 rappresenta l'operatore maggiore di quello e un valore 90. Query MQL di esempio:

          CpuUtilization[5m].Mean() > 90

          Per ulteriori informazioni, vedere Esecuzione di query sui dati delle metriche e Controllo del riferimento MQL (Monitoring Query Language).

        • Per Corpo dell'allarme, immettere il contenuto leggibile dalla persona della notifica per questa condizione (regola trigger).
        • Per aggiungere un'altra regola trigger (condizione), selezionare Regola trigger aggiuntiva.
    6. Aggiornare eventuali altri valori per l'allarme, se necessario.
      Per ulteriori informazioni sui campi, vedere Creazione di un allarme di base.
    7. Selezionare Salva allarme.

  • Utilizzare il comando oci monitoring alert update e i parametri necessari per aggiornare le regole di trigger in un allarme. Una regola di trigger fa parte dell'espressione MQL o della query.

    Per un allarme con una regola, utilizzare il parametro --query-text. Esempio di aggiornamento della regola trigger a un valore maggiore del 90% (>90):

    oci monitoring alarm update --query-text "CPUUtilization[1m].mean()>90" [...]

    Per un allarme con più regole, utilizzare il parametro --overrides. Esempio:

    oci monitoring alarm update --overrides <json_file_path> [...]
    File JSON di esempio per la richiesta (allarme con più regole di trigger)
    {
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

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

  • Eseguire l'operazione UpdateAlarm per aggiornare un allarme. Una regola di trigger fa parte dell'espressione MQL in un attributo query.

    Fornire le regole di trigger utilizzando UpdateAlarmDetails. Per un allarme con una regola (nessun valore overrides), utilizzare l'attributo query. Per un allarme con più regole, utilizzare l'attributo overrides.