Configuring Log ControllersLocate this document in the navigation structure

Use

Using the procedures below you can:

  • Configure at runtime the severity of log controllers, the whole system tree, and a certain system instance

  • Perform sophisticated filtering of log controllers

Before changing the severity of a log controller, bear in mind that:

  • If you change the severity of a log controller at a system (template) level, the new severity will be valid on all instances for this log controller.

  • If you change the severity of a log controller for a particular instance, and this severity is different from the ones on the other instances, the change will be valid only for the particular instance.

    Note

    You can still set a uniform system severity as either setting such as for the tree or equalizing the instance severities in the Per Instance Configuration tab.

Prerequisites

Open SAP NetWeaver Administrator and choose Start of the navigation path Troubleshooting Next navigation step Logs and Traces  Next navigation step  Log Configuration End of the navigation path.

Procedure

Searching for Log Controllers

  1. From the Show dropdown box, choose Logging Categories or Tracing Locations , respectively.

  2. In the Category or Location field, enter a keyword to find the log controller(s) you need. Asterisk (*) is a valid entry.

  3. Choose Go .

    The search result displays a window with all the relevant log controllers. When you select some of them, it displays the log controller within the tree navigation.

Sophisticated Filtering

  1. Choose Open Filter .

  2. In the Category or Location field, enter a keyword for the log controller(s) you need.

  3. From the Severity field, select a comparative method and the relevant severity level.

  4. To search by a specific severity case, select an option from Severity Origin :

    • Persisted Configuration - shows log controllers whose severity is persisted (by you or another user)

    • Inherited from Parent - shows children that inherit the parent's severity which has been previously persisted

    • Troubleshooting Session - shows log controllers whose severity concerns an enabled debug session. This debugging task refers from the Application Manager tool in SAP NetWeaver Administrator.

    • Runtime Override - shows log controllers whose severity has been illegally set through SAP Logging API via an application.

  5. In the File Name field, enter the name/part of the name of the log file.

  6. Choose Apply Filter .

  7. To remove the current search data, choose Clear Filter .

Changing the Severity of a Log Controller

  1. In Logging Categories or Tracing Locations pane, from the tree structure, choose the log controller you want to configure.

  2. From the Severity dropdown box, choose a severity level.

  3. If you want this severity to be relevant to its children log controllers, choose Copy To Sub-Tree .

    Note

    If this severity level is lower than the default one, a warning window appears.

  4. If you want this changed reference for the children to be valid only for the current filter, choose Copy to Filtered Sub-Tree .

  5. To find all destinations assigned to the selected log controller on system level, choose Start of the navigation path System Configuration Next navigation step Destinations End of the navigation path.

  6. If you want to reset the severity of the selected log controller to its default value, choose Reset Category or Reset Location .

  7. Choose Save Configuration .

More information:

You can see the log records of this severity configuration. To do that, choose Start of the navigation path Related Links  Next navigation step Log Viewer  End of the navigation path and then, choose Start of the navigation path View  Next navigation step Open View  Next navigation step Change Log End of the navigation path.

Configuring Log Controllers per Instance

  1. Choose the Per Instance Configuration tab.

  2. The Instance ID column now displays the ID numbers of the relevant instances for the selected controller.

  3. From the Severity column, choose the new severity. This change will be valid for all instances on the cluster.

  4. Select an instance.

    Its details appear in the table below, displaying the destinations of the selected controller.

Restoring the Log Configuration

  1. Select the relevant log controller.

  2. Choose Default Configuration .

    Note

    The default severity for categories is INFO, and for locations is ERROR.

  3. Confirm your choice.