Probleme mit dem Loganalyseutility ermitteln

Informationen zum Loganalyseutility

Das Loganalyseutility ist ein Befehlszeilenutility, mit dem Sie die Ursachen von Problemen, die von Oracle Enterprise Performance Management System-Komponenten gemeldet werden, durch Analysieren der entsprechenden Logdateien schnell ermitteln können. Da dieses Utility die Logdateianalyse automatisiert, müssen Sie EPM System-Logdateien nicht manuell durchsuchen, um Probleme zu ermitteln. Die erforderlichen Informationen zur Fehlerbehebung oder zur Eskalation des Problems an Oracle Support stehen durch Ausführen dieses Utilitys umgehend zur Verfügung. Wenn dieses Utility auf dem Server ausgeführt wird, auf dem Oracle Hyperion Foundation Services installiert ist, werden die Logdateien auf allen in der Oracle Hyperion Shared Services-Registry einer EPM System-Instanz angegebenen Servern aufgerufen und analysiert.

Das Loganalyseutility bietet folgende Möglichkeiten:

In einem bestimmten Zeitraum aufgetretene EPM System-Fehler auflisten. Systemprobleme stehen im Zusammenhang mit Services, Fehlern bei der Kommunikation zwischen Komponenten und Fehlern bei der Kommunikation mit Benutzerverzeichnissen.
In einem bestimmten Zeitraum aufgetretene funktionale Fehler auflisten. Funktionale Probleme stehen im Zusammenhang mit der Funktionalität von EPM System-Komponenten, z.B. Fehler bei der Ausführung einer Oracle Essbase-Berechnung oder beim Laden von Formularen in Oracle Hyperion Planning oder Oracle Hyperion Financial Management.
Ausführungskontext-ID (Execution Context ID, ECID) für Logdateien tracen und somit Benutzersessions in allen EPM System-Komponenten tracen. Eine ECID ist eine eindeutige ID, anhand derer Ereignisse korreliert werden, die Teil desselben Ausführungsablaufs einer Anforderung sind. Eine ECID ist eine eindeutige ID nach Oracle-Standard.

Voraussetzungen

Jeder Benutzer, der Zugriff auf das Verzeichnis EPM_ORACLE_INSTANCE/bin (z.B. auf einem Windows-Server C:/Oracle/Middleware/user_projects/epmsystem1/bin) hat, kann das Loganalyseutility ausführen.

Benutzer, die das Loganalyseutility ausführen, benötigen Ausführungsberechtigungen für folgende Dateien:

Windows: EPM_ORACLE_INSTANCE/bin/loganalysis.bat
Benutzer, die das Loganalyseutility ausführen, benötigen Leseberechtigungen für die Dateien und Verzeichnisse im Verzeichnis MIDDLEWARE_HOME/user_projects auf allen Servercomputern, die EPM System-Komponenten hosten. Benutzer benötigen außerdem Schreibberechtigungen für das Verzeichnis, in dem das Utility seine Berichte erstellt.

Wenn die Logdateien nicht innerhalb des Verzeichnisses MIDDLEWARE_HOME/user_projects gespeichert werden, benötigen Benutzer, die das Utility ausführen, zudem Leseberechtigungen für die Logdateien am benutzerdefinierten Speicherort.

Speicherort der Berichte des Loganalyseutilitys

Das Loganalyseutility erstellt einen HTML-Bericht basierend auf den angegebenen Befehlsoptionen und speichert diesen Bericht im Verzeichnis EPM_ORACLE_INSTANCE/diagnostics/reports, z.B. auf einem Windows-Server unter C:/Oracle/Middleware/user_projects/epmsystem1/diagnostics/reports.

Im Allgemeinen verwendet das Loganalyseutility folgende Benennungskonvention für Berichte:

LogAnalysis_Report_YYYY_MM_DD_HR_MIN_SEC.html

Das Loganalyseutility bietet eine Befehlsoption zur Angabe eines eindeutigen Berichtsnamens.

Hinweis:

Wenn der Inhalt der Berichte des Loganalyseutilitys unleserlich ist, entfernen Sie die Anweisung -Dfile.encoding=UTF-8 aus der ausführbaren Datei des Loganalyseutilitys (EPM_ORACLE_INSTANCE/bin/loganalysis.bat oder EPM_ORACLE_INSTANCE/bin/loganalysis.sh), und generieren Sie den Bericht neu.

Optionen des Loganalyseutilitys

Optionen zur Verwendung des Loganalyseutilitys:

loganalysis [-all | -system | -functional | -m [ERROR | INCIDENT_ERROR
WARNING | NOTIFICATION | TRACE]] [-t [<TIME FROM> <TIME TO>] -tday <days> -thour <hours> -tmin <minutes>] -ecid <ecid> -s <SEARCH STRING> -d <Offline log files directory> -f <file with message ids to filter from the report> -maxsize <max report size in MB>

