Zentralisierte Protokolle

Inhaltsverzeichnis

1 Zentralisierte Protokolle

Die Datenbank zentralisierter Protokolle enthält Protokollmeldungen, die von Genesys-Anwendungen generiert werden. Das Plug-in Zentralisiertes Protokoll für Genesys Administrator Extension zeigt eine Zusammenfassung diese Protokolle an. In dieser können Sie Protokolle auswählen und untersuchen, die von besonderem Interesse sind. Wie bei allen Objekten in GAX werden für Sie nur die Protokolle angezeigt, für die Sie über die erforderlichen Berechtigungen verfügen.

Wichtig

Die Datenbank der zentralen Protokolle unterstützt nur Oracle-, Microsoft- und PostgreSQL-DBMS; IBM DB2 wird nicht unterstützt.

In der Datenbank zentralisierter Protokolle werden zwei Typen von Protokollmeldungen gespeichert:

Anwendungsprotokolle: Diese von den meisten Genesys-Anwendungen generierten Protokolle weisen das gleiche einheitliche Protokolldatensatz-Format auf.
Überwachungsprotokolle: Diese Protokolle werden nur von wenigen Anwendungen (insbesondere Configuration Server und Solution Control Server) generiert. Sie enthalten zusätzliche Attribute und Informationen über Konfigurationsänderungen sowie Steuerungsaktionen für Prozesse, Lösungen und Alarme.

Um das zentralisierte Protokoll anzuzeigen, wählen Sie in der GAX-Menüleiste Zentralisierte Protokolle aus.

Fenster "Zentralisiertes Protokoll"

Im Fenster "Zentralisiertes Protokoll" werden Protokolleinträge angezeigt.

Im Fenster werden im Menü auf der linken Seite die verfügbaren Ansichten angezeigt, einschließlich "Gespeicherte Suchen".

Wichtig

Überwachungsprotokolle werden nur in der Ansicht "Überwachen" sowie in den Ergebnisse von Suchvorgängen angezeigt, für die das Kriterium Typ auf Überwachen festgelegt ist.

Oberhalb der Liste der Protokolle werden die folgenden Informationen und Steuerelemente angezeigt:

Die Anzahl der abgerufenen Protokolle und die Gesamtzahl der abzurufenden Protokolle. Um Verzögerungen zu minimieren, die durch das Abrufen aller Datensätze aus einer Protokolldatenbank mit einer hohen Anzahl von Datensätzen verursacht, werden die Datensätze in Stapeln aus der Datenbank abgerufen (die Standardstapelgröße ist 100). Nach einem Bildlauf durch die Hälfte der vorhandenen Liste werden weitere Datensätze abgerufen. Zum Verbessern der Leistung wird außerdem die Anzahl der Datensätze, die angezeigt werden können, beschränkt (die Standardanzahl von Datensätzen beträgt 5000). Wenn diese Parameter für Sie nicht geeignet sind, können sie Sie mithilfe der Optionen minlogs und maxlogs ändern. Siehe den "clog-Abschnitt" im Genesys Administrator Extension Deployment Guide.
Protokolle in der Liste werden anhand von Suchkriterien ausgewählt. Standardmäßig werden nur am aktuellen Tag (Datumsbereich: Today) generierte Protokolle ausgewählt. Weitere Informationen zum Auswählen von Protokollen mithilfe von Filtern finden Sie unter Filtern von Protokollen.
Vier Steuerelement-Symbole:
- Öffnet das Suchfenster, in dem Sie Filter festlegen können, um die Liste der Protokolle zu erstellen, an denen Sie interessiert sind, oder die Liste auf eine Größe zu reduzieren, die sich besser handhaben lässt.
- Entfernt ausgewählte Protokolle aus der Liste. Aktivieren Sie das Kontrollkästchen in der ersten Spalte, um ein Protokoll zum Löschen auszuwählen. Aktivieren Sie so viele Kontrollkästchen wie erforderlich oder aktivieren Sie das Kontrollkästchen in der Kopfzeile, um alle angezeigten Datensätze auszuwählen.
  Warnung
  Wenn Sie das Kontrollkästchen in der Kopfzeile auswählen, werden Sie außerdem aufgefordert, alle Datensätze in der Datenbank (nicht nur die angezeigten Datensätze) auszuwählen, die die gleichen Kriterien wie die angezeigten Datensätze erfüllen. Wählen Sie diese Option NUR aus, wenn Sie sich sicher sind, dass Sie alle Datensätze in der Datenbank, die diese Kriterien erfüllen, zum Löschen auswählen möchten.
