Sub log behavior - SchwarzIT/sap-usi-logging-api GitHub Wiki

Table name: /USI/BAL_SL_BEHA
Maintained via: SM30

Generally, the API prevents log fragmentation to simplify support. The underlying concept is explained here.

Log fragmentation can be prevented in different ways:

  • Reuse: A log writer, once created, can be reused everywhere so that all API consumers write to the same log.
  • Linking: Each consumer creates its own log writer, and the logs are linked via trace messages that allow navigation between them.

The desired behavior for each log object and sub-object can be configured in this table.

The settings are evaluated whenever a new log writer is requested from the factory.

Structure

The structure of all customizing tables has been documented in a unified format.

General Information explains how this documentation is to be read.

Fieldname Fieldtype Filter-Priority Description
LOG_OBJECT Filter 1 Log object
SUB_OBJECT Filter 2 Sub object
BEHAVIOR Data Desired behavior

Available behaviors

Currently four different behaviors are available.

Technical value Short Description Creates new logger, if
0 Create new logger ALWAYS
3 Reuse existing logger, if Log Object & Subobject match No logger existed before or the previously created logger has a different combination of Log-Object and Subobject
6 Reuse existing logger, if Log Object matches No logger existed before or the previously created logger has a different Log-Object
9 Reuse existing logger No logger existed before

Dependencies

Linking logs via trace messages will only work, if the data containers /USI/CL_BAL_DC_PARENT_LOG and /USI/CL_BAL_DC_CHILD_LOG are relevant on log level 1!

A description of that customizing can be found here:
Customizing -> Log Levels -> Relevant Data containers

The recommended settings can be taken from the installation guide.
Installation Guide -> Maintain Basic Customizing

Defaults

If no suitable customizing can be found, the following default values will be applied.

Fieldname Default
BEHAVIOR 0 (Create new logger)
⚠️ **GitHub.com Fallback** ⚠️