Protokollierung von Meldungen der Zielsystemkonnektoren
Standardmäßig werden die Meldungen der Zielsystemkonnektoren in der Protokolldatei des One Identity Manager Service aufgezeichnet. Externe Prozesse werden in der Protokolldatei des StdioProcessor (StdioProcessor.log) aufgezeichnet.
Die Konnektoren für Active Directory, Oracle E-Business Suite, HCL Domino, SAP R/3 und SCIM protokollieren für eine Meldung zusätzlich die folgenden Informationen:
-
TargetSystem: Zielsystemkennung des Konnektors.
-
Method: Methode, die die Protokollierung verursacht hat.
-
Number: Eindeutige Fehlernummer.
-
Message: Fehlermeldung.
Beispiel: Meldungen der Zielsystemkonnektoren
{ "Message": "Target:\"SCIM\" Method:\"OnConnect\" Number:\"2550101\" Message:\"Method OnConnect called.\"", "TargetSystem": "SCIM", "Method": "OnConnect", "Number": "2550101", "Message": "Method OnConnect called.", "SessionId": "SCIM-0B4926", "Parent": "Log Event: Logger='SystemConnector' Level=Debug Message='Connecting target system...' SequenceID=1213", "Indention": "\t" }
Ausgabe von erweiterten Rückgabewerten einzelner Prozesskomponenten
Einige Prozesskomponenten besitzen Prozessfunktionen mit Parametern, die einen erweiterten Rückgabewert liefern (Out-Parameter).
Bei Auftreten eines Fehlers kann die komplette Ausgabe des Parameters in die Protokolldatei des One Identity Manager Service geschrieben werden. So kann beispielsweise bei der Ausführung eines Kommandos oder eines Programms über die Prozesskomponente CommandComponent der Ausgabetext des ausgeführten Kommandos oder Programms zurückgegeben werden.
Um die Rückgabewerte zu protokollieren
Aktivieren des Crashrecorders
Der Crashrecorder speichert die letzten 128 Meldungen ab der Ebene Debug und gibt diese im Fehlermeldungsfenster mit aus. Den Crashrecorder konfigurieren Sie über die Konfigurationsdateien der One Identity Manager-Werkzeuge (appsettings.<appName>.json).
Tabelle 23: Konfigurationseinstellungen des Crashrecorders
Enabled |
Aktiveren (true) und Deaktivieren (false) des Crashrecorders. |
Buffer |
Angabe, wie viele Meldungen gespeichert und ausgegeben werden.
Standard: 128 Meldungen |
Level |
Informationsgrad der Meldungen, die aufgezeichnet werden. Zulässige Werte sind Debug, Error, Fatal, Info, Off, Trace und Warn.
Standard: Debug |
Eine Beispielkonfiguration finden Sie in der Konfigurationsdatei appsettings.json im One Identity Manager-Installationsverzeichnis. Ausführliche Informationen zur Konfigurationsdatei appsettings.json finden Sie im One Identity Manager Handbuch zur Prozessüberwachung und Fehlersuche.
Beispiel: Beispielkonfiguration des Crashrecorders in der Konfigurationsdatei appsettings.json
{ |
"CrashRecorder": { |
"Enabled": "false", |
"Buffer": "128", // count of entries to buffer |
"Level": "Debug" // NLog.LogLevel e.g. Debug, Trace, Warn, Error |
} |
} |