Configuring Logs and Traces
Use
You can use the SAP NetWeaver Administrator to create categories and locations and to configure the following logging parameters:
● Severity levels – An important part of any log and trace message is its severity. This denotes the level of importance or relevance of a certain message. Log and traces can be limited to certain severity levels, that is, only data of a defined severity is collected. The order of the constants is, with increasing severity:
○ DEBUG – For debugging purpose, with extensive and low level information
○ PATH – For tracing the execution flow, for example, used in the context of entering and leaving a method, looping and branching operations
○ INFO – Informational text, mostly for echoing what has already been performed
○ WARNING – The application can recover from an anomaly and fulfill the required task, but needs attention from a developer/operator
○ ERROR – The application can recover from an error, but it cannot fulfill the required task due to the error
○ FATAL – The application cannot recover from an error, and the severe situation causes fatal termination
Categories and locations are associated with a severity. This acts as a filter where only those messages that are of equal or higher severity can pass.
● Destinations – You can manage the destination where the messages are written to. The log destination is also the object to which you specify and assign an appropriate formatter for the log, as well as multiple optional filters.
For more
information about log destinations, see
Log (Destination)
in the SAP Logging API Tutorial.
Procedure
...
1. Open the SAP NetWeaver Administrator.
2. Choose System Management → Configuration → Log Configuration.
3. From the Show dropdown box, select either Logging Categories or Tracing Locations.
You can also use the Get dropdown box and the field next to it for a more precise search.
Another alternative is to use the Open Filter option for a more sophisticated search of a particular location or category.
4. From the tree structure, select a particular element, a whole node or subnode you want to configure.
The following configuration options are available:
Activity |
Steps |
Define a Severity on the Entire System |
... 1. Choose the Log Configuration field. 2. In the Logging Categories or Tracing Locations pane, from the Severity dropdown box, select the severity level you want to set to the selected node, subnode, or element. 3. Choose Save Configuration. The following additional options are available when defining severity levels: ● Reset to Default – traverses the subtree of existing controllers and restores the default severity for each of them. ● Copy to Sub Tree – use this option if you are changing the severity of the root node for the whole tree or a particular subtree and you want the change to effect all nodes below this root node. |
Create Category / Create Location |
... 1. Choose the Log Configuration field. 2. Choose Create Category or Create Location. 3. Specify the name and the severity level of the new category or location. 4. Choose Save Category or Save Location. 5. Choose Save Configuration. |
Add a Destination on the Entire System |
... 1. Choose the System Configuration tab. 2. In the Destinations pane, choose Add Destination. 3. From the Choose File Name Pattern dropdown box, select a pattern from the already available ones. 4. In the Write File Name Pattern field, specify the path to the file where messages are written. 5. In the Files Count field, specify the maximum number of file pieces in the rotating file set for this destination. When the size of the first file reaches the limit specified in the File Size Limit field, the system starts to write in the second one. This procedure is executed until all specified files are full, then the system starts to write again in the first file, that is, overwrites the first one. 6. In the File Size Limit field, specify the maximum number of bytes each file piece of the rotating file set can contain. 7. Choose Save. 8. Choose Save Configuration. |
Per Cluster Node Configuration |
... 1. Choose the Per Cluster Node Configuration tab. This tab displays the configuration the selected element has on each cluster node. Therefore, you can use this tab to change the configuration of the selected element on one cluster node only. 2. Select a cluster node. You have the same configuration options as the ones that are available on the System Configuration tab. Use this option to change the severity level, create a category or location or change or add a destination. If you want to add a destination from this tab, you can specify a separate destination on the selected cluster node on which the logs to be written exclusively for this node. |
Reset the Entire Log Configuration to the Default One |
Choose Default Configuration.
Bear in mind that, as a result, some controllers can be created or deleted. |
