10.2 System-Monitor & Protokolle — Systemüberwachung und Fehleranalyse

10.2 System-Monitor & Protokolle — Systemüberwachung und Fehleranalyse

Behalten Sie den Überblick über laufende Prozesse, Fehlerprotokolle, Benutzeraktivitäten und Performance-Indikatoren Ihres UDM-Systems.

Vorschau
1

Überblick

Hinweis: Der System-Monitor ist als Funktion vorgesehen, aktuell jedoch nur als Skelett implementiert. Beschriebene Auswertungen (Request-Monitor, Performance-KPIs) sind noch in Vorbereitung. Diese Anleitung beschreibt den Zielzustand.

Der System-Monitor zeigt den aktuellen Zustand des UDM-Systems: laufende Prozesse, Fehlerprotokolle, Benutzeraktivitäten und Performance-Indikatoren. Er ist das zentrale Werkzeug für Kundenadministratoren, um Probleme frühzeitig zu erkennen und gezielt zu analysieren.

Im Monitoring-Bereich finden Sie:

  • Request-Monitor — alle HTTP-Anfragen mit Zeitstempel, URL, Fehlerstatus und übertragenen Daten
  • Änderungsprotokoll — letzte Änderungen an Konfigurationsobjekten und Datenobjekten
  • Letzte Aktivitäten — kürzlich bearbeitete Container und Anforderungsmanagement-Einträge
Praxisszenario
Fehlerhafte Hintergrund-Jobs identifizieren

Ein automatischer Datenabgleich läuft seit heute Morgen nicht mehr korrekt. Im System-Monitor prüfen Sie, welche HTTP-Requests fehlgeschlagen sind, sehen die genauen Fehlerdetails ein und können die Ursache gezielt eingrenzen.

2

Schritt 1: System-Monitor öffnen

Navigieren Sie im UDM Admin Client zum Bereich „Monitoring“. Dieser befindet sich im Hauptmenü und bietet Zugang zum Dashboard mit aktuellen Systemdaten.

Im Dashboard sehen Sie auf einen Blick:

  • Kürzlich bearbeitete Container mit Zeitstempel
  • Aktuelle Einträge aus dem Anforderungsmanagement
  • Das Änderungsprotokoll mit den letzten Konfigurationseinträgen

Für den detaillierten Request-Monitor klicken Sie auf „System-Monitor“ in der Navigation.

AdminClient → Monitoring → Dashboard-Kennzahlen
Aktualisieren 🗑 RequestInfos leeren Online
CPU-Last
42 %
RAM
7,8 / 16 GB
DB-Verbindungen
23
Uptime
12 d 04:18
Fehler letzte 24 h
3
3

Schritt 2: Protokolle filtern

Im System-Monitor können Sie die angezeigten Einträge gezielt eingrenzen. Die wichtigsten Filterkriterien sind:

  1. Nach Zeitraum filtern

    Wählen Sie den gewünschten Zeitraum aus, um nur relevante Einträge anzuzeigen. Dies ist besonders nützlich, wenn Sie einen Fehler zu einem bestimmten Zeitpunkt eingrenzen möchten.

  2. Nach Typ filtern

    Schränken Sie die Anzeige auf bestimmte Protokolltypen ein — z. B. nur Fehler oder nur Job-Ausführungen.

  3. Nach Schweregrad filtern

    Konzentrieren Sie sich auf kritische Einträge, indem Sie nach Schweregrad sortieren oder filtern (z. B. nur „Error“-Einträge).

Tipp: Schnellfilter für Fehler Nutzen Sie die Spalte „Fehler“ im Request-Monitor, um direkt alle fehlgeschlagenen Requests zu identifizieren. Ein Klick auf die Spaltenüberschrift sortiert die Einträge nach Fehlerstatus.
4

Schritt 3: Fehlerdetails einsehen

Im Request-Monitor werden für jeden Eintrag die folgenden Informationen angezeigt:

Spalte Beschreibung
Zeit Zeitstempel der Anfrage (Datum und Uhrzeit)
URL Die aufgerufene API-Adresse bzw. der Endpunkt
Fehler Kennzeichnung, ob die Anfrage fehlgeschlagen ist
Daten gesendet Vorschau der gesendeten Daten (erste 200 Zeichen)
Daten erhalten Vorschau der empfangenen Antwort (erste 200 Zeichen)

Klicken Sie auf einen Eintrag, um die vollständigen Details einzusehen. Bei fehlgeschlagenen Requests finden Sie hier die genaue Fehlermeldung und können die gesendeten sowie empfangenen Daten analysieren.

