Personalizzare il corpo dell'allarme

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

Per i dettagli e i passi per personalizzare il corpo dell'allarme, vedere il passo Riepilogo allarmi in Creazione di un allarme di base.

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

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

  • Definizione regola rilevamento:

    Prendere in considerazione la regola di rilevamento del tempo di inclusione che dispone della configurazione seguente:

    • Nome 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 integrazione quando i dati vengono inclusi.
    • Se in un periodo di un minuto è presente almeno 1 record di log corrispondente, 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 Metrics Explorer:
    Visualizzare le metriche generate dalla regola di rilevamento nell'Explorer metriche

    Quando si esamina l'explorer delle metriche per la metrica Errori HTTP, è possibile annotare 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 dimensioni riportate di seguito. Tenere presente che Host IP Address (Client) non viene visualizzato perché i record di log che attivano gli allarmi non hanno un valore per tale 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 seguente consente di tornare a Log Explorer nel contesto, ad esempio quando l'allarme viene attivato su 18 record di log corrispondenti (il primo datapoint di 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

    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 dell'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 di cui al punto {{}} 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
  • Visualizzare i risultati in Log Explorer:

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


    Visualizza i risultati in Log Explorer

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