Configuring custom log messages to help resolve bugs

To identify the section of a log file that contains statements or messages that are relevant to product use, problem creation, or a debugging activity, you can configure custom log messages. You specify start and end messages that are included in the log file. You can review the statements or messages that are shown in between the custom log start and end messages in the log file to help you trace a scenario or resolve an issue.

Before you begin

If you want to change any details of the custom messages that display in a log file, such as the prefix or message text, open the Database Configuration application. Select the Messages action. Filter for the begincustomlog or endcustomlog message, modify the message, and save the record.

About this task

Log files that are tagged with start and end messages can help product support organizations to more easily trace application actions and isolate potential issues.

Procedure

  1. In the Logging application click Configure Custom Log Messages on the toolbar.
  2. In the Configure Custom Log Messages window, specify any comments that you want included in the start and end sections of the log file.
  3. Take note of the error message numbers for the start and end messages so that you can search for them in the log file later.
  4. To inject the Start message into the log file to trace a scenario, click Start Writing to the Log File.
  5. Perform the actions.
  6. To inject the End message to stop writing to the log file, click Stop Writing to the Log File. The log information that is captured between the start message and the end message can be reviewed.
  7. Navigate to the location where the log file is saved.
  8. Open the log file in a text editor and search for the start and end messages.
  9. Review the statements and messages that are shown between the two messages to trace the scenario or resolve the issue.


Feedback