- Hiermit können Sie festlegen, welche Spalten (Attribute) in der Liste angezeigt werden sollen.
- Aktualisiert die Anzeige.
Feld "Schnellfilter": Geben Sie Text in dieses Feld ein, um bestimmte Protokolle zu suchen, ohne die vollständige Filterfunktion zu verwenden. Die Protokolle, die diesen Text (einschließlich Zahlen, z. B. die Protokoll-ID) enthalten, werden zurückgegeben und aufgelistet. Bei diesem Filter wird die Groß-/Kleinschreibung nicht berücksichtigt, und er ist kumulativ. Das heißt, die Abfrage wird ausgewertet und ausgeführt, und während der Eingabe der einzelnen Zeichen wird die Liste der Ergebnisse aktualisiert. Geben Sie für optimale Ergebnisse möglichst viele Zeichen ein.

Jeder Protokolldatensatz wird mit einigen oder allen Attributen angezeigt:

Ebene—Die Protokollebene, also Alarm, Standard, Interaktion oder Verfolgung.
ID—Die eindeutige Kennung des Protokolls, im Format <Application id>-<message ID>. Dabei ist <Application ID> die Anwendungs-ID der Anwendung, die das Protokoll generiert hat, und <message ID> die numerische ID der Protokollmeldung, die innerhalb der Komponente, die das Protokoll generiert hat, eindeutig ist.
Beschreibung—Der Text der Protokollmeldung.
Host—Der Host, auf dem die Anwendung, die das Protokoll generiert hat, ausgeführt wurde.
App—Der Name der Anwendung, die das Protokoll generiert hat.
Datum—Das Datum und die Uhrzeit der Protokollgenerierung.
Interaktions-ID—Der Bezeichner der Interaktion, für die das Protokoll generiert wurde. Dieses Attribut wird nur für Protokolle auf Interaktionsebene angezeigt.

Sie können auch auf klicken und anpassen, welche Attribute (Spalten) angezeigt werden; standardmäßig werden alle Spalten angezeigt.

Welche Attribute angezeigt werden, hängt von der Auswahl ab, die Sie im Menü auf der linken Seite des Fensters vorgenommen haben, sowie von den Attributen, die Sie für die Anzeige ausgewählt haben. Zum Beispiel wird das Attribut Ebene nicht angezeigt, wenn Sie ausgewählt haben, dass nur Protokolle der Standardebene angezeigt werden.

Klicken Sie auf die Zeile eines Protokolls, um zusätzliche Attribute anzuzeigen.

Anzeigen von Protokollen

Im Fenster "Zentralisiertes Protokoll" können Sie folgende Aktionen ausführen:

Anzeigen aller Protokolle vom Typ "Anwendung", indem Sie im linken Menü unter Anwendungen die Option Alle Protokolle auswählen.
Alle Protokolle einer bestimmten Ebene, indem Sie unter Anwendungen die entsprechende Ebene auswählen. Um z. B. alle Anwendungsprotokolle der Standardebene anzuzeigen, wählen Sie unter Anwendungen die Option Standard aus.
Um alle Überwachungsprotokolle anzuzeigen, wählen Sie im linken Menü unter Anwendungen die Option Alle Protokolle aus.
Um alle Protokolle anzuzeigen, welche die in einer gespeicherten Suche definierten Kriterien erfüllen, wählen Sie im linken Menü unter GESPEICHERTE SUCHEN den Namen der Suche aus.
Zum Erstellen einer neuen Suche für alle Protokolle, die angegebene Kriterien erfüllen, filtern Sie die Protokolle nach den angegebenen Kriterien.

Standardmäßig werden die Protokolle sortiert nach dem Attribut Datum angezeigt. Sie können sie auch nach ihrer Ebene, ihrer ID, ihrer Beschreibung, ihrem Host, ihrer App und nach dem Datum (und der Uhrzeit) ihrer Generierung sortieren. Klicken Sie auf eine Kopfzeilenzelle, um die Liste nach dem entsprechenden Attribut zu sortieren und/oder Reihenfolge der Liste (aufsteigend oder absteigend) zu ändern.

Suchen nach Protokollen

Sie können nach bestimmten Protokollen suchen, indem Sie eine Liste von Protokollen nach einem oder mehreren Suchkriterien filtern. Klicken Sie auf um das Filterfenster zu öffnen. In diesem Fenster können Sie eine einfache Suche oder eine erweiterte Suche ausführen:

