Beispiel: URL im Alarmtext erstellen, um die Logdatensätze für die Alarmauslösung im Log Explorer anzuzeigen

Möglicherweise möchten Sie eine aussagekräftige URL im Alarmbody verwenden, um zum Log Explorer zurückzukehren und die Logdatensätze anzuzeigen, die den Alarm ausgelöst haben. Übergeben Sie dazu einen Zeitraum und einige zusätzliche Filter. In der Regel übergeben Sie in diesem Ablauf den Namen label. Außerdem übergeben wir im folgenden Beispiel die Entity (mtgt).

• Erkennungsregeldefinition:

  Beachten Sie die Erkennungsregel für die Aufnahmezeit mit der folgenden Konfiguration:

  • Erkennungsregelname: http errors
  • Die Erkennungsregel wird ausgelöst, wenn sie mindestens einen Logdatensatz in einem Zeitraum von einer Minute findet, dem das Label HTTP Error zugewiesen wurde. Die Zuweisung dieses Labels erfolgt automatisch in der Anreicherungskonfiguration, wenn die Daten aufgenommen werden.
  • Wenn in einem Zeitraum von einer Minute mindestens 1 übereinstimmender Logdatensatz vorhanden ist, erhält eine Metrik http_errors im Namespace logging_analytics_test einen neuen Wert.
  • Die Dimensionen werden basierend auf den geparsten Logfeldern Entity und Host-IP-Adresse (Client) hinzugefügt.
  • Außerdem werden die Dimensionen automatisch für das Label (in diesem Fall HTTP Error) und die Erkennungsregel-OCID hinzugefügt. Das sind implizite Dimensionen.
• Von Erkennungsregel generierte Metriken im Metrik-Explorer anzeigen:
  
  
  
  

  Wenn Sie im Metrik-Explorer nach der Metrik HTTP-Fehler suchen, können Sie die folgenden Informationen beachten:

  Im Log Explorer stimmen drei Datenpunkte mit den Logdatensätzen 18, 3 und 4 mit diesem Label überein.

  Die folgenden Dimensionen werden angezeigt. Beachten Sie, dass Host IP Address (Client) nicht angezeigt wird, weil die Logdatensätze, die die Alarme auslösen, keinen Wert für dieses Feld hatten.

  
  
  
  
  
• Alarmbody anpassen:

  Für die Logdatensätze, die den Alarm ausgelöst haben, sind hier die Werte der Dimensionen:

  
  
  
  
  

  Wenn Sie die folgende Abfrage ausführen, kehren Sie im Kontext zum Log Explorer zurück. Beispiel: Wenn der Alarm bei 18 übereinstimmenden Logdatensätzen (dem ersten Datenpunkt im Metrik-Explorer) ausgelöst wird:

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

  Hier stammen die Werte HTTP Error, mushop-ZKjW und 1708916460000 aus den Alarmvariablen. In der Abfrage suchen wir die Zeit eine Minute vor und nach der Alarmzeit. Sie können dies in der Abfrage anpassen.

  Hier ist ein Beispiel für den Inhalt des Alarmtextes, der Ihnen einen Link in Ihrer E-Mail gibt, um zu dieser Ansicht zurückzukehren:

  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

  Bevor die Alarmbenachrichtigung generiert wird, werden die Variablen in {{}} durch den Monitoring-Service ersetzt, indem ein resultierender Text für den Alarmbody angegeben wird:

  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

• Ergebnis im Log Explorer anzeigen:

  Wenn Sie in Ihrer E-Mail auf den Link klicken und sich bei Ihrem Mandanten anmelden, wird Folgendes angezeigt:

  
  
  
  
  

Die Details zu Log Explorer-URL-Parametern finden Sie unter Log Explorer-URL-Parameter.