Trace Messages

Trace messages provide information about adapter activities. The messages are logged to the console where the runtime adapter is started and to a log file. Trace messages can also be redirected to the TIBCO Hawk Display application, or sent to other applications using the TIBCO Rendezvous transport.

Each trace message includes the following fields:

<Timestamp> <Adapter Identifier> <Role> <Category> <Status Code> <Tracking Identifier>

You can check the following table for the fields and corresponding description:

Field Description
Timestamp The timestamp of occurrence. For example,2014 Feb 22 20:14:51:718 GMT -8.
Adapter Identifier The name of the adapter that writes the trace message. This is a combination of the adapter acronym and adapter configuration name. For example, the application identifier, ADFILES.publisher1 identifies a TIBCO ActiveMatrix Adapter for Files for Unix/Win (TIBCO Business Studio) service named publisher1.
Role Info, Warn, Error, and Debug are available roles.
  • Info: indicates normal adapter operation. No action is necessary. A trace message tagged with info indicates that a significant processing step is reached and has been logged for tracking or auditing purposes. Only info messages preceding a tracking identifier are considered significant steps.
  • Warn: indicates an abnormal condition was found. Processing continues, but special attention from an administrator is required.
  • Error: indicates an unrecoverable error occurred. Depending on the error severity, the adapter continues with the next operation or stops altogether.
  • Debug: indicates a developer defined trace message. In normal operating conditions, debug messages are not displayed.

When configuring the adapter, you can define what roles are logged, what roles are not logged. For example, to improve performance, you can decide not to log Info roles.

Category Trace message can be grouped as one of the following categories:
  • Adapter: the adapter is processing an event.
  • Configuration: the adapter is reading configuration information.
  • Palette: the adapter is interacting with the palette.
  • Publication: Publication Service is reporting this trace message.
  • Shutdown: the adapter is shutting down.
  • Startup: the adapter is starting.
  • Subscription: Subscription Service is reporting this trace message.
  • System: this category is not linked to a specific event process. The trace message might be related to a Windows Service related messages, memory allocation, file system error, and so on.
  • TibRvComm: the adapter is communicating with TIBCO Rendezvous.
Status Code Unique code for the message and description. Status codes are identified by a unique number and description. If a trace message includes an error or warn role, the status code documentation includes a resolution. See General Status Messages.
Tracking Identifier A unique identifier that is "stamped" on each message by the original adapter. The tracking identifier remains in effect from the beginning of a message to its completion as it is exchanged by TIBCO applications. If the adapter is the termination point of the message, the tracking identifier is not displayed in the trace message. You cannot modify the tracking identifier format or configure what information to be displayed.