Tabelle 3-1 Parameter des Loganalyseutilitys

Parameter	Beschreibung
`-h`	Zeigt die Hilfeseite an. Beispiel: `loganalysis -h`
`-system`	Generiert einen Bericht mit Logmeldungen der Typen `ERROR` und `INCIDENT_ERROR`. Wird in der Regel von EPM System-IT-Administratoren verwendet. Beispiel: `loganalysis -system`
`-functional`	Generiert einen detaillierten Bericht mit Meldungen der Typen `WARNING`, `NOTIFICATION` und `TRACE`. Wird in der Regel von funktionalen EPM System-Administratoren verwendet. Beispiel: `loganalysis -functional`
`-ecid <ECID>`	Generiert einen Bericht mit einem Trace einer in allen EPM System-Komponenten ausgeführten Aktivität. Verwendet eine ECID als Argument. Dieser Bericht wird zum Tracen von Fehlern in allen EPM System-Komponenten verwendet. Im Allgemeinen wird diese Option verwendet, wenn durch Ausführen eines Berichts mit der Option `-all`, `-system` oder `-functional` ein Fehler ermittelt wurde und ein Trace der Aktivität generiert werden soll, die den Fehler verursacht hat. Informationen hierzu finden Sie unter ECID einer Benutzeraktivität ermitteln. Hinweis: ECIDs, die ein Caret-Zeichen (^) enthalten, müssen in Anführungszeichen gesetzt werden. Beispiel: `loganalysis -ecid "0000Jet8kA6ESOG_Ix5Eif1G^RAF000005"`
`-m <ERROR TYPE>`	Generiert einen Bericht mit Meldungen eines angegebenen Typs. Verwendet einen der folgenden Fehlermeldungstypen als Argument: `ERROR` `INCIDENT_ERROR` `WARNING` `NOTIFICATION` `TRACE` Beispiel: `loganalysis -m ERROR`
`-o <TITLE>`	Generiert einen Bericht mit einem benutzerdefinierten Berichtstitel. Verwendet einen in doppelte Anführungszeichen gesetzten Berichtstitel als Argument. Beispiel: `loganalysis -m ERROR -o "Mein Fehlerbericht"` erstellt einen Bericht mit dem Titel `Mein Fehlerbericht.html` mit Logmeldungen des Typs `ERROR` aus allen Logdateien. Setzen Sie den Berichtsnamen in Anführungszeichen.
`-s <STRING>`	Generiert einen Bericht mit Logmeldungen, die die angegebene Zeichenfolge enthalten. Verwendet eine in doppelte Anführungszeichen gesetzte Fehlerzeichenfolge als Argument. Beispiel: `loganalysis -system -s "Verbindung zu DB konnte nicht hergestellt werden" -o "DB-Verbindungsfehler"` erstellt einen Bericht mit dem Titel `DB-Verbindungsfehler.html`, in dem alle Meldungen der Typen `ERROR` und `INCIDENT_ERROR` aufgeführt sind, die die Zeichenfolge `Verbindung zu DB konnte nicht hergestellt werden` enthalten.
`-t <FROM DATE>`T`<FROM TIME><TO DATE>`T`<TO TIME>`	Generiert einen Bericht mit Logmeldungen, die im angegebenen Zeitraum generiert wurden. Verwendet durch Leerzeichen getrennte "Von"- und "Bis"-Zeitangaben als Argument. "Von"- und "Bis"-Zeit müssen im Format `JJJJ-MM-TTTHOUR:MIN:SEC` unter Verwendung des 24-Stunden-Formats angegeben werden. Beispiel: `loganalysis -all -t 2012-08-10T12:00:00 2012-08-10T23:59:59 -o "Alle Meldungen am 10_August_2012"` erstellt die Datei `Alle Meldungen am 10_August_2012.html`, die alle am 10.08.2012 zwischen Mitternacht und 23:59:59 Uhr generierten Logmeldungen enthält.
`-tday <DAYS>`	Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Tagen generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: `loganalysis -ERROR -tday 3 -o "Fehlermeldungen der letzten drei Tage"` erstellt die Datei `Fehlermeldungen der letzten drei Tage.html`, die alle innerhalb der letzten drei Tage generierten Meldungen des Typs `ERROR` enthält.
`-thour <HOURS>`	Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Stunden generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: `loganalysis -ERROR -thour 6 -o "Fehlermeldungen der letzten sechs Stunden"` erstellt die Datei `Fehlermeldungen der letzten sechs Stunden.html`, die alle innerhalb der letzten sechs Stunden generierten Meldungen des Typs `ERROR` enthält.
`-tmin <MINUTES>`	Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Minuten generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: `loganalysis -ERROR -tmin 45 -o "Fehlermeldungen der letzten 45 Minuten"` erstellt die Datei `Fehlermeldungen der letzten 45 Minuten.html`, die alle innerhalb der letzten 45 Minuten generierten Meldungen des Typs `ERROR` enthält.
`-d <DIRECTORY PATHS>`	Generiert einen Bericht mit Logdateien, die unter den angegebenen Verzeichnispfaden gespeichert sind. Mit dieser Option können Sie Logdateien analysieren, die nicht am Standardspeicherort für Logdateien von EPM System-Komponenten gespeichert sind. Sie können mehrere Logspeicherorte durch Kommas getrennt angeben. Verzeichnispfade müssen in doppelte Anführungszeichen gesetzt werden. Beispiel: `loganalysis -m INCIDENT_ERROR -d "c:/logfiles"`, `"z:/OracleLogs"`, `"y:/EPMLogs" "/net/epm_server2/Oracle/Middleware/user_projects" -o "Mein benutzerdefinierter Analysebericht"` erstellt einen Bericht mit dem Titel `Mein benutzerdefinierter Analysebericht`, in dem alle in den Logdateien in den angegebenen Verzeichnissen enthaltenen Meldungen des Typs `INCIDENT_ERROR` aufgeführt sind.
`-f <arg>`	Wird in diesem Release nicht verwendet. Für zukünftige Verwendung reserviert.
`-maxsize <arg>`	Erhöht die Größe des Berichts. Die Standardberichtsgröße ist 5 MB. Beispiel: `loganalysis -all -o "Benutzerdefinierter Analysebericht" -maxsize 15` generiert eine Berichtsdatei, die maximal 15 MB groß sein kann. Der Bericht mit dem Titel `Benutzerdefinierter Analysebericht` enthält alle Meldungen in allen Logdateien.
`-all`	Generiert einen Bericht mit Meldungen in allen Logdateien. Das Generieren dieses Berichts kann einige Zeit dauern und zur Erstellung einer sehr großen Berichtsdatei führen. Oracle rät von der Verwendung dieser Option ohne weitere Parameter zur Begrenzung des Berichtsumfangs ab. Beispiel: `loganalysis -all`

