Warnungen konfigurieren

  • 6 Minuten

Azure Cosmos DB verwendet den Azure Monitor-Dienst zum Einrichten und Senden von Warnungen. Warnungen überwachen die Verfügbarkeit und Reaktionsfähigkeit von Azure Cosmos DB-Ressourcen und senden Benachrichtigungen, wenn überwachte Metriken die angegebenen Schwellenwerte erreichen. Warnungen können in Form von E-Mails erfolgen oder sogar Azure Functions ausführen, wenn sie ausgelöst werden. Warnungen überwachen auch die Aktivitätsprotokollereignisse Ihres Azure Cosmos DB-Kontos.

Warnungen können entweder auf der Seite für Ihr Azure Cosmos DB-Konto oder in Azure Monitor eingerichtet werden. An beiden Stellen werden die Warnungen auf ähnliche Weise eingerichtet.

Einrichten einer Warnung

Sehen wir uns ein Beispiel für das Festlegen von Warnungen an, wenn mehr als eintausend429 Ausnahmen innerhalb von 15 Minuten ausgelöst werden. Die Warnung soll alle 5 Minuten überprüfen, ob die Bedingung erfüllt ist. Wenn die Bedingung erfüllt ist, soll eine E-Mail an admins@contoso.com gesendet werden.

  1. Wählen Sie auf der Seite für Ihr Azure Cosmos DB-Konto im Abschnitt Überwachung die Option Warnungen aus.

  2. Wählen Sie + Erstellen und dann Warnungsregel aus,um eine neue Warnung zu erstellen. Ihr aktuelles Azure Cosmos DB-Konto, das Abonnement und die Ressourcengruppe sollten bereits ausgewählt sein.

  3. Wählen Sie Bedingung hinzufügen aus. Diese Bedingung definiert den Trigger für diese Warnung.

    1. Jetzt sollte der Signaltyp ausgewählt werden. Signale sind entweder Metriken oder Aktivitätsprotokolle. Da 429-Ausnahmen auftreten können, wenn Anforderungen gestellt werden, suchen Sie nach dem Signal für die Gesamtzahl der Anforderungseinheiten. Daraufhin sollte ein Diagramm angezeigt werden, das die Gesamtzahl der Anforderungseinheiten in den letzten 6 Stunden anzeigt.

    2. Wenn Sie eine Warnungslogik hinzufügen,wird diese derzeit für alle Anforderungseinheiten dieses Kontos gemessen. Sie müssen daher eine Bedingung für die Anforderungen erstellen, die den Statuscode 429 zurückgegeben haben. Um den betreffenden Filter zu erstellen, nehmen Sie unter Nach Dimension teilen folgende Auswahl vor:

      1. Wählen Sie StatusCode im Pulldownmenü StatusCode aus.

      2. Wählen Sie = unter = aus.

      3. Wenn innerhalb der letzten 6 Stunden eine 429-Ausnahme aufgetreten ist, wird sie unter den Optionen für Dimensionswerte angezeigt. Wenn 429 nicht als Option unter Dimensionswerte verfügbar ist,wählen Sie Benutzerdefinierten Wert hinzufügen aus, und fügen Sie den Wert 429 hinzu. Sie können weitere Filter wie Datenbank, Sammlung, Region oder Vorgangstyp hinzufügen, wenn Sie einen noch präziseren Filter benötigen.

    3. Legen Sie den Schwellenwert für die Warnungslogik auf 1000 fest.

    4. Legen Sie unter Auswertung basierend auf die Aggregationsgranularität (Zeitraum) auf 15 Minuten und die Häufigkeit der Auswertung auf 5 Minuten fest.

    5. Wählen Sie Fertig aus, um die Einrichtung der Bedingung abzuschließen.

  4. Die Warnung muss wissen, welche Aktion durchgeführt werden soll, wenn die Bedingung erfüllt ist. Lassen Sie uns eine E-Mail senden. Wählen Sie Aktionsgruppe hinzufügen unter Aktionen aus.

    1. Wenn Sie bereits Aktionen erstellt haben, können Sie diese wiederverwenden. Wir erstellen eine neue Aktion und wählen + Aktionsgruppe erstellen aus.

    2. Gehen Sie auf der Registerkarte Basic folgendermaßen vor:

      1. Weisen Sie der Aktionsgruppe einen Namen zu.

      2. Ändern Sie ggf. den Anzeigenamen.

    3. Gehen auf die Registerkarte Benachrichtigung folgendermaßen vor:

      1. Wählen Sie E-Mail/SMS-Nachricht/Pushnachricht/Sprachnachricht unter Benachrichtigungstyp aus.

      2. Weisen Sie der Benachrichtigung einen Namen zu.

      3. Wählen Sie das Stiftsymbol aus, um den Benachrichtigungsempfänger hinzuzufügen.

        1. Aktivieren Sie das Kontrollkästchen E-Mail.

        2. Legen Sie E-Mail auf admins@contoso.com fest, und klicken Sie auf OK.

    4. Klicken Sie auf Überprüfen und erstellen und dann auf Erstellen.

  5. Abschließend müssen wir die allgemeinen Informationen der Warnung in den Warnungsregeldetails ausfüllen. Sie können alle vorab ausgewählten Optionen je nach Bedarf ändern. Sie müssen aber zumindest den Namen der Warnungsregel festlegen. Weisen Sie der Warnung daher einen Namen zu.

  6. Klicken Sie auf die Schaltfläche Warnungsregel erstellen, um die Warnung zu erstellen.

Nachdem die Warnung erstellt wurde, kann die Aktivierung der Warnung bis zu 10 Minuten dauern.

Häufige Warnungsszenarien

Es folgen einige Szenarien, in denen Sie Warnungen verwenden können:

  • Wenn die Schlüssel eines Azure Cosmos-Kontos aktualisiert werden.
  • Wenn die Daten- oder Indexnutzung eines Containers, einer Datenbank oder einer Region eine bestimmte Anzahl von Bytes überschreitet.
  • Wenn der normalisierte RU/s-Verbrauch höher als ein bestimmter Prozentsatz ist.
  • Wenn eine Region hinzugefügt, entfernt oder offline geschaltet wird.
  • Wenn eine Datenbank oder ein Container erstellt, gelöscht oder aktualisiert wird.
  • Wenn der Durchsatz der Datenbank oder des Containers geändert wird.