Documentazione dell'infrastruttura Oracle Cloud

Personalizza il corpo dell'allarme

È possibile scrivere il corpo dell'allarme nella definizione dell'allarme utilizzando le variabili dinamiche dei dati delle metriche che hanno attivato l'allarme.

Per i dettagli e la procedura di personalizzazione del corpo dell'allarme, vedere il passo Riepilogo allarme in Creazione di un allarme di base.

Esempio: creare un URL nel corpo dell'allarme per visualizzare i record del log di attivazione dell'allarme in Log Explorer

Potrebbe essere necessario disporre di un URL significativo nel corpo dell'allarme per tornare a Log Explorer e visualizzare i record di registro che hanno attivato l'allarme. A tale scopo, passare un intervallo di tempo e alcuni filtri aggiuntivi. In genere, in questo flusso è necessario passare il nome etichetta. Inoltre, nell'esempio riportato di seguito, passeremo anche l'entità (mtgt).

  • Definizione regola di rilevamento:

    Prendere in considerazione la regola di rilevamento del tempo di inclusione con la configurazione seguente:

    • Nome della regola di rilevamento: http errors
    • La regola di rilevamento viene attivata quando trova almeno un record di log in un periodo di un minuto a cui è stata assegnata l'etichetta HTTP Error. L'assegnazione di questa etichetta viene eseguita automaticamente nella configurazione di arricchimento quando i dati vengono inclusi.
    • Quando è presente almeno 1 record di log corrispondente in un periodo di un minuto, una metrica http_errors nello spazio di nomi logging_analytics_test ottiene un nuovo valore.
    • Le dimensioni vengono aggiunte in base ai campi di log analizzati Entità e Indirizzo IP host (client).
    • Inoltre, le dimensioni vengono aggiunte automaticamente per l'etichetta (HTTP Error in questo caso) e l'OCID della regola di rilevamento. Queste sono dimensioni implicite.
  • Visualizzare le metriche generate dalla regola di rilevamento in Esplora metriche:
    Visualizzare le metriche generate dalla regola di rilevamento in Metrics Explorer

    Quando si esamina Metrics Explorer per la metrica errori HTTP, è possibile notare le informazioni riportate di seguito.

    In collaborazione con Log Explorer, tre datapoint con record di log 18, 3 e 4 corrispondono a questa etichetta.

    Vengono visualizzate le seguenti dimensioni. Si noti che Host IP Address (Client) non viene visualizzato perché i record di log che attivano gli allarmi non hanno un valore per quel campo.


    dimensioni metrica visualizzate

  • Personalizzare il corpo dell'allarme:

    Per i record di log che hanno attivato l'allarme, ecco i valori delle dimensioni:


    valori delle dimensioni della metrica

    L'esecuzione della query riportata di seguito consente di tornare a Log Explorer nel contesto; ad esempio, quando l'allarme viene attivato su 18 record di log corrispondenti (il primo datapoint in Metric Explorer):

    Label = 'HTTP Error' and Entity='mushop-ZKjW' | where Time > dateAdd(1708916460000, minute, -1) and Time < dateAdd(1708916460000, minute, 1) | timestats count as logrecords

    Qui i valori HTTP Error, mushop-ZKjW e 1708916460000 provengono dalle variabili di allarme. Nella query, cerchiamo l'ora un minuto prima e dopo l'ora di allarme. È possibile modificare questa impostazione nella query.

    Di seguito è riportato un esempio di contenuto del corpo dell'allarme che fornisce un collegamento nell'e-mail per tornare a questa vista:

    This alarm indicates that one or more HTTP Errors have occurred. You can see the original log records here:
https://cloud.oracle.com/loganalytics/explorer?region=us-phoenix-1&timeNum=1&timeUnit=week&filters=label__:__{{Dimensions.Label}}__;__entity__:__{{Dimensions.mtgt}}&query=* | where time > dateadd({{timestampEpochMillis}}, minute, -1) and time < dateadd{{timestampEpochMillis}}, minute, 1) | timestats count as logrecords

    Prima di generare la notifica di allarme, le variabili in {{}} vengono sostituite dal servizio di monitoraggio fornendo un testo del corpo dell'allarme risultante: 

    This alarm indicates that one or more HTTP Errors have occurred. You can see the original log records here:   
https://cloud.oracle.com/loganalytics/explorer?region=us-phoenix-1&timeNum=1&timeUnit=week&filters=label__:__HTTP Error__;__entity__:__mushop-ZKjW&query=* | where time > dateadd(1708916460000 , minute, -1) and time < dateadd(1708916460000, minute, 1) | timestats count as logrecords
  • Visualizzazione dei risultati in Log Explorer:

    Quando si fa clic sul collegamento nel messaggio di posta elettronica e dopo aver eseguito il login alla tenancy, viene visualizzato quanto riportato di seguito.


    Visualizza risultato in Log Explorer

Per i dettagli sui parametri URL di Log Explorer, vedere Parametri URL di Log Explorer.