Show TOC

Procedure documentationConfiguring Tracing Locate this document in the navigation structure

 

You use the tracing function to analyze, in detail, errors found in logging and monitoring.

Trace information is technical information – for example, header information - but it is also about business information (payloads).

The tracing information is available only in English. The tracing configuration is client-specific.

Prerequisites

To configure tracing, your user must be assigned one of the following roles.

  • SAP_BC_WEBSERVICE_ADMIN_BIZ

  • SAP_BC_WEBSERVICE_ADMIN_TEC

These roles provide authorization for the authorization object S_WS_LGTRC with activity 36.

More information: Authorizations

Procedure

  1. Start SOA Management (transaction SOAMANAGER), and choose the tab Logs and Traces and Trace Configuration.

  2. You can specify the following information:

    The system uses the following information to assign trace information at runtime to specific service calls:

    • Expiry time (in seconds)

      Specify the analysis period in seconds.

      The default is five minutes.

    • Specify the user name used to execute the Web service in the SOAP runtime.

      If you leave the field empty, the system creates a trace for all users.

    • Enter the interface for whose calls the system is to create a trace in the SOAP runtime.

    This information influences tracing at runtime:

    • Trace Pattern

      This entry is relevant if tracing is activated using the API.

    • Choose the trace level:

      • Inactive (internal 0)

        Tracing is switched off.

      • Error (internal 1)

        Tracing is triggered if a processing error occurs.

        This is the default.

      • Payload trace (internal 2)

        A message-payload dump is created and trace files are written for the main processing components of the SOAP runtime.

      • Full trace (internal 3)

        A trace status and trace files are created for all sub-components of the SOAP runtime.

    • To copy the trace export, choose Trace.

    • To export the trace from the SOAP header of the service consumer to the service provider, choose Export Trace.

  3. To reset tracing to the default value, choose Reset to Default Tracing.

  4. To switch off tracing, choose Switch Tracing Off.

    Even if there is an error, the system will not create a trace.

Result

If you create an entry without specifying a user name and interface in the configuration table, tracing is activated for all users and interfaces during the SOAP runtime.

If you have made multiple entries in the table that overlap, the SOAP runtime will always apply the entry that leads to the greatest limitations.