WICHTIG: Auf Servern dürfen niemals die VB.Net-Funktionen Msgbox und Inputbox verwendet werden. Nutzen Sie die Funktionen VID_Write2Log, RaiseMessage oder AppData.Instance.RaiseMessage.
Für die Ausgabe eigener Meldungen in die Protokolldatei des One Identity Manager Service können Sie innerhalb von Prozessschritten die Methoden RaiseMessage und AppData.Instance.RaiseMessage der Skript-Engine nutzen. Verwenden Sie zur Ausführung der Skripte die Prozesskomponente ScriptComponent.
Je nach angegebenem Schweregrad (Parameter MsgSeverity) werden die Meldungen in der Protokolldatei farbig markiert.
Abbildung 7: Beispiel für die Ausgabe eigener Meldungen in die Protokolldatei des One Identity Manager Service
RaiseMessage
Die Ausgabe wird mit weiteren Meldungen zusammengeführt und nach Verarbeitungsende des Prozessschrittes protokolliert.
Syntax:
RaiseMessage (MsgSeverity, "Zeichenkette")
Beispiel: Verwendung von RaiseMessage-Ausgaben
RaiseMessage (MsgSeverity.Warning, "Beispiel für eine Warnung")
RaiseMessage (MsgSeverity.Info, "Beispiel für eine Info")
RaiseMessage (MsgSeverity.Serious, "Beispiel für eine als Fehler markierte Meldung")
AppData.Instance.RaiseMessage
Die Ausgabe erfolgt sofort bei der Verarbeitung unabhängig vom Verarbeitungsende des Prozessschrittes.
Syntax:
AppData.Instance.RaiseMessage (MsgSeverity, "Zeichenkette")
Beispiel: Verwendungen von AppData.Instance.RaiseMessage-Ausgaben
AppData.Instance.RaiseMessage (MsgSeverity.Warning, "Beispiel für eine Warnung")
AppData.Instance.RaiseMessage (MsgSeverity.Info, "Beispiel für eine Info")
AppData.Instance.RaiseMessage (MsgSeverity.Serious, "Beispiel für eine als Fehler markierte Meldung")
Weitere Beispiele für Ausgaben in die Protokolldatei des One Identity Manager Service entnehmen Sie den Skriptbeispielen auf dem Installationsmedium im Verzeichnis QBM\dvd\AddOn\SDK\ScriptSamples.
Um Meldungen des One Identity Manager Service im Ereignisprotokoll des Servers aufzuzeichnen, passen Sie das Modul EventLogLogWriter in der Konfigurationsdatei des One Identity Manager Service an. Das Ereignisprotokolls können Sie beispielsweise über die Ereignisanzeige in der Microsoft Management Console anzeigen.
Tabelle 21: Parameter des EventLogLogWriter
|
Ereignis-ID (EventID) |
ID mit der Meldungen in das Ereignisprotokoll geschrieben werden. |
|
Ereignisprotokoll (EventLog) |
Name des Ereignisprotokolls, in das die Meldungen geschrieben werden. Mit dem Standardwert Application werden die Meldungen in das Anwendungsprotokoll geschrieben.
HINWEIS: Wenn mehrere One Identity Manager Service auf einem Server Ereignisprotokolle schreiben, achten Sie darauf, dass die ersten 8 Buchstaben des Protokollnamens auf diesem Server eindeutig sind. |
|
Kategorie (Category) |
Kategorie mit der Meldungen in das Ereignisprotokoll geschrieben werden. |
|
Quelle (Source) |
Bezeichnung für die Quelle mit der Meldungen in das Ereignisprotokoll geschrieben werden. |
|
Schweregrad (LogSeverity) |
Informationsgrad der protokollierten Meldungen.
Zulässige Werte sind:
-
Info: Alle Meldungen werden in das Ereignisprotokoll geschrieben. Das Ereignisprotokoll wird schnell groß und unübersichtlich.
-
Warning: Nur Warnungen und Ausnahmefehler werden in das Ereignisprotokoll geschrieben (Standard).
-
Serious: Nur Ausnahmefehler werden in das Ereignisprotokoll geschrieben. |
Meldungen aus der Prozessverarbeitung können ebenfalls in das Ereignisprotokoll eines Servers geschrieben werden. Dazu verwenden Sie die Prozesskomponente LogComponent.
Ausführliche Informationen zur Konfiguration des One Identity Manager Service finden Sie im One Identity Manager Konfigurationshandbuch.
Der One Identity Manager Service protokolliert Meldungen standardmäßig nur im Ereignisprotokoll Application.
Um ein Ereignisprotokoll mit einem anderen Namen zu verwenden
-
Legen Sie die Datei, in die der One Identity Manager Service schreiben soll, manuell auf dem Jobserver an. Nutzen Sie dafür beispielsweise PowerShell.
-
Führen Sie auf dem Jobserver PowerShell als Administrator aus.
-
Führen Sie folgendes CmdLet aus:
New-EventLog -Source "Foobar" -LogName "<Dateiname>"
-
Geben Sie diesen Dateinamen in der Konfigurationsdatei des One Identity Manager Service im Modul EventLogLogWriter als Namen für das Ereignisprotokoll an.
-
Starten Sie den Computer neu.
-
Starten Sie den One Identity Manager Service neu.
Ist das Plugin HTTPLogPlugin in der Konfigurationsdatei des One Identity Manager Service konfiguriert, wird eine Protokolldatei mit den HTTP Anfragen des One Identity Manager Service erzeugt. Die Datei wird im Apache HTTP Server Combined Log Format geschrieben.
Beispiel: Protokolleinträge des HTTPLogPlugins
172.19.2.18 - - [03/Feb/2005:14:55:48 +0100] "GET /resources/JobService.css HTTP/1.x" OK - "http://<Servername>:<Portnummer>/status/LogWriter/Config""Mozilla/5.0 (Windows; U; 5.1; de-DE; rv:1.7.5) Gecko/20041108Firefox/1.0"
Tabelle 22: Bedeutung der einzelnen Einträge
|
172.19.2.18 |
IP-Adresse von der die Anfrage kam. |
|
- |
Benutzername des Clients über IDENT-Protokoll (RFC 1413). |
|
- |
Benutzername des Clients gemäß HTTP Authentifizierung. |
|
[03/Feb/2005:14:55:48 +0100] |
Zeitpunkt der Verarbeitung der Anfrage auf dem Server. |
|
GET /resources/JobService.css HTTP/1.x |
Anfrage. |
|
OK |
Status Code. |
|
- |
Größe der an den Browser zurückgeschickten Daten. |
|
"http://<Servername>:<Portnummer>/status/LogWriter/Config" |
URL von der aus der Zugriff auf die aktuelle Seite erfolgt ist. |
|
"Mozilla/5.0 (Windows; U; Windows NT 5.1; de-DE; rv:1.7.5) Gecko/20041108Firefox/1.0" |
Verwendeter Browser. |
Ausführliche Informationen zur Konfiguration des One Identity Manager Service finden Sie im One Identity Manager Konfigurationshandbuch.
