Logdateien in EPM

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

Veröffentlicht in Essbase, Installation, Konfiguration & Tuning Verwendete Schlagwörter: , , , , , , , , ,