Adding, Editing, and Removing Log Controllers

Use

Log controller is a Java object that manages the writing of log and trace messages.

Two types of controllers are available:

  • Location - describes messages that originate from source code areas, and is used to emit trace messages.

  • Category - describes messages specific to distinguished problem areas, and is used to emit log messages. Typical problem areas are databases, networking, security auditing, and others.

This procedure helps you manage your log categories and trace locations.

The configuration steps are one and the same for both categories and locations. That is, the steps below are described for log controllers as a whole.

Prerequisites

Start the Config Tool by double-clicking the configtool script file in <SAP_install_dir>/<system_name>/<instance_name>/j2ee/configtool directory.

Procedure

Adding a New Controller

  1. Choose Start of the navigation pathcluster  Next navigation step  <template_name> / <instance number> Next navigation step  log configurationEnd of the navigation path.

  2. Expand the categories or locations node and choose the Root Category or Root Location, respectivly. The new element is added as a subnode inside the selected tree structure.

    To add a new category/location in a particular position inside the tree structure, browse to that position and select the node under which the new category/location will be inserted. Have in mind that you need to select an already existing controller. Controllers are represented with a blue circle icon, while other nodes from the three have a white circle icon and do not represent an existing log controller.

  3. Choose New and then enter the complete name for the new log controller.

    • Categories are named according to the hierarchical structure known from file systems. The different hierarchical levels in a category name must be separated by " / ", For example, /System/Database (always starts with "/").

    • Locations are labeled according to the hierarchical structure known from Java packages. The " . " character is used to demarcate the different layers in locations names. For example, com.sap.yourPackage.Class .

  4. Choose OK.

    The new controller is added to the tree.

Editing a Controller

  1. Select the controller you want to edit.

  2. In Severity dropdown box, choose the level of severity.

    More information: Appendix A: Severity Levels

  3. You can specify a destination where the log/trace messages to be written. To add one or more destinations, choose Add.

    Select a destination and then choose OK.

  4. To remove a destination, choose Remove.

  5. Choose Apply Changes.

  6. To return the original configuration from the AS Java installation, choose Reset to Inherited Configuration.

Removing a Controller

  1. Select the controller you want to delete and choose Remove

  2. Choose Apply Changes.