Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WADMINPAS and version 24.1
Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameinfo_xuml_services
PageWithExcerptINTERNAL:_admin_portal_excerpts

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamexuml_services_change_log_level
PageWithExcerptINTERNAL:_admin_portal_excerpts
In the administration application you have the possibility to change the log level for a containerized xUML service.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamechange_docker_log_level_icon
PageWithExcerptINTERNAL:_admin_portal_excerpts

Image Modified

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamechange_docker_log_level_details
PageWithExcerptINTERNAL:_admin_portal_excerpts

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamexuml_services_info_logging_concept
PageWithExcerptINTERNAL:_admin_portal_excerpts

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamexuml_services_section_logs
PageWithExcerptINTERNAL:_admin_portal_excerpts

Info

The logging concept of the xUML Runtime is build around the concepts of channels and sinks. Refer to xUML Runtime Logger Configuration for detailed information.

In sections Logs, you can choose between two channels:

  • error to write service logging data.
  • access to write transaction logging data.

    The link below gives you direct access to the Log Analyzer, refer to Showing Logs of a Containerized xUML Service and Analyzing Platform Logs for further information.

    Image Modified

    Select a channel to open the related channel sinks. Sinks define the logging output and how it is written. Refer to xUML Runtime Logger Configuration for

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamexuml_services_sinks
    PageWithExcerptINTERNAL:_admin_portal_excerpts
    detailed information.

    You can choose between two channel sinks:

    • default for the console of the Docker container (for experienced Docker users only).
    • fluent for the log information sent to KibanaLog Analyzer (OpenSearch).

    Image Modified

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamexuml_services_sink_level
    PageWithExcerptINTERNAL:_admin_portal_excerpts

    On the sink level, you can now adapt:

    Note

    Please note that changes of the log level are directly applied to the container. They are effective until a restart or a recreation of the container which is also the case when the service settings are changed.

    Image Modified

    Use icon Image Removed to add more filters.

    Click icon Image Removed to delete single filters.

    Log Levels of an xUML Service

    The following server log levels can be set for each xUML service. The higher the log level the more information will be written to the log files. The log levels in the table below are cumulative and are ordered from the lowest to the highest log level. For each log level, also the information of the lower levels is logged.

    Log LevelDescription
    NoneNo logging will be executed.
    FatalFatal errors are logged.
    The component cannot continue with normal execution. Examples: repository errors, system limitations like no more available threads or memory. These errors need the intervention of an administrator to solve the problem.
    ErrorAlso non-fatal errors are logged.
    If the UML modeler catches these errors, they are not written to the log. Examples are connection errors, wrong SQL statements, applying operations to invalid values, and so forth.
    Errors of this category are further classified:
    • User Errors: Exceptions explicitly thrown in the UML model.
    • External Errors: IO exceptions, such as problems when connecting a backend, wrong input formats, and so forth.
    • Internal Errors: Operations cannot be executed, because of internal problems, e.g. unexpected NULL values, full queues, and so on.
    WarningWarnings are logged.
    Warnings indicate unexpected but non-critical situations that do not interrupt normal operation.
    InfoGeneral information is logged.
    This includes, for instance, which component is being started or stopped, loaded add-ons, licensing information, etc.
    Debug

    In addition to log level Info, detailed trace information is written into an error file specified in the error message.
    Furthermore, the full communication stream when using the URL or SOAP adapter is written to the xUML service standard log.

    Note
    iconfalse
    Use this log level with care and only when investigating problems. As all tracing information has to be logged, it may result in significant loss of performance with increasing complexity of the deployed xUML service.
    Note
    iconfalse

    If an error occurred, a call stack is written into the error log exposing the path to the action state where the error occurred in the model.
    [2006-04-20 08:31:13 W. Europe Standard Time][Error] [Internal][FUASM][3][Division by zero - Callstack: calculate > Calculation > call_Division > Division > Divide]

    Transaction Log Levels

    The following transaction log levels can be set for each xUML service. The higher the log level the more information will be written to the log files. The log levels in the table below are cumulative and are ordered from the lowest to the highest log level. For each log level, also the information of the lower levels is logged.

    Log LevelDescription
    NONENo logging will be executed.
    CUSTOMLogs everything that is written by the logger adapter.
    SERVICELogs the start and the end of calls to a service operation (service interface). For example, calls to SOAP, SAPRFC, or HTTP operations.
    IO_EXTERNALLogs calls of adapters that communicate with external systems like SAP, SQL, SOAP, etc. For instance, the SQL queries that are sent to the database will be logged as well. Calls via the file system and system adapter are excluded.
    IO_INTERNALLogs also calls of adapters to internal (local) resources (file system adapter and system adapter).

    Logging also includes start and end time of service calls and can be used to analyze process performance.

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamexuml_services_sink_filter_options
    PageWithExcerptINTERNAL:_admin_portal_excerpts

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamedefault_log_files
    PageWithExcerptINTERNAL:_admin_portal_excerpts

    Log Levels of an xUML Service

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamexuml_standard_log_levels
    PageWithExcerptINTERNAL:_general_excerpts_big
    shouldDisplayInlineCommentsInIncludesfalse

    Transaction Log Levels

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamexuml_transaction_log_levels
    PageWithExcerptINTERNAL:_general_excerpts_big
    shouldDisplayInlineCommentsInIncludesfalse