Verwendung des Überwachungs-Stacks

Überwachen Sie die Automation Suite mit Prometheus, Grafana und Alert Manager in EKS/AKS.

Der Überwachungs-Stack für Automation Suite -Cluster umfasst Prometheus, Grafana und Alertmanager, die automatisch installiert werden, es sei denn, Sie bringen Ihren eigenen Überwachungs-Stack mit.

Auf dieser Seite wird eine Reihe von Überwachungsszenarien beschrieben, die für die Arbeit mit dem Überwachungstool optimiert wurden, das im Automation Suite -Cluster enthalten ist. Wenn Sie Ihren eigenen Überwachungs-Stack mitbringen, müssen Sie die offizielle Dokumentation Ihrer Tools befolgen, um den Zustand des Clusters zu überwachen.

Wichtig:

Wenn Sie Sammler zum Exportieren von Metriken in Tools von Drittanbietern verwenden, kann die Aktivierung der Anwendungsüberwachung die Funktionalität der Automation Suite beeinträchtigen.

Zugreifen auf die Überwachungstools

Überblick

Der Überwachungs-Stack für Automation Suite -Cluster umfasst Prometheus, Grafana und Alert Manager.

Sie können über die folgenden URLs einzeln auf die Automation Suite Überwachungstools zugreifen:

Anwendung	Tool	URL	Beispiel
Metriken	Prometheus	https://monitoring.fqdn/metrics	https://monitoring.automationsuite.mycompany.com/metrics
Dashboard	Grafana	https://monitoring.fqdn/grafana	https://monitoring.automationsuite.mycompany.com/grafana
Alert Management	Alertmanager	https://monitoring.fqdn/alertmanager	https://monitoring.automationsuite.mycompany.com/alertmanager

Authentifizierung des Überwachungstools

To access the monitoring tools for the first time, follow the instructions in Accessing Automation Suite.

Ü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.

  Die folgende Abbildung zeigt die Registerkarte Prometheus-Warnungen mit aktuell ausgelösten Warnungen.

  

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 Dashboard Monitoring angezeigt oder einem der konfigurierten Empfänger gemeldet werden.

Konfigurieren von Warnungen

Hinweis:

Before starting configuring the alerts, make sure to enable kubectl.

Hinzufügen einer neuen E-Mail-Konfiguration

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 \
  --ASEA

In der folgenden Tabelle werden die verfügbaren Flags für den Befehl add-email beschrieben.

Markieren	Beschreibung	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
ASEA	Boolesches Flag zur Angabe, dass Sie die Automation Suite auf EKS oder AKS installiert haben.	Keine Angabe

Entfernen einer E-Mail-Konfiguration

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 --ASEA

Aktualisieren einer E-Mail-Konfiguration

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 --ASEA [additional_flags]

Zugriff auf das Grafana-Dashboard

Um auf Grafana-Dashboards zuzugreifen, müssen Sie Ihre Anmeldeinformationen abrufen und zur Anmeldung verwenden:

• Benutzername:

  kubectl -n monitoring get secrets/grafana-creds -o "jsonpath={.data.admin-user}" | base64 -d; echo
  

• Kennwort:

  kubectl -n monitoring get secrets/grafana-creds -o "jsonpath={.data.admin-password}" | base64 -d; echo
  

Überwachung persistenter Volumes

Sie können persistente Volumes über das Dashboard Kubernetes/Persistent Volumes überwachen. Sie können den freien und genutzten Platz für jedes Volume nachverfolgen.

Die folgende Abbildung zeigt das Dashboard für persistente Kubernetes-Volumes.

Sie können auch den Status jedes Volumes überprüfen, indem Sie das Element PersistentVolumes im Menü Storage des Cluster Explorer auswählen.

Überwachung der Hardwarenutzung

Um die Hardwarenutzung pro Knoten zu überprüfen, können Sie das Dashboard Knoten/Exporter/Knoten verwenden. Angaben zu CPU, Arbeitsspeicher, Datenträger und Netzwerk können angezeigt werden.

Sie können die Hardwarenutzung für bestimmte Workloads mithilfe des Dashboards Kubernetes / Compute Resources / Namespace (Workloads) überwachen. Wählen Sie den Namespace uipath aus, um die erforderlichen Daten abzurufen.

Erstellen einer gemeinsam nutzbaren visuellen Momentaufnahme eines Grafana-Diagramms