Einfache Suche—Ermöglicht es Ihnen, mit einem einfachen Satz von Kriterien eine Teilmenge der Protokolle anzuzeigen.
Erweiterte Suche—Mit bestimmten Berechtigungen können Sie die Liste nach zusätzliche Kriterien filtern, die Suchen speichern, die Liste der gespeicherten Suchen verwalten und einige oder alle Protokolle entfernen.

Klicken Sie auf Speichern unter, um bis zu 10 definierte Suche für eine spätere Verwendung zu speichern. Wenn Sie eine neue Suche speichern möchten, jedoch bereits 10 Suchen gespeichert sind, müssen Sie eine der vorhandenen Suchen löschen (klicken Sie auf das x, das angezeigt wird, wenn Sie die Maus auf den Namen der Suche halten), bevor Sie die neue Suche speichern können. Sie können auch die Namen der Suchen nach oben oder unten ziehen, um die Sortierung der Liste zu ändern.

Tipp

Stellen Sie vor dem Starten der Suche sicher, dass alle Protokolldatensätze aus der Datenbank abgerufen wurden.—Überprüfen Sie die Anzahl die Datensätze in der oberen rechten Ecke des Fensters „Zentralisiertes Protokoll“.
Wenn Sie lediglich Protokolldatensätze, die einen bestimmten Text enthalten, oder einen Protokolldatensatz mit einer eindeutigen ID suchen möchten, erhalten Sie mit hoher Wahrscheinlichkeit die gleichen Ergebnisse wie mit einer einfachen oder erweiterten Suche, wenn Sie den Text in das Feld „Tabelle filtern“ oben links im Fenster eingeben.

Einfache Suche

In einer einfachen Suche können Sie Protokolle nach Host, Anwendung, Mandant, Benutzer, Datum und/oder Beschreibung filtern.

Beachten Sie Folgendes, wenn Sie eine einfache Suche durchführen:

Sie können für jedes Attribut nur einen Filterwert eingeben.
Die Filter Host, Anwendung, Mandant und Benutzer enthalten für jeden Protokolldatensatz in der ursprünglichen Liste Dropdown-Listen mit den Werten des entsprechenden Attributs.
Der Filter Datum enthält die folgenden acht vordefinierten Filterwerte:
- Letzte 5 Minuten
- Letzte 15 Minuten
- Letzte Stunde
- Heute
- Gestern—Der aktuelle und der vorherige Tag
- Letzte 5 Tage—Der aktuelle Tag und die letzten 5 Tage
- Letzte 30 Tage—Der aktuelle Tag und die letzten 30 Tage
Alle Tage beginnen um Mitternacht (00:00:00). Minuten- und Stundenintervalle werden ab dem Starten des Filters gemessen.

Sie können auch Benutzerdefinierter Datumsbereich wählen und in den daneben angezeigten Kalendern Datums- und Uhrzeitangaben für den Bereich auswählen.
Der Filter Beschreibung hat keine Dropdown-Liste. Geben Sie ggf. Text aus den Feldern für Host-Name, Anwendungsname oder Beschreibung des Protokolls ein. Dies unterscheidet sich etwas vom Feld Schnellfilter oberhalb der Datensatzliste, da mit diesem Feld nur nach übereinstimmendem Text in den drei Attributen gesucht wird. Es kann daher nicht für die Suche nach einem Protokoll mit einer angegebenen Nummer verwendet werden.

Wählen Sie zum Filtern der Protokolle einen Wert für ein oder mehrere Suchkriterien aus und klicken Sie auf Suchen. Die Protokolle, die den angegebenen Kriterien entsprechen, werden aufgelistet.

Erweiterte Suche

Um den Filter "Erweiterte Suche" zu verwenden, benötigen Sie die Berechtigung ACCESS_CLOGS. Dieser erweiterte Filter bietet Ihnen mehr Suchkriterien, und wenn Sie über die Berechtigung DELETE_CLOGS verfügen, können Sie auch einige oder alle von der Abfrage zurückgegebenen Protokolldatensätze aus der Datenbank der zentralisierten Protokolle löschen.

Um einen erweiterten Filter zu definieren, geben Sie zunächst Filterkriterien für eine einfache Suche ein. Klicken Sie dann auf den Pfeil neben "Erweiterte Suche". Das Fenster "Suchen" wird erweitert und zeigt die zusätzlichen Filter an, mit denen Sie Protokolle, suchen können, insbesondere die folgenden Filter:

