Warnungen

Sie müssen Warnungsempfänger konfigurieren, um Probleme zu vermeiden, die zu Ausfallzeiten führen können.

Konfigurieren von Warnungen

Hinweis:

Sie finden uipathctl im Automation Suite-Installationsordner: .../UiPathAutomationSuite/UiPath_Installer/bin

Bevor Sie mit dem Konfigurieren von Warnungen beginnen, stellen Sie sicher, dass Sie kubectl aktivieren.

Hinzufügen eines E-Mail-Empfängers

Um nach der Installation eine neue E-Mail-Konfiguration hinzuzufügen, führen Sie den folgenden Befehl aus:

./uipathctl config alerts add-email \
  --name test \
  --to "[e-mail]" \
  --from "[e-mail]" \
  --smtp server.mycompany.com \
  --username admin \
  --password somesecret \
  --require-tls \
  --ca-file <path_to_ca_file> \
  --cert-file <path_to_cert_file> \
  --key-file <path_to_key_file> \
  --send-resolved

Um E-Mail-Benachrichtigungen an mehrere Empfänger zu senden, können Sie mehrere E-Mail-Empfänger erstellen.

Markieren	Wert	Beispiel
name	Der Name der E-Mail-Konfiguration	testconfig
to	Die E-Mail-Adresse des Empfängers	[e-mail]
from	Die E-Mail-Adresse des Absenders.	[e-mail]
SMTP	SMTP-Server-URL oder IP-Adresse und Portnummer	server.mycompany.com:567
username	Benutzername für die Authentifizierung	admin
password	Authentifizierungskennwort	securepassword
require-tls	Boolesches Flag, das angibt, dass TLS auf dem SMTP-Server aktiviert ist.	Keine Angabe
ca-file	Dateipfad, der das Zertifikat der Zertifizierungsstelle des SMTP-Servers enthält. Dies ist optional, wenn die Zertifizierungsstelle privat ist.	./ca-file.crt
cert-file	Dateipfad, der das Zertifikat des SMTP-Servers enthält. Dies ist optional, wenn das Zertifikat privat ist.	./cert-file.crt
key-file	Dateipfad, der den privaten Schlüssel des Zertifikats des SMTP-Servers enthält. Dies ist erforderlich, wenn das Zertifikat privat ist.	./key-file.crt
send-resolved	Boolesches Flag, um eine E-Mail zu senden, sobald die Warnung beendet ist.	Keine Angabe

Entfernen eines E-Mail-Empfängers

Um eine E-Mail-Konfiguration zu entfernen, müssen Sie den folgenden Befehl ausführen. Stellen Sie sicher, dass Sie den Namen der E-Mail-Konfiguration übergeben, die Sie entfernen möchten.

./uipathctl config alerts remove-email --name test 

Aktualisieren eines E-Mail-Empfängers

Um eine E-Mail-Konfiguration zu aktualisieren, müssen Sie den folgenden Befehl ausführen. Stellen Sie sicher, dass Sie den Namen der E-Mail-Konfiguration, die Sie aktualisieren möchten, und die zusätzlichen optionalen Parameter, die Sie bearbeiten möchten, übergeben. Diese Parameter sind die gleichen wie beim Hinzufügen einer neuen E-Mail-Konfiguration. Sie können ein oder mehrere Flags gleichzeitig übergeben.

./uipathctl config alerts update-email --name test [additional_flags]

Hinzufügen von Webhooks zum Senden von Warnungen an externe Tools

Alert Manager-Konfigurationen werden in einem Geheimnis im Base64-kodierten Format gespeichert. Führen Sie die folgenden Schritte aus, um das Geheimnis zu aktualisieren:

1. Rufen Sie die vorhandene Alert Manager-Konfiguration in einer Datei mit dem Namen am_config.yaml ab.

   kubectl get secret alertmanager-config -n monitoring -o jsonpath="{.data.alertmanager\.yaml}" | base64 --decode > am_config.yaml 

2. Konfigurieren Sie Webhooks. Weitere Informationen finden Sie unter Konfiguration des Alert Manager-Webhooks.
3. Codieren Sie die Konfiguration im Base64-Format.

   openssl base64 -in am_config.yaml -out am_config_base64.yaml

4. Aktualisieren Sie das alertmanager.yaml-Attribut im Geheimnis. Ersetzen Sie die vorhandene Base64-codierte Zeichenfolge durch die in am_config_base64.yaml.
5. Überprüfen Sie, ob die Konfigurationen im Statusabschnitt im Alert Manager aktualisiert werden.

Weitere Informationen zur Fehlerbehebung finden Sie in den Alert Manager- und Prometheus Pod-Protokollen.

Testen von Warnungen

Führen Sie die folgenden Schritte aus, um die Warnungen zu testen:

1. Melden Sie sich beim Alert Manager an, indem Sie auf https://monitoring.fqdn/alertmanager zugreifen.
2. Kopieren Sie das Cookie _oauth2_proxy=<value>.
3. Erstellen Sie über Postman eine Testwarnung, wie im folgenden Beispiel gezeigt:

   Method: Post
   URL: https://monitoring.fqdn/alertmanager/api/v2/alerts
   Headers: 
   - Content-Type: application/json
   - Cookie: _oauth2_proxy=<value>
   Body: [{"labels":{"alertname":"Acme Alert", "severity":"warning"}}]

4. Sie sollten die Warnung nun im Alert Manager sehen.

Überprüfen aktuell ausgelöster Warnungen

Um die Warnungen anzuzeigen, navigieren Sie mit https://monitoring.fqdn/metrics zu Prometheus und wählen Sie die Registerkarte Warnungen aus. Hier sehen Sie alle in der Automation Suite konfigurierten Warnungen.

• Um die aktiven Warnungen anzuzeigen, filtern Sie den Warnungsstatus mithilfe des Kontrollkästchens Auslösen.

• Um weitere Details zu bestimmten Warnungen zu erhalten, erweitern Sie die Warnungen, die Sie anzeigen möchten.

Stummschalten von Warnungen

Wenn Warnungen zu laut sind, können Sie sie stumm schalten. Führen Sie dazu die folgenden Schritte aus:

1. Greifen Sie mit https://monitoring.fqdn/alertmanager auf den Alert Manager zu.
2. Suchen Sie die betreffende Warnung und wählen Sie Silence aus.
3. Geben Sie die Angaben zum Ersteller und zum Kommentar ein und wählen Sie Erstellen aus. Die Warnung sollte nicht mehr im Überwachungsdashboard angezeigt oder einem der konfigurierten Empfänger gemeldet werden.

Fehlerbehebung bei Warnungen

Wenn Sie Probleme mit der Konfiguration des Warnungsempfängers haben, überprüfen Sie die Protokolle, indem Sie den folgenden Befehl ausführen:

kubectl logs -n monitoring -l app.kubernetes.io/name=kube-prometheus-stack-prometheus-operator --tail=-1