Logging Tab

Use the Logging tab to manage and configure log sinks.

The adapter defines traces with different roles and sends them to log sinks with the corresponding role. You can either use the default standard I/O for logging or fine-tune where and when different types of information are sent by defining sinks and mapping each sink to one or more roles.

TIBCO ActiveMatrix Adapter for SAP supports the following log sinks at run time:
  • File Sink

    A file sink sends messages to a file.

  • Standard I/O Sink

    A stdio sink sends messages to standard I/O.

  • Network Sink

    A network sink sends messages over the network.

  • Hawk Sink

    A Hawk sink sends messages to TIBCO Hawk®.

All Log Sinks Panel

If you are using custom roles, use the All Log Sinks panel to add or remove log sinks and their roles as described in Adding Log Sinks.

Configuration Panel

In the Configuration Panel of a sink, you can specify the logging options for the sink.

The following is the Configuration Panel:
Field Description
Name Specify the sink name.

The default name is filetSink, stdioSink, networkSink, or hawkSink, depending on the sink type.

Description Enter a description for the sink.
The following fields are available for the file sink:
File Name Specify the location and name of the trace file.
File Limit (bytes) Specify the maximum size of the file in bytes.

The default value is 30000.

File Count Specify the number of rollover files.

The default value is 3.

Append Mode Select this check box to add traces to the existing file at startup.

Clear this check box to overwrite the existing file at startup if one of the same name exists.

This check box is selected by default.

The following fields are available for the stdio sink:
Output Stream Select a information type from the following options:
  • stdout

    General output information

  • stderr

    Error information

The default value is stdout.

The following fields are available for the network sink:
Subject Specify the subject of TIBCO Rendezvous messages to be sent.
Session Reference Click to select a transport session.
The following fields are available for the Hawk sink:
MicroAgent Name Specify the name of the microagent for traces from the Hawk sink.

Log Level Panel

In the Log Level panel, you can specify a log level. Different log level defines different trace messages.

The following is the Log Level panel:

Field Description
Log To Standard I/O Select this check box to use the console window for logging when you start the adapter configuration.

You can send the information to multiple locations, and you can choose to log one or more message types.

This check box is selected by default

Log Info Messages Select this check box to send all messages of type INFO to the specified locations.

This check box is selected by default.

Log Debug Messages Select this check box to send all messages of type DEBUG to the specified locations.

This check box is cleared by default.

Log Warning Messages Select this check box to send all messages of type WARNING to the specified locations.

This check box is selected by default.

Log Error Messages Select this check box to send all messages of type ERROR to the specified locations.

This check box is selected by default.

Note: Turning on the log level can affect the performance of the adapter configuration. It is good practice to turn on the required levels only. Do not select the DEBUG level unless it is requested by the TIBCO Product Support Group. This option writes much debugging information to the log file and significantly reduces the speed of the adapter configuration.