Protokolltyp—Anwendung oder Überwachen
Protokollebene—Alarm, Standard, Interaktion oder Verfolgung
Der Name der Lösung, in der das Protokoll generiert wurde.
Typ und Name der Konfigurationsobjekte, die geändert wurden.
Schlüsselname und -wert der geänderten Attribute.

Um einen Wert aus einem Filter zu löschen, klicken Sie auf Zurücksetzen. Um alle Filter zu löschen, klicken Sie auf Alle Filter zurücksetzen. Um nur einige Schlüssel:Wert-Paare zu entfernen, die in den Filter Attribute eingegeben wurden, klicken Sie auf das daneben befindliche Symbol .

In der Liste der durch die erweiterte Suche zurückgegebenen Datensätze können Sie die Protokolldatensätze auf die übliche Weise anzeigen und sortieren. Klicken Sie auf , um ausgewählte Datensätze aus der Datenbank der zentralisierten Protokolle zu löschen. (Zum Löschen von Datensätzen benötigen Sie die Berechtigung DELETE_CLOGS.)

Protokollebenen

Genesys Administrator meldet Protokollereignisse auf vier Detailebenen: Alarm, Standard, Interaktion und Verfolgung. Protokollereignisse dieser Ebenen haben das gleiche einheitliche Protokolldatensatzformat und können in der Datenbank der zentralisierten Protokolle gespeichert werden.

Zudem generieren einige Anwendungen auch Überwachungsprotokolle. Diese Überwachungsprotokolle enthalten in der Regel zusätzliche Attribute und Informationen über Konfigurationsänderungen und Steuerungsaktionen, die für Prozesse, Lösungen und Alarme ausgeführt wurden.

Alarmebene

Protokolle auf Alarmebene enthalten nur Protokolldatensätze der Ebene "Alarm". Solution Control Server (SCS) generiert Alarm-Protokollereignisse für andere Anwendungen, wenn von diesen Protokollereignisse empfangen werden, die in den Alarmbedingungen als Erkennungsereignisse konfiguriert sind. Bei Verwendung dieser Ebene meldet SCS das Auftreten und Entfernen aller Alarme an die Datenbank der zentralisierten Protokolle.

Standardebene

Protokolle der Standardebene enthalten High-Level-Ereignisse in Bezug auf wichtige Probleme und normale Vorgänge von derzeit ausgeführten Lösungen. Auf der Standardebene wird ein Ereignis gemeldet, wenn es eines der folgenden Kriterien erfüllt:

[+] Kriterien anzeigen

Interaktionsebene

Protokolle auf Interaktionsebene melden die Details einer von Lösungskomponenten, die Interaktionen behandeln, verarbeiteten Interaktion. Das Protokoll enthält Informationen über die Verarbeitungsschritte für jede Interaktion der einzelnen Lösungskomponente. Ein Ereignis wird auf Interaktionsebene gemeldet, wenn Folgendes zutrifft:

Es handelt sich um einen erkennbaren High-Level-Datenaustausch mit einer anderen Anwendung über eine Interaktion.
Es gibt eine Änderung des Echtzeitstatus einer von einer Anwendung verarbeiteten Interaktion an (es sei denn, dass diese Änderung über den High-Level-Datenaustausch sichtbar ist).

Die konkreten Kriterien hängen von der jeweiligen Komponente und ihrer Rolle bei der Interaktionsverarbeitung ab.

Verfolgungsebene

Protokolle auf Verfolgungsebene melden die Einzelheiten zu Kommunikationsvorgängen zwischen den verschiedenen Lösungskomponenten. Das Protokoll enthält Informationen über die Verarbeitungsschritte für jede Interaktion der einzelnen Lösungskomponente. Auf der Verfolgungsebene wird ein Ereignis gemeldet, wenn es eines der folgenden Kriterien erfüllt:

Es handelt sich um einen erkennbaren High-Level-Datenaustausch mit einer anderen Anwendung.
Es handelt sich um einen erkennbaren High-Level-Datenaustausch mit einem externen System.
Es gibt eine Änderung des Echtzeitstatus von Objekten auf Benutzerebene an, die von der Anwendung behandelt werden (es sei denn, dass diese Änderung über den High-Level-Datenaustausch sichtbar ist).

Weitere Informationen

Weitere Informationen zur Protokollierung in der Genesys-Software finden Sie im Management Layer User's Guide. Beschreibungen der Protokolle selbst finden Sie in der Framework Combined Log Events Help.