Documentazione dell'infrastruttura Oracle Cloud

Utilizzo di variabili dinamiche nei messaggi di allarme

Aggiornare un allarme in Monitoraggio per includere i valori dei parametri dei messaggi di allarme nei messaggi.

Vedere anche Creazione di un allarme di base.

Modalità di rendering delle variabili dinamiche

Nota

Inserire variabili dinamiche che rispettano la lunghezza massima per tutti i casi d'uso supportati. Le variabili dinamiche che superano il numero massimo vengono considerate non valide. Ad esempio, considerare una variabile dinamica da utilizzare in title. Un caso d'uso supportato per title è una riga dell'oggetto e-mail con una lunghezza massima di 250 caratteri. In questo caso, la variabile dinamica per un nome risorsa ({{dimensions.<dimension-name>}}) non è valida perché è composta da 256 caratteri e quindi supera il valore massimo.

Il valore di un parametro del messaggio di allarme viene visualizzato in un messaggio di allarme quando si inserisce la variabile dinamica associata nei campi supportati. Ad esempio, immettere quanto segue come corpo dell'allarme:

{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

Nella seguente immagine di un messaggio di allarme, il corpo dell'allarme (Corpo) viene visualizzato come: Allarme CRITICO attivato perché la soglia è stata violata a causa di [CpuUtilization[1m].mean():92] all'indirizzo 2023-08-15T19:51:00Z

Esempio di variabili dinamiche visualizzate in un messaggio e-mail formattato.

Le variabili dinamiche vengono visualizzate nelle notifiche contenenti elementi del corpo.

  • Se i dati sono disponibili per una variabile dinamica, la variabile viene risolta e i dati vengono visualizzati al suo posto. Il messaggio di allarme di esempio precedente mostra [CpuUtilization[1m].mean():92] al posto della variabile dinamica {{metricValues}}.
  • Se non sono disponibili dati per una variabile dinamica, la variabile non viene risolta e viene visualizzata come codificata. Ad esempio, se non sono disponibili valori di metrica per la variabile dinamica {{metricValues}}, ad esempio quando l'allarme si trova nello stato OK, la variabile dinamica {{metricValues}} viene visualizzata nel messaggio di allarme.
  • I messaggi SMS mancano di elementi del corpo, quindi le variabili dinamiche non vengono risolte.

Ricerca di variabili dinamiche

Per cercare una variabile dinamica per un parametro, vedere Variabili dinamiche.

    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. Nella pagina Modifica allarme, individuare il campo a cui si desidera aggiungere variabili dinamiche.
      • Corpo dell'allarme (parametro del messaggio di allarme body): visualizzato come campo all'interno del corpo del messaggio di allarme.
      • Riepilogo allarme (parametro del messaggio di allarme alarmSummary): visualizzato come campo all'interno del corpo del messaggio di allarme.
      • Oggetto notifica (parametro del messaggio di allarme title): il rendering dipende dal tipo di messaggio. Per un messaggio e-mail formattato, viene visualizzato come riga dell'oggetto. Per un messaggio Slack, viene visualizzato come titolo. Per un messaggio SMS, viene visualizzato come parte del messaggio.
        Nota

        Inserire variabili dinamiche che rispettano la lunghezza massima per tutti i casi d'uso supportati. Le variabili dinamiche che superano il numero massimo vengono considerate non valide. Ad esempio, considerare una variabile dinamica da utilizzare in title. Un caso d'uso supportato per title è una riga dell'oggetto e-mail con una lunghezza massima di 250 caratteri. In questo caso, la variabile dinamica per un nome risorsa ({{dimensions.<dimension-name>}}) non è valida perché è composta da 256 caratteri e quindi supera il valore massimo.

      Per informazioni sull'aspetto predefinito di questi parametri dei messaggi di allarme nei messaggi formattati, vedere Formato messaggio di allarme.

    4. Inserire le variabili dinamiche per i parametri dei messaggi di allarme desiderati.

      Esempio con variabili dinamiche:

      {{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

      Per cercare le variabili dinamiche per un parametro, vedere Variabili dinamiche.

      È possibile disabilitare l'escape HTML utilizzando la variabile dinamica più lunga per un parametro di allarme. Ad esempio, per eseguire il rendering del valore del parametro query nel messaggio di allarme con escape HTML disabilitato, immettere la variabile dinamica {{{query}}}.

    5. Selezionare Salva allarme.

  • Utilizzare il comando oci monitoring alert update e i parametri necessari per aggiornare un allarme in modo da utilizzare variabili dinamiche nel campo desiderato:

    oci monitoring alarm update --alarm-summary <text-including-dynamic-variables> --body <text-including-dynamic-variables> --notification-title <text-including-dynamic-variables> [...]

    Con interruzioni di riga:

    oci monitoring alarm update 
--alarm-summary <text-including-dynamic-variables> 
--body <text-including-dynamic-variables> 
--notification-title <text-including-dynamic-variables> [...]

    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 e utilizzare l'opzione di formato messaggio desiderata.

    Durante la definizione dei dettagli per UpdateAlarmDetails, impostare il campo desiderato (alarmSummary, body o notificationTitle) sul testo desiderato, incluse le variabili dinamiche.