8 Locating and Configuring Enterprise Manager Log Files

8.1.1 About the Management Agent Log and Trace Files

Oracle Management Agent log and trace files store important information that support personnel can later use to troubleshoot problems. The Management Agent uses three types of log files:

• The Management Agent log file (emagent.log)

  The Agent saves information to the log file when the Agent performs an action (such as starting, stopping, or connecting to a Management Service) or when the Agent generates an error (for example, when the Agent cannot connect to the Management Service).

• The Management Agent trace file (emagent.trc)

  The Management Agent trace file provides an advanced method of troubleshooting that can provide support personnel with even more information about what actions the Agent was performing when a particular problem occurred.

• The Management Agent startup log file (emagent.nohup)

  The Management Agent saves information to the startup log file when there is a problem starting the agent. This file is updated by the Management Agent Watchdog Process. When the Watchdog Process finds any problems, it logs to this file.

In addition, Enterprise Manager also provides a log file and a trace file for the fetchlets, which are software programs used by the Management Agent for certain data-gathering tasks:

• emagentfetchlet.log

• emagentfetchlet.trc

8.1.2 Locating the Management Agent Log and Trace Files

The Management Agent log files are stored in the following directory when you install the Management Agent:

AGENT_HOME/sysman/log/

8.1.3 About Management Agent Rollover Files

Both the Management Agent log file and the Management Agent trace file are designed to increase in size over time as information is written to the files. However, they are also designed to reach a maximum size. When the files reach the predefined maximum size, the Management Agent renames (or rolls) the logging or trace information to a new file name and starts a new log or trace file. This process keeps the log files from growing too large.

To be sure you have access to important log or trace file information, the Management Agent will rollover the log and trace files four times by default. When it rolls the log or trace file over the fourth time, the Agent deletes the oldest rollover file.

As a result, you will often see a total of four log files and four trace files in the log directory. The following example shows three archived trace files and the current trace file in the AGENT_HOME/sysman/log directory:

emagent.trc
emagent.trc.1
emagent.trc.2
emagent.trc.3

8.1.4 Controlling the Size and Number of Management Agent Log and Trace Files

You can control how large the log file and the trace file can get before the Management Agent creates a rollover file. You can also control how many rollover files are created before the Management Agent deletes any logging or tracing data.

To control the size and number of Management Agent Log and Trace Files:

1. Stop the Management Agent.

   See Also:

   "Starting, Stopping, and Checking the Status of the Management Agent on UNIX"

2. Locate the emd.properties file, which is located in the following directory:

   AGENT_HOME/sysman/config/ (UNIX)
   AGENT_HOME\sysman\config (Windows)
   
   

3. Use a text editor to open the emd.properties file.

4. Use the information in Table 8-1 to locate and modify the Agent logging and tracing properties in the emd.properties file.

5. Restart the Management Agent.

LogFilewithPID

LogFileMaxSize

LogFileMaxRolls

TrcFileMaxSize

8.1.5 Controlling the Contents of the Management Agent Trace File

To modify the amount of information saved in the Management Agent trace file:

1. Stop the Management Agent.

   See Also:

   "Starting, Stopping, and Checking the Status of the Management Agent on UNIX"

2. Locate the emd.properties file, which is located in the following directory:

   AGENT_HOME/sysman/config
   
   

3. Open the emd.properties file using your favorite text editor and look for the following entries near the bottom of the file:

   tracelevel.main=WARN
   tracelevel.emdSDK=WARN
   tracelevel.emdSDK.util=WARN
   tracelevel.ResMonitor=WARN
   tracelevel.Dispatcher=WARN
   tracelevel.ThreadPool=WARN
   tracelevel.pingManger=WARN
   .
   .
   .
   
   

   Each of these properties controls the level of logging detail for the various subcomponents of the Management Agent.

4. Modify the amount of information that is included in the trace file by replacing the WARN value for each property to one of the values shown in Table 8-2.

   Note:

   The values described in Table 8-2 are case-sensitive.

5. Restart the Management Agent.

8.1.6 Controlling the Size and Number of Fetchlet Log and Trace Files

Like the Management Agent log and trace files, the Management Agent fetchlet log and trace files are designed to reach a maximum size before the Management Agent renames (or rolls) the information to a new file name and starts a new log or trace file.

