Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Predefined logging configuration of a resource adapter

&pagelevel(4)&pagelevel

Logging in the resource adapter is preconfigured with the following default values in the file BeanConnect.log4j2.properties.xml (see Configuring logging for BeanConnect resource adapter and proxy).

Appender

Name

Description and Recommendation

BeanConnectSysoutShort

Console appender with the destination System.out and “short” output format, i.e. without a specification of the message source.
At this appender, BeanConnect outputs messages on the resource adapter configuration as well as warnings and error messages.

This appender has three parameters:

  • name
    BeanConnectSysoutShort

  • PatternLayout/pattern
    %d{ISO8601} %c{1}: %-5p - %m%n

  • target
    SYSTEM_OUT

Recommendation:
No further loggers should be assigned to this appender.

BeanConnectShortLoggingFile

Rolling file appender for logging to a file with several backup files (see How the rolling file appender works) and "short" output.
The same information is output to this appender that is sent to BeanConnectSysoutShort.
At this appender, BeanConnect outputs messages on the resource adapter configuration as well as warnings and error messages.

This appender has six parameters:

  • DefaultRolloverStrategy/max
    Maximum number of backup files. If you specify 0 here, no backup files are created.
    Default: 10

  • fileName
    (Relative) file name of the current logging file
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator}BeanConnect.logging.txt

  • filePattern
    (Relative) file name of the backup files
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator}BeanConnect.logging.%i.txt

  • name
    BeanConnectShortLoggingFile
  • PatternLayout/pattern
    %d{ISO8601} %-5p %c - %m%n
  • Policies/SizedBaseTriggeringPolicy/size
    The maximum size in KB that the output file is allowed to reach before being rolled over to backup files.
    Default: 1024

Recommendation:

No further loggers should be assigned to this appender. However, the user may increase the level for the BeanConnect.ui logger if necessary (i.e. from WARN to INFO, DEBUG or TRACE).

BeanConnectLoggingFile

Rolling file appender for logging to a file with several backup files (see How the rolling file appender works) and, in contrast to BeanConnectShortLoggingFile, more output with technical details.
This appender is used for system diagnosis. If necessary, BeanConnect writes detailed diagnostic log information to this appender.

This appender has six parameters:

  • DefaultRolloverStrategy/max
    Maximum number of backup files. If you specify 0 here, no backup files are created.
    Default: 10

  • fileName
    (Relative) file name of the current logging file
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator} BeanConnect.extlogging.txt

  • filePattern
    (Relative) file name of the backup files
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator}BeanConnect.extlogging.%i.txt

  • name
    BeanConnectLoggingFile
  • PatternLayout/pattern
    %d{ISO8601} %-5p %x %t %c [%F %M %L] - %m%n
  • Policies/SizedBaseTriggeringPolicy/size
    The maximum size in KB that the output file is allowed to reach before being rolled over to backup files.
    Default: 1024

Recommendation:
No further loggers may be added to this appender. If necessary, users should be able to increase the level for the BeanConnect.ui logger (i.e. from WARN to INFO, DEBUG or TRACE, see Logging of user interface calls) on their own initiative, i.e. without consulting the system diagnostics.

BeanConnectLoggingFileXML

Rolling file appender for logging to a file with several backup files (see How the rolling file appender works). The output of this appender has an XML-like layout. The file is provided for input to the Management Console (see also Display the Log4j logging file using the BeanConnect Management Console).
The same information is output to this appender that is sent to the appender BeanConnectLoggingFile. This appender is used for system diagnosis. If necessary, BeanConnect writes detailed diagnostic log information to this appender.

This appender has six parameters:

  • DefaultRolloverStrategy/max
    Maximum number of backup files. If you specify 0 here, no backup files are created.
    Default: 10

  • fileName
    (Relative) file name of the current logging file
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator} BeanConnect.extlogging.txt.xmc

  • filePattern
    (Relative) file name of the backup files
    Default: ${sys:BeanConnectLoggingDirectory}${sys:file.separator}BeanConnect.extlogging.txt.%i.xmc

  • name
    BeanConnectLoggingFileXML
  • Policies/SizedBaseTriggeringPolicy/size
    The maximum size in KB that the output file is allowed to reach before being rolled over to backup files.
    Default: 1024

  • XMLLayout/locationInfo
    Always true.

Recommendation:
No further loggers may be added to this appender. If necessary, users should be able to increase the level for the BeanConnect.ui logger (i.e. from WARN to INFO, DEBUG or TRACE, see Logging of user interface calls) on their own initiative, i.e. without consulting the system diagnostics.




BeanConnectMCSocketAppender



Socket appender used to log to the Management Console.

This appender has five parameters:

  • host
    Host where the Management Console is running.
    Default: localhost

  • name
    BeanConnectMCSocketAppender
  • port
    Listener port of the Management Console.
    Default: 31015

  • ReconnectionDelayMillis
    Positive Ganzzahl, die die Anzahl der Millisekunden angibt, die nach einem fehlgeschlagenen Verbindungsversuch zum Server vor einem erneuten Versuch gewartet werden soll.
    Standard: 10000
  • XMLLayout/LocationInfo
    Always true.

Recommendation:
No further loggers should be added to this appender.

BeanConnectManagementConsole

Async Appender for logging to the Management Console.

Recommendation:
Loggers that are to be displayed at the Management Console should be added to this appender.

Loggers

You are recommended not to change the logger settings - with the exception of the logger BeanConnect.ui.

Name

Description

BeanConnect

Parent logger of all the other BeanConnect loggers
Level: WARN

BeanConnect.in

Logger for BeanConnect inbound communication.

BeanConnect.info

Logger for runtime information
Level: INFO

BeanConnect.out

Logger for BeanConnect outbound communication.

BeanConnect.ui

Logger for the BeanConnect user interface calls
Level: WARN
In the default configuration, the output of the logger BeanConnect.ui
is sent to the appenders BeanConnectShortLoggingFile,
BeanConnectLoggingFile, BeanConnectLoggingFileXML.

de.siemens

net.fsc

Parent loggers of all class-specific BeanConnect loggers that serve to
output debug traces
Level: WARN




net.fsc.beanta.encoding



Logger for BeanConnect's encoding support
Level: WARN