Loganalyseutility ausführen

Das Loganalyseutility ist ein Befehlszeilenutility.

So führen Sie das Loganalyseutility aus:

Starten Sie eine Eingabeaufforderung auf dem Servercomputer, der Foundation Services hostet.
Navigieren Sie zum Verzeichnis EPM_ORACLE_INSTANCE/bin, auf einem Windows-Server in der Regel C:/Oracle/Middleware/user_projects/epmsystem1/bin.
Führen Sie einen Befehl aus. Geben Sie die entsprechenden Befehlsoptionen zum Generieren des Berichts an. Informationen hierzu finden Sie unter Tabelle 3-1.

loganalysis.bat OPTIONS (Windows)

Beispiel: Verwenden Sie auf einem Windows-Server den folgenden Befehl, um einen Bericht mit dem Titel "Datenbankprobleme_21-11-2013_11-Uhr" zu erstellen, der Meldungen zu einem Fehler enthält, aufgrund dessen die Datenbankverbindung einer EPM System-Komponente am 21. November 2013 gegen 11 Uhr getrennt wurde:

loganalysis -system -t 2013-01-21T11:15:00 2013-01-21T11:20:00 -s "Verbindung zu DB konnte nicht hergestellt werden" -o "Datenbankprobleme_21-11-2013_11-Uhr"

ECID einer Benutzeraktivität ermitteln

Eine ECID ist eine eindeutige, vom System generierte ID, anhand derer die Aktivität eines Benutzers in verschiedenen EPM System-Komponenten korreliert werden kann.

Um die ECID einer Benutzeraktivität zu ermitteln, müssen Sie zunächst einen Bericht des Loganalyseutilitys generieren. Die ECID, die in den Details einer Logmeldung enthalten ist, sieht wie folgt aus:

0000Jet8kA6ESOG_Ix5Eif1G^RAF000005

So ermitteln Sie die ECID einer Benutzeraktivität:

Führen Sie das Loganalyseutility aus, und generieren Sie einen Bericht mit Meldungen zu Systemfehlern oder funktionalen Fehlern. Informationen hierzu finden Sie unter Loganalyseutility ausführen.
Öffnen Sie im Verzeichnis EPM_ORACLE_INSTANCE/diagnostics/reports (z.B. auf einem Windows-Server C:/Oracle/Middleware/user_projects/epmsystem1/diagnostics/reports) den generierten Bericht.