Diagnostic trace service settings
To view this page, click Troubleshooting > Logs and Trace > server > Diagnostic trace.
Configuration tab
- Enable Log
Enables the log service.
If this option is not selected, the following configuration properties are not passed to the application server trace service at server startup.
- Trace Output
Specifies where trace output should be written.
The trace output can be written directly to an output file, or stored in memory and written to a file on demand using the Dump button found on the run-time page.
- Memory Buffer
- Specifies that the trace output should be written to an in-memory circular buffer. If you select this option specify the following parameters:
- Maximum Buffer Size
- Number of entries, in thousands, that can be cached in the buffer. When this number is exceeded, older entries are overwritten by new entries.
- Dump File Name
- The name of the file to which the memory buffer will be written when it is dumped. This option is only available from the Runtime tab.
- File
- Specifies to write the trace output to a self-managing log file.
The self-managing log file writes messages to the file until the specified maximum file size is reached. When the file reaches the specified size, logging is temporarily suspended and the log file is closed and renamed. The new name is based on the original name of the file, plus a timestamp qualifier that indicates when the renaming occurred. Once the renaming is complete, a new, empty log file with the original name is reopened, and logging resumes. No messages are lost as a result of the rollover, although a single message may be split across the two files.
If you select this option specify the following parameters:
- Maximum File Size
- Specifies the maximum size, in megabytes, to which the output file is allowed to grow.
This attribute is only valid if the File Size attribute is selected. When the file reaches this size, it is rolled over as described above.
- Maximum Number of Historical Files
- Specifies the maximum number of rolled over files to keep.
- File Name
- Name of the file to which the trace output is written.
- Trace Output Format
Specifies the format of the trace output.
We can specify one of three levels for trace output:
- Basic (Compatible)
- Preserves only basic trace information. Select this option to minimize the amount of space taken up by the trace output.
- Advanced
- Preserves more specific trace information. Select this option to see detailed trace information for use in troubleshooting and problem determination.
- Log Analyzer
- Preserves trace information in a format that is compatible with the Log Analyzer tool. Select this option if you want to use the trace output as input to the Log Analyzer tool.
Runtime tab
- Runtime tab
Specifies the format of the trace output.
- Save changes to configuration
- Save changes made on the runtime tab to the trace configuration as well.
Select this box to copy run-time trace changes to the trace configuration settings as well. Saving these changes to the trace configuration will cause the changes to persist even if the application is restarted.
- Trace Output
Specifies where trace output should be written.
The trace output can be written directly to an output file, or stored in memory and written to a file on demand using the Dump button found on the run-time page.
- Memory Buffer
- Specifies that the trace output should be written to an in-memory circular buffer. If you select this option specify the following parameters:
- Maximum Buffer Size
- Number of entries, in thousands, that can be cached in the buffer. When this number is exceeded, older entries are overwritten by new entries.
- Dump File Name
- The name of the file to which the memory buffer will be written when it is dumped. This option is only available from the Runtime tab.
- File
- Specifies to write the trace output to a self-managing log file.
The self-managing log file writes messages to the file until the specified maximum file size is reached. When the file reaches the specified size, logging is temporarily suspended and the log file is closed and renamed. The new name is based on the original name of the file, plus a timestamp qualifier that indicates when the renaming occurred. Once the renaming is complete, a new, empty log file with the original name is reopened, and logging resumes. No messages are lost as a result of the rollover, although a single message may be split across the two files.
If you select this option specify the following parameters:
- Maximum File Size
- Specifies the maximum size, in megabytes, to which the output file is allowed to grow.
This attribute is only valid if the File Size attribute is selected. When the file reaches this size, it is rolled over as described above.
- Maximum Number of Historical Files
- Specifies the maximum number of rolled over files to keep.
- File Name
- Name of the file to which the trace output is written.