1. Wählen Sie die Menüschaltfläche neben dem Diagrammtitel und dann Share aus.
2. Wählen Sie die Registerkarte Snapshot aus und legen Sie den Namen für Momentaufnahme Snapshot name und das Ablaufdatum fest.
3. Wählen Sie Veröffentlichen in Snapshot.rainrain.io aus.

Weitere Informationen finden Sie in der Grafana-Dokumentation zum Freigeben von Dashboards.

Hinweis:

Diese Momentaufnahme ist für jeden mit dem Link im Internet öffentlich sichtbar.

Erstellen benutzerdefinierter persistenter Grafana-Dashboards

Hinweis:

Dashboards, die direkt in der Grafana-Benutzeroberfläche erstellt wurden, werden nicht über Pod- oder Knoten-Neustarts hinweg beibehalten. Vorgefertigte Dashboards sind nicht betroffen, da sie als ConfigMaps im Namespace monitoring gespeichert werden.

Um ein persistentes benutzerdefiniertes Dashboard zu erstellen, führen Sie folgende Schritte aus:

1. Erstellen Sie Ihr Dashboard in Grafana. Anweisungen finden Sie in der Grafana-Dokumentation.
2. Exportieren Sie das Dashboard als JSON-Datei.
3. Speichern Sie die folgende ConfigMap-Konfiguration als YAML-Datei und ersetzen Sie <dashboard-name> durch einen eindeutigen Namen und <dashboard-json> durch den Inhalt Ihrer exportierten JSON-Datei:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <dashboard-name>
     namespace: monitoring
     labels:
       grafana_dashboard: "1"
   data:
     dashboard.json: |
       <dashboard-json>
   

4. Wenden Sie die ConfigMap an:

   kubectl apply -f <file_name.yaml>
   

Grafana importiert das Dashboard automatisch, nachdem Sie die ConfigMap angewendet haben.

Überwachung temporärer als Service (TaaS)

TaaS-Server-Pods machen Prometheus-Metriken verfügbar. Wenn Prometheus in Ihrem Cluster aktiviert ist, werden Metriken automatisch aus den taas-temporal-* -Pods extrahiert.

In der folgenden Tabelle sind wichtige Metriken für die Überwachung des Zustands und der Leistung von TaaS aufgeführt.

Metrik	Beschreibung
temporal_activity_schedule_to_start_latency_bucket	Zeit zwischen der Planung einer Aktivität und deren Aufnahme durch eine Arbeitskraft. Hohe Werte deuten darauf hin, dass Arbeitskräfte Aufgaben nicht schnell genug bearbeiten können.
temporal_workflow_task_schedule_to_start_latency_bucket	Zeit zwischen der Planung einer Workflow-Aufgabe und dem Start durch eine Arbeitskraft. Hohe Werte deuten auf einen Warteschlangenrückstand hin.
temporal_workflow_completed	Anzahl der erfolgreich abgeschlossenen Workflow-Ausführungen.
temporal_workflow_failed	Anzahl der fehlgeschlagenen Workflowausführungen.
temporal_num_pollers	Anzahl der derzeit aktiven Arbeitsabrufer, aufgeschlüsselt nach Abruftyp.
temporal_request_latency_bucket	Latenz von gRPC-Client-Anforderungen an das TaaS-Frontend.

Zugriff auf die temporäre Benutzeroberfläche

Die temporäre Web-UI wird standardmäßig nicht außerhalb des Clusters verfügbar gemacht. Um zu Diagnosezwecken darauf zuzugreifen, leiten Sie den Port zur Bereitstellung weiter:

kubectl port-forward -n uipath deployment/taas-temporal-web 8008:8008

Öffnen Sie http://localhost:8008 in einem Browser. Beim Zugriff über die Portweiterleitung ist keine Anmeldung erforderlich.

Mit der temporären Benutzeroberfläche können Sie einzelne Workflow-Ausführungen überprüfen, den Ausführungsverlauf anzeigen und fehlgeschlagene oder Zeitüberschreitungen identifizieren.

Verfügbare Metriken

Sie können in der Prometheus-UI nach verfügbaren Metriken suchen.

Die Dokumentation zu den verfügbaren Metriken finden Sie hier:

• https://github.com/prometheus/node_exporter#enabled-by-default – Verbinden für Vorschau
• https://github.com/kubernetes/kube-state-metrics/tree/master/docs#exposed-metrics – Verbinden für Vorschau
• Abfragen von Metriken aus Prometheus (Istio)