Essbase Log Files
Essbase Log Files
Chapter-VI
Essbase Log Files
Description:
This document briefs the log files which Essbase uses during its processing.
The log files are window Essbase developers and administrators. During
debugging log files are vital tool which provides the direction for analysis and
root cause of the errors.
History:
Version Description Author/Reviewer Publish Date
Change
0.1 Initial Draft Gaurav Shrivastava 24-Nov-2010
0.1 1st Version Amit Sharma 10th Jan 2011
1) Information Logs……………………………………………………………………….….3
2) Log Files………………………………………………………………………3
1. ServeLog File………………………………………………………...6
2. Application log File………………………..………………………8
3. Outline Change Log File…………………………………………10
4. Query Log File……………………………………………………..11
5. Exception Log File………………………………………………..12
4) Log analyzer…………………………………………………………………….15
5) Example……………………………………………………………………………16
Information Logs
Log file keeps list of actions that have occurred. Log files are used to keep information of
history. Essbase has log file for server, application and configuration. Essbase provides a
variety of information for database administrators. The primary sources of this information
are available in the various log files (Server log, outline change log).
1. Application.log
2. Essbase.log
3. Configtool.log
4. eas_install.log
5. essbaseserver-install.log
Configuration files.
You can trace the operations perform and the timestamp through log file.
Log files keep records off all performed activities. ESSBASE.LOG file is responsible for all
Essbase related information.
Other way to view the log file is Right click on the server and view the log file.
You can select the log files according to specific starting date . Suppose any problem comes
after a specific date. So you need not to see log information before that day.
One way to open log file is through arbor path whereas other way is right click on server
and view the log. First view is console view and other is text file view.
The following essbase.log example shows entries written when Essbase Server starts. First, the
Sample application and the Basic database are loaded. The log includes information about the
time the application and database are loaded, the process ID assigned to the application by the
operating system, and the startup of the security authentication module.
The following log shows a single error. The admin user tried to rename an application using a
name that already exists on Essbase Server. The log includes information about the user name,
the time of the error, and the operation that failed and caused the error.
[Thu Dec 16 09:56:32 2010]Local/ESSBASE0///Info(1051001)
Received client request: Get Client Settings (from user [admin])
The next log shows a shutdown. The log includes information about the name of the application
shutdown and the time of the shutdown.
[Thu Dec 30 16:03:01 2010]Local/ESSBASE0///Info(1054005)
Shutting down application Bisp
2) Application log
Log files also record information of any kind of modification. Log files keeps information of
creation time, update information, user information, modification type and other
information. Outline change information log file size limits minimum, maximum or default
size.
The outline change log files size limitations, which you can tune within the minimum and
Maximum sizes as follows:
You can change the file size with the following configuration command:
OUTLINECHANGELOGFILESIZE
4) Query Logs
Query log file generates when you write a query. The query log file use for all queries
performed against the database, query execute with Oracle Essbase Spreadsheet Add-in or
©Business Intelligence Solution Providers| Essbase Log Files 8
Learnhyperion.wordpress.com
Report Writer. Query logging can track members, generation or level numbers of members
belonging to specific generations or levels, and Hybrid Analysis members. Query logging
also offers the flexibility to exclude logging of certain dimensions and members belonging
to generations or levels. By default the query log file output is an XML file, you can import
the log file to any XML-enabled tool to view the log.
For information about the query log file structure, refer to querylog.dtd in the
ESSBASEPATH/bin directory.
5) Exception Logs
Exception can come during abnormal shutdown. You can use the
EXCEPTIONLOGOVERWRITE TRUE configuration setting in essbase.cfg to overwrite the
existing exception log instead of creating a new log, Oracle recommends that you use the
default setting of FALSE.
When Essbase server starts, first it reads the essbase.cfg file. Essbase server
works according to default setting of essbase.cfg file. You need to alter
essbase.cfg file for advance settings. You can make changes individual
application or database level in essbase.cfg file.
Essbase.cfg setting for outline change details in Essbase Configuration File
OUTLINECHANGELOG TRUE
essbase.cfg setting the Maximum Log File Size for Essbase Server and Application
Logs
AGTMAXLOGFILESIZE
APPMAXLOGFILESIZE
The default maximum log file size is 1 GB.
Essbase.cfg setting the Type of Essbase Server Messages Logged
AGENTLOGMESSAGELEVEL Log Message, Warning and Error
PORTUSAGELOGINTERVAL To check the number of ports in use
SET MSG To determine whether Essbase Server writes the following items to the
application log during the duration of the calculation.
CLEARLOGFILE when set to TRUE, clears the Essbase Server log each time Essbase
Server restarts and the application log each time the application restarts.
DELIMITEDMSG when set to TRUE, adds a tilde (~) between each field in the server and
application logs.
DELIMITER The DELIMTER setting works only when DELIMITEDMSG is set to TRUE.
The dataload.err log contains errors that occurred during a dimension build or a data load.
Log analyzer
Log analyzer provides a graphical analysis tool for log information. Log analyzer accessed
from administration services console.
Right click and log charts.
Examples
1) When you create new database application, the below information enters into log
file. You can see the log information associated with database. Like, what was the
event time? Who was the user?
There are some facts for data load fail. Levelref.txt has some unknown member. Outline is
differs with the text file.
If Data load through rule file gets fail, you can see the log file and trace information. Who is
the user? What is the error? What data gets update? Log file shows all related information.
©Business Intelligence Solution Providers| Essbase Log Files 14
Learnhyperion.wordpress.com
When you execute calculation script it keeps information for execution time and updated
record members details.
Problem: When error comes while starting application, loading data into application or
other error related to application.
Solution: You need to see application.log file.