Manche Fragen warum ich ein Blog schreibe. Nun, es hilft andere Benutzer bei ihren Fragen, aber es hilft mir selbst auch! Wie, ich lege die Antworten an einer Stelle ab, wo ich diese auch selbst wieder finden kann….
So auch zum Thema Log Dateien. Dinge die ich schnell vergesse sind: Wie war doch mal der Name der Logdatei? Was finde ich in dieser Datei? Darum habe ich solche Informationen in diesem Beitrag aufgeschrieben. Dann kann ich sie wiederfinden – und sie auch!
EPM Log Dateien
In den verschiedenen Versionen gibt es immer mal wieder Änderungen in der Struktur und Name der Logdateien. Dieser Blogbeitrag ist für die EPM Version 11.1.2.4. Seit der Versionen 11.1.2.x sind alle Logdateien in ein zentrales Verzeichnis gebracht. Dieses zentrale Verzeichnis mit den EPM Logdateien ist:
\Oracle\Middleware\user_projects\epmsystem1\diagnostics\logs\
oder auch:
EPM_ORACLE_INSTANCE\diagnostics\logs\
Das erleichtert die Suche schon um Vieles – nur wenn EPM auf verschiedene Server verteilt installiert ist, dann muss man dieses Verzeichnis auf diese Server aufsuchen. Ich finde es immer praktisch, eine Verknüpfung auf den Desktop zu legen.
Oracle Diagnostic Logging (ODL)
Ich weiß nicht in welcher Version ODL verfügbar geworden ist, aber dieses Werkzeug erstellt die Logdateien für alle EPM Produkte. Bei der Installation/Konfiguration wird für jedes Produkt die Standard Stufe der Aufzeichnung eingestellt. Wenn der Standard nicht reicht, dann kann diese Stufe nach Bedarf in spezielle xml Dateien angepasst werden. Die meisten Produkte haben diese 4 Stufen (nach Wichtigkeit sortiert):
- ERROR
- WARNING
- NOTIFICATION
- TRACE
Es gibt ein Log Analysis Utility, aber ich finde dieses zu komplex in der Anwendung und meistens habe ich schon eine Idee in welchem Produktlog ich suchen muss.
Die Logdateien aus dem ODL haben immer die Zeichenkette _ODL im Namen. Diese existieren oft neben den herkömmlichen Logdateien. So gibt es in den Essbase Application Ordnern die bekannten Applikationslogs wie „Sample.log“ aber auch weitere mit ODL wie „Sample_ODL.log“.
Das klassische Applikationslog, wie z.B. Sample.log, ist so strukturiert, dass es immer 2 Zeilen Information gibt, und danach eine Leerzeile eingefügt wird. Dieses Format lässt sich schlecht in andere Systeme verarbeiten und deshalb wurde für ODL ein neues Format aufgebaut. Dieses ist in der Abbildung 1 zu sehen. Oben das klassische Format, unten das ODL Format.
Abbildung 1: Oberer Teil Logdatei mit klassischem Format, unten mit ODL Format.
Ich mag das ODL Log lieber, denn es ist viel übersichtlicher und hat zusätzliche Informationen. So wird pro Zeile angegeben welcher Typ Eintrag es betrifft: REQ steht für Request, DDB steht für Datenbank, TMG für Transaktion, OBJ für Objekt, etc.
[ATT4P] [NOTIFICATION:16] [REQ-91] []
[ATT4P] [ERROR:32] [DDB-69] [] [ecid:
[ATT4P] [WARNING:1] [TMG-14] [] [ecid:
[ATT4P] [NOTIFICATION:16] [TCP-59] []
[ATT4P] [NOTIFICATION:16] [REQ-91] []
[ATT4P] [NOTIFICATION:16] [OBJ-17] []
[ATT4P] [ERROR:32] [REQ-136] [] [ecid:
[ATT4P] [NOTIFICATION:16] [REQ-210] []
[ATT4P] [NOTIFICATION:16] [TCP-59] []
[ATT4P] [NOTIFICATION:16] [REQ-91] []
Es gibt in der Community Essbase Anwendungen die Essbase ODL Logs verarbeiten und analysiert werden.
Das Oracle Diagnostic Logging ist ein sehr großes Thema, welches technisch weit über das gängige Administrieren von EPM Anwendungen gehen kann. Deshalb muss ich den Beitrag auch hier abgrenzen.
EPM System Diagnostic
Teil der Foundation Services ist das EPM System Diagnostic. Dieses Werkzeug testet verschiedene Dinge wie
- Welche Produkte sind korrekt konfiguriert und welche nicht.
- Datenbank Verbindungen zu den Repositories.
- External Authentication. Ist das LDAP richtig eingebunden und funktioniert die Verbindung.
- http Web Server. Ist eine Verbindung vorhanden.
- Status von der Shared Services Java Web Anwendung.
- Java Web Anwendungen und einige Produkt spezifische Tests.
Abbildung 2: EPM System Diagnistics Aufruf
Das Ergebnis wird in einer Datei geschrieben die im Verzeichnis EPM_ORACLE_INSTANCE\diagnostics\report liegt.
Enterprise Manager
Die EPM Produkte sind alle Java Anwendungen, die in dem Fusion Middleware Web Application Server (Weblogic) eingebettet sind. Dieses Teil bildet also das Herzstück und entsprechend wichtig ist für die Techniker ein Zugriff hierauf.
Mit der URL http://WebLogicAdminServerHost:port/em kann der Enterprise Manager aufgerufen werden. Hier kann der Status aller EPM Java Anwendungen überprüft werden.
Abbildung 3: Enterprise Manager Übersicht
Nach der Auswahl einer Anwendung gibt es dann die Details.
Abbildung 4: Enterprise Manager Details
Die Betreuung von Weblogic Server ist eine separate Disziplin und deshalb vertiefe ich dieses nicht weiter in diesem Blog.
Wenn der EPM Administrator keinen Zugriff auf den Enterprise Manager hat, oder sich dort nicht auskennt, dann gibt es immer noch die WebLogic Log Dateien.
WebLogic Log Dateien
Die Logdateien von den Konfigurationen auf dem Webserver befinden sich unter diesem Pfad:
\Oracle\Middleware\user_projects\domains\EPMSystem\servers\
Bei generellen Problemen mit dem Starten einer Webanwendung wird die Ursache nicht in die EPM Logdatei geschrieben, denn der Dienst wurde noch gar nicht gestartet. Dann sollte man also in den WebLogic Log Dateien nachsehen. Wenn die Dienste ordnungsgemäß gestartet wurden, dann gibt die WebLogic Applikation oft ein „server started in PRODUCTION mode“ in der Logdatei. Danach nimmt das ODL die Arbeit auf und befinden sich die Einträge im \diagnostics\logs.
Selbstverständlich, wenn sie ihr EPM auf ein anderes Laufwerk installiert haben, oder ihr epmsystem anders genannt haben, sollten sie entsprechend die hier angegebenen Pfade für ihre Situation anders aufbauen. Schauen sie hier nach der Variable EPM_ORACLE_INSTANCE. Wenn ihre EPM Umgebung auf verschiedene Server verteilt ist, dann befinden sich die Logdateien auch auf den jeweiligen Server.
Es gibt weit über 100 verschiedene Logdateien, und hier bespreche ich die, nach meiner Meinung wichtigsten zu den Produkten Essbase, Planning, Calculation Manager, EAS und Foundation Services.
Logdateien in Essbase
Essbase.log
Lassen wir mit dem Klassiker anfangen, das Essbase.log. Was kann man so alles finden in diesem Log?
Startsequenzen von Datenbanken wenn eine Person sich anmeldet und diese noch nicht gestartet ist.
[Fri Mar 04 16:46:53 2016]Local/ESSBASE0///8516/Info(1051061) Application Sample loaded - connection established [Fri Mar 04 16:46:53 2016]Local/ESSBASE0///8516/Info(1054027) Application [Sample] started with process id [3696] [Fri Mar 04 16:46:53 2016]Local/ESSBASE0///8516/Info(1051009) Setting application Sample active for user [Phulsebosch@external]
Wenn jemand via EAS auf Server Ebene arbeitet…
[Fri Mar 11 11:51:12 2016]Local/ESSBASE0///3612/Info(1051001) Received client request: MaxL: Execute (from user [Philip.Hulsebosch03@AD])
Wenn jemand zur Bearbeitung Objekte sperrt…
[Thu Mar 10 14:00:27 2016]Local/ESSBASE0///8744/Info(1051001) Received client request: Put Object (from user [Philip.Hulsebosch03@AD])
Aber auch Server Prozesse wie die Sicherung des Security Files.
[Mon Mar 07 00:45:02 2016]Local/ESSBASE0///3612/Info(1051243) Exclusive operation security file compaction started. This may take a while [Mon Mar 07 00:45:02 2016]Local/ESSBASE0///3612/Info(1056798) Security file write started by essbasedb@Native Directory [Mon Mar 07 00:45:02 2016]Local/ESSBASE0///3612/Info(1051244) Security file compaction completed
Was findet man in diesem Applikationslog?
Die Start Applikation Sequenz
[2016-01-30T20:45:12.970+01:00] [ATT4P] [NOTIFICATION:16] [SVR-35] [] [ecid: 1454183112354,0] [tid: 9756] Starting Essbase Server - Application [ATT4P] … [2016-01-30T20:45:14.892+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-8] [] [ecid: 1454183112354,0] [tid: 9756] Reading Application Definition For [ATT4P] [2016-01-30T20:45:14.893+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-9] [] [ecid: 1454183112354,0] [tid: 9756] Reading Database Definition For [ATT4P] [2016-01-30T20:45:14.893+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-21] [] [ecid: 1454183112354,0] [tid: 9756] Reading Database Mapping For [ATT4P] [2016-01-30T20:45:14.894+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-10] [] [ecid: 1454183112354,0] [tid: 9756] Writing Application Definition For [ATT4P] [2016-01-30T20:45:14.895+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-11] [] [ecid: 1454183112354,0] [tid: 9756] Writing Database Definition For [ATT4P] [2016-01-30T20:45:14.895+01:00] [ATT4P] [NOTIFICATION:16] [OBJ-22] [] [ecid: 1454183112354,0] [tid: 9756] Writing Database Mapping For [ATT4P] [2016-01-30T20:45:15.409+01:00] [ATT4P] [NOTIFICATION:16] [REQ-202] [] [ecid: 1454183112354,0] [tid: 9756] Waiting for Login Requests
auch wie lange die Abfragen dauerten…
[2016-01-30T21:40:38.447+01:00] [ATT4P] [NOTIFICATION:16] [SSE-55] [] [ecid: 1454185400582,0] [tid: 1984] Spreadsheet Extractor Elapsed Time : [0.005] seconds
Die Datenbank Restrukturierungen…
[2016-01-30T21:22:58.482+01:00] [ATT4P] [NOTIFICATION:16] [MBR-67] [] [ecid: 1454183112354,0] [tid: 1500] Total Restructure Elapsed Time : [0.892] seconds
Und natürlich der Klassiker… die unbekannten Elemente in den Abfragen!
[2016-03-09T21:46:57.719+01:00] [ATT4P] [NOTIFICATION:16] [SSE-19] [] [ecid: 1457552804170,0] [tid: 3948] The sheet contains an unknown member: C02P01A00 .
Logdateien in Planning
Pfad:
Middleware\user_projects\epmsystem1\diagnostics\logs\planning
Eine wichtige Logdatei in Planning ist PlanningCLU.log. Das CLU steht für Command Line Utility, denn es befinden sich die Einträge vom OutlineLoad Tool und andere darin.
Pfad:
Oracle\Middleware\user_projects\domains\EPMSystem\servers\Planning0\logs
Access.log Welche Dateien aufgerufen werden.
Planning_WebApp Allerlei Aktivitäten im Java Container.
Logdateien in Calculation Manager
Pfad:
/Oracle/Middleware\user_projects\domains\EPMSystem\servers\CalcMgr0\logs
CalcMgr0.log Alle Calculation Manager Aktivitäten
CalcManager.log Alle Calculation Manager Aktivitäten
Logdateien in Essbase Administration Services (EAS)
Pfad:
/Oracle/Middleware/user_projects/domains/EPMSystem/servers/EssbaseAdminServices0/logs
EssbaseAdminServices0.log Alle Essbase Administrator Services Aktivitäten
Easserver.log Alle Essbase Administrator Server Aktivitäten
Logdateien vom Analytic Services Provider
Pfad:
/Oracle/Middleware/user_projects/domains/EPMSystem/servers/AnalyticProviderServices0/logs
AnalyticProviderServices0.log Alle ASP Aktivitäten
Logdateien in Foundation Services
Pfad:
Middleware\user_projects\domains\EPMSystem\servers\FoundationServices0\logs\
FoundationServices0.log Server Aktivitäten und Zugriff auf andere Ressourcen.
Framework.log Aktivitäten wie Benutzeranmeldung und Abmeldung.
SharedServices_LCM.log Lifecycle Management Aktivitäten
SharedServices_Security.log User management, provisioning, authentication, und single sign-on Aktivitäten
Workspace.log Workspace Fehlerberichte und Informationen
Es ist ein sehr technischer Beitrag geworden mit allerlei Übersichten. Ich hoffe er hilft ihnen.
Ihr Philip Hulsebosch