Oracle Cloud Infrastructure - Dokumentation

Dynamische Variablen in Alarmmeldungen verwenden

Aktualisieren Sie einen Alarm in Monitoring, um Werte von Alarmmeldungsparametern in Nachrichten einzuschließen.

Siehe auch Einfachen Alarm erstellen.

Darstellung dynamischer Variablen

Hinweis

Fügen Sie dynamische Variablen ein, die für alle unterstützten Anwendungsfälle die maximale Länge einhalten. Dynamische Variablen, die das Maximum überschreiten, werden als ungültig betrachtet. Beispiel: Eine dynamische Variable zur Verwendung in title. Ein unterstützter Anwendungsfall für title ist eine E-Mail-Betreffzeile, die maximal 250 Zeichen lang ist. In diesem Fall ist die dynamische Variable für einen Ressourcennamen ({{dimensions.<dimension-name>}}) ungültig, weil sie 256 Zeichen enthält und somit das Maximum überschreitet.

Der Wert eines Alarmnachrichtenparameters wird in einer Alarmmeldung wiedergegeben, wenn Sie die zugehörige dynamische Variable in unterstützte Felder einfügen. Beispiel: Geben Sie Folgendes als Alarmbody ein:

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

Im folgenden Bild einer Alarmmeldung wird der Alarmbody (Body) wie folgt gerendert: Kritischer Alarm ausgelöst, weil der Schwellenwert aufgrund von [CpuUtilization[1m].mean():92] unter 2023-08-15T19:51:00Z verletzt wurde

Beispiel für dynamische Variablen, die in einer formatierten E-Mail-Nachricht gerendert werden.

Dynamische Variablen werden in Benachrichtigungen angezeigt, die Body-Elemente enthalten.

  • Wenn Daten für eine dynamische Variable verfügbar sind, wird die Variable aufgelöst, und die Daten werden an ihrer Stelle angezeigt. In der vorherigen Beispielalarmmeldung wird [CpuUtilization[1m].mean():92] anstelle der dynamischen Variable {{metricValues}} angezeigt.
  • Wenn keine Daten für eine dynamische Variable verfügbar sind, wird die Variable nicht aufgelöst und als codiert angezeigt. Beispiel: Wenn keine Metrikwerte für die dynamische Variable {{metricValues}} verfügbar sind, z.B. wenn sich der Alarm im OK-Status befindet, wird die dynamische Variable {{metricValues}} in der Alarmmeldung angezeigt.
  • SMS-Nachrichten enthalten keine Body-Elemente, sodass dynamische Variablen nicht berechnet werden.

Dynamische Variablen suchen

Informationen zum Suchen einer dynamischen Variable nach einem Parameter finden Sie unter Dynamische Variablen.

    1. Wählen Sie auf der Listenseite Alarmdefinitionen den Alarm, mit dem Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder des Alarms benötigen, finden Sie weitere Informationen unter Alarme auflisten.
    2. Gehen Sie zu Aktionen, und wählen Sie Alarm bearbeiten aus.
    3. Suchen Sie auf der Seite Alarm bearbeiten das Feld, dem Sie dynamische Variablen hinzufügen möchten.
      • Alarmtext (Alarmnachrichtenparameter body): Wird als Feld im Hauptteil der Alarmnachricht angezeigt.
      • Alarmübersicht (Alarmmeldungsparameter alarmSummary): Wird als Feld im Hauptteil der Alarmmeldung angezeigt.
      • Benachrichtigungsbetreff (Alarmnachrichtenparameter title): Das Rendering hängt vom Typ der Nachricht ab. Bei einer formatierten E-Mail-Nachricht wird sie als Betreffzeile angezeigt. Bei einer Slack-Nachricht wird der Titel wiedergegeben. Bei einer SMS-Nachricht wird sie als Teil der Nachricht angezeigt.
        Hinweis

        Fügen Sie dynamische Variablen ein, die für alle unterstützten Anwendungsfälle die maximale Länge einhalten. Dynamische Variablen, die das Maximum überschreiten, werden als ungültig betrachtet. Beispiel: Eine dynamische Variable zur Verwendung in title. Ein unterstützter Anwendungsfall für title ist eine E-Mail-Betreffzeile, die maximal 250 Zeichen lang ist. In diesem Fall ist die dynamische Variable für einen Ressourcennamen ({{dimensions.<dimension-name>}}) ungültig, weil sie 256 Zeichen enthält und somit das Maximum überschreitet.

      Informationen zur Standarddarstellung dieser Alarmnachrichtenparameter in formatierten Nachrichten finden Sie unter Alarmnachrichtenformat.

    4. Fügen Sie dynamische Variablen für die gewünschten Alarmnachrichtenparameter ein.

      Beispiel mit dynamischen Variablen:

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

      Informationen zum Suchen dynamischer Variablen für einen Parameter finden Sie unter Dynamische Variablen.

      Sie können HTML-Escaping deaktivieren, indem Sie die längere dynamische Variable für einen Alarmparameter verwenden. Beispiel: Um den Wert des Parameters query in der Alarmmeldung mit deaktivierter HTML-Escaping wiederzugeben, geben Sie die dynamische Variable {{{query}}} ein.

    5. Wählen Sie Alarm speichern aus.

  • Verwenden Sie den Befehl oci monitoring alarm update und den erforderlichen Parameter, um einen Alarm so zu aktualisieren, dass dynamische Variablen in dem Feld verwendet werden, das Sie möchten:

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

    Mit Zeilenumbrüchen:

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

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der Befehlszeilenreferenz für Monitoring.

  • Führen Sie den Vorgang UpdateAlarm aus, damit ein Alarm so aktualisiert wird, dass die gewünschte Option für das Nachrichtenformat verwendet wird.

    Wenn Sie Details für UpdateAlarmDetails definieren, legen Sie das gewünschte Feld (alarmSummary, body oder notificationTitle) auf den gewünschten Text fest, einschließlich dynamischer Variablen.