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: |
-system |
Generiert einen Bericht mit Logmeldungen der Typen Beispiel: |
-functional |
Generiert einen detaillierten Bericht mit Meldungen der Typen WARNING , NOTIFICATION und TRACE . Wird in der Regel von funktionalen EPM System-Administratoren verwendet.
Beispiel: |
-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 Hinweis: ECIDs, die ein Caret-Zeichen (^) enthalten, müssen in Anführungszeichen gesetzt werden. Beispiel: |
-m <ERROR TYPE> |
Generiert einen Bericht mit Meldungen eines angegebenen Typs. Verwendet einen der folgenden Fehlermeldungstypen als Argument:
Beispiel: |
-o <TITLE> |
Generiert einen Bericht mit einem benutzerdefinierten Berichtstitel. Verwendet einen in doppelte Anführungszeichen gesetzten Berichtstitel als Argument.
Beispiel: |
-s <STRING> |
Generiert einen Bericht mit Logmeldungen, die die angegebene Zeichenfolge enthalten. Verwendet eine in doppelte Anführungszeichen gesetzte Fehlerzeichenfolge als Argument.
Beispiel: |
-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 Beispiel: |
-tday <DAYS> |
Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Tagen generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: |
-thour <HOURS> |
Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Stunden generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: |
-tmin <MINUTES> |
Generiert einen Bericht mit Logmeldungen, die innerhalb der angegebenen Anzahl von Minuten generiert wurden. Verwendet einen numerischen Wert als Argument. Beispiel: |
-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: |
-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: |
-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: |
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.