Request-Monitor — aktuelle HTTP-Anfragen
ZeitURLStatusDaten gesendetDaten erhalten
10:42:18/api/Customers/GetOK62 B14 KB
10:42:09/api/Jobs/RunSync500120 B2 KB (Fehler)
10:41:55/api/Auth/LoginOK78 B1,2 KB
10:41:48/api/Datasource/Read408240 B0 B
10:41:30/api/Container/ListOK45 B8,4 KB
5

Schritt 4: Aktionen ergreifen

  1. Request-Daten aktualisieren

    Klicken Sie auf „RequestInfos aktualisieren“, um die aktuelle Liste der HTTP-Anfragen neu zu laden und den neuesten Stand zu sehen.

  2. Request-Daten leeren

    Mit „RequestInfos leeren“ setzen Sie den Monitor zurück. Dies ist hilfreich, wenn Sie gezielt einen neuen Vorgang beobachten möchten, ohne alte Einträge im Blick zu haben.

  3. Fehlerursache analysieren

    Prüfen Sie die URL und die gesendeten Daten bei fehlerhaften Requests. Häufige Ursachen sind: ungültige Parameter, fehlende Berechtigungen oder Verbindungsprobleme zum Server.

  4. Änderungsprotokoll prüfen

    Über das Änderungsprotokoll im Monitoring-Dashboard können Sie nachvollziehen, welche Konfigurationseinträge kürzlich geändert wurden — hilfreich, um Fehler nach einer Änderung einzugrenzen.

6

Protokolltypen im Überblick

Typ Beschreibung Typische Verwendung
Info Allgemeine Informationsmeldungen über erfolgreiche Vorgänge Bestätigung abgeschlossener Importe, erfolgreiche Konfiguration
Warning Warnhinweise, die auf mögliche Probleme hindeuten Lange Antwortzeiten, veraltete Konfigurationen, fehlende optionale Felder
Error Fehlermeldungen bei fehlgeschlagenen Operationen Fehlgeschlagene API-Aufrufe, Datenbankfehler, Berechtigungsprobleme
Job-Execution Protokolleinträge zu automatischen Hintergrund-Jobs Geplante Datenabgleiche, Report-Erzeugung, automatische Bereinigungen
User-Activity Protokollierung von Benutzeraktionen im System Anmeldungen, Konfigurationsänderungen, manuelle Dateneingriffe
Aufbewahrung von Protokolldaten Die Request-Daten im System-Monitor werden sitzungsbasiert gespeichert und stehen bis zum Leeren oder bis zum Ende der Sitzung zur Verfügung. Das Änderungsprotokoll wird dauerhaft in der Datenbank gespeichert und kann jederzeit eingesehen werden.
Tipp: Regelmäßige Prüfung Prüfen Sie den System-Monitor regelmäßig — idealerweise täglich — auf Fehlereinträge. So erkennen Sie Probleme frühzeitig, bevor sie sich auf die Benutzer auswirken.
7

Häufige Fragen

Frage Antwort
Wo finde ich den System-Monitor? Im UDM Admin Client unter „Monitoring“ im Hauptmenü. Der Request-Monitor ist dort als eigene Seite verfügbar.
Werden die Protokolldaten automatisch gelöscht? Die Request-Daten werden sitzungsbasiert gehalten. Das Änderungsprotokoll bleibt dauerhaft gespeichert. Sie können die Request-Daten jederzeit manuell leeren.
Kann ich Protokolle exportieren? Die angezeigten Daten können über die Standard-Exportfunktionen der Datentabelle (z. B. als Excel) exportiert werden.
Was bedeutet „Fehler“ in der Request-Tabelle? Ein als Fehler markierter Eintrag zeigt an, dass die HTTP-Anfrage an den Server fehlgeschlagen ist oder eine Fehlermeldung zurückgegeben wurde. Die Details finden Sie in den Spalten „Daten gesendet“ und „Daten erhalten“.
Wer hat Zugriff auf den System-Monitor? Der System-Monitor steht ausschließlich Administratoren im UDM Admin Client zur Verfügung. Endanwender haben keinen Zugriff auf diese Funktion.
Wie kann ich einen konkreten Fehler nachstellen? Leeren Sie zunächst die Request-Daten, führen Sie dann den problematischen Vorgang erneut durch und prüfen Sie anschließend die neuen Einträge im Monitor.