To control the maximum size of the Management Agent fetchlet log and trace files, as well as the number of rollover files:

1. Stop the Management Agent.

   See Also:

   "Starting, Stopping, and Checking the Status of the Management Agent on UNIX"

2. Locate the emagentlogging.properties file in the following directory:

   AGENT_HOME/sysman/config
   
   

3. Open the emagentlogging.properties file with a text editor and modify the entries described in Table 8-3.

4. Restart the Management Agent.

8.1.7 Controlling the Contents of the Fetchlet Trace File

By default, the Management Agent will save all critical and warning messages generated by the Management Agent fetchlets to the emagentfetchlet.trc file. However, you can adjust the amount of logging information that the fetchlets generate.

To change the amount of tracing information generated by the Management Agent fetchlets:

1. Stop the Management Agent.

   See Also:

   "Starting, Stopping, and Checking the Status of the Management Agent on UNIX"

2. Locate the emagentlogging.properties file in the following directory:

   AGENT_HOME/sysman/config
   
   

3. Open the emagentlogging.properties file with a text editor and locate the following entry:

   log4j.rootCategory=WARN, emagentlogAppender, emagenttrcAppender
   
   

4. Change the value of the log4j.rootCategory parameter to one of the values shown in Table 8-2.

   Note:

   The the values described in Table 8-2 are case-sensitive.

5. Restart the Management Agent.

8.2.1 About the Management Service Log and Trace Files

Oracle Management Service log and trace files store important information that support personnel can later use to troubleshoot problems. The Management Service uses two types of log files:

• The Management Service log file (emoms.log)

  The Oracle Management Service saves information to the log file when the Management Service performs an action (such as starting or stopping) or when the Management Service generates an error.

• The Management Service trace file (emoms.trc)

  The Management Service trace file provides an advanced method of troubleshooting that can provide support personnel with even more information about what actions the Management Service was performing when a particular problem occurred.

8.2.2 Locating the Management Service Log and Trace Files

The Management Service log and trace files are stored in the following directory inside the Oracle Application Server Home where the Oracle Management Service is installed and deployed:

AS_HOME/sysman/log/

8.2.3 Controlling the Size and Number of Management Service Log and Trace Files

The Management Service log and trace files increases in size over time as information is written to the files. However, the files are designed to reach a maximum size. When the files reach the predefined maximum size, the Management Service renames (or rolls) the logging information to a new file name and starts a new log or trace file. This process keeps the log and trace files from growing too large.

As a result, you will often see multiple log and trace files in the Management Service log directory. The following example shows one archived log file and the current log file in the AS_HOME/sysman/log directory:

emoms.log
emoms.log.1

To control the maximum size of the Management Service log and trace files, as well as the number of rollover files:

1. Stop the Management Service.

   See Also:

   "Controlling the Oracle Management Service"

2. Locate the emomslogging.properties file in the following directory:

   AS_HOME/sysman/config
   
   

3. Open the emomslogging.properties file with a text editor and modify the entries described in Table 8-4.

4. Restart the Management Service.

8.2.4 Controlling the Contents of the Management Service Trace File

By default, the Management Service will save all critical and warning messages to the emoms.trc file. However, you can adjust the amount of logging information that the Management Service generates.

To change the amount of logging information generated by the Management Service:

1. Stop the Management Service.

   See Also:

   "Controlling the Oracle Management Service"

2. Locate the emomslogging.properties file in the following directory:

   AS_HOME/sysman/config
   
   

3. Open the emomslogging.properties file with a text editor and locate the following entry:

   log4j.rootCategory=WARN, emlogAppender, emtrcAppender
   
   

4. Modify the value of the log4j.rootCategory parameter to one of the values shown in Table 8-2.

   Note:

   The values described in Table 8-2 are case-sensitive.

5. Restart the Management Service.

8.2.5 Controlling the Oracle Application Server Log Files

The Management Service is a J2EE application running in an Oracle Application Server Containers for J2EE (OC4J) instance within the Application Server. Different components of the Application Server generate their own log files. These files contain important information that can be used later by support personnel to troubleshoot problems.

Table 8-5 lists the location of the log files for some components.

Refer to the Oracle Application Server Administrator's Guide for instructions on controlling the size and rotation of these log files.