Adapter Runtime Logging and Exception Handling

Overview

The Adapter Runtime uses the Integration Server logging mechanism to log messages. You can configure and view Integration Server logs to monitor and troubleshoot the Adapter Runtime. For detailed information about logging in Integration Server, including instructions for configuring and viewing the different kinds of logs supported by the server, see webMethods Integration Server Administrator’s Guide and webMethods Audit Logging Guide .

Adapter Runtime Message Logging

Integration Server maintains several types of logging. However, the Adapter Runtime logs messages only to the error, server, and service logs.

The following table lists the logging types supported by Integration Server for the Adapter Runtime.

Logger	Description
Error	Provides stack trace information about all errors that occur in the Adapter Runtime, including exceptions thrown by services. Adapters automatically post fatal-level and error-level messages to the Adapter Runtime error log.
Server	Provides information about fatal-level through debug-level log messages. Trace-level log messages appear as messages for an individual adapter.
Service	Provides information about adapter services. You can monitor adapter services as you would audit any service in Integration Server. The audit properties for an adapter service are available in each adapter service template in the Properties panel.

The Adapter Runtime log messages appear in the following format, ART.mmmm.nnnn, where:

ART is the facility code indicating that the message is from the Adapter Runtime.

mmmm is the code for one of the following Integration Server log facilities:

Facility		Information and errors related to...
0114	Adapter Runtime	Adapter runtime facilities.
0115	Adapter Runtime (Listener)	Adapter listeners that use adapter connections to connect to adapter resources.
0116	Adapter Runtime (Notification)	Adapter notifications including polling and listener notifications.
0117	Adapter Runtime (Adapter Service)	Adapter services that define operations that the adapter will perform on adapter resources.
0118	Adapter Runtime (Connection)	Adapter connections that contain parameters that adapter notifications and listeners use to connect to an adapter resource.
0121	Adapter Runtime (SCC Transaction Manager)	Adapter Runtime (JCA System Contract Component Transaction Manager).
0126	Adapter Runtime (SCC Connection Manager)	Adapter Runtime (JCA System Contract Component Connection Manager).

nnnn represents the error’s minor code.

Configuring Server Logging Levels for the Adapter Runtime

About this task

To specify the amount and type of information to include in the server log for the Adapter Runtime

Procedure

In Integration Server Administrator, go to Settings > Logging.
In the Logger List, select Server Logger > Edit Server Logger.

The Server Logger Configuration area lists Integration Server and products that are installed on Integration Server, and the facilities for each of these. To see the Adapter Runtime facilities and their current logging levels, expand the Integration Server node.

By default, all products inherit the logging level of the Default node. Inherited values are shown in gray text. When you explicitly change the logging level for a product or facility, that level overrides the Default node level.
In the Integration Server node, select the level of logging you want to use from the Logging Level list for each Adapter Runtime facility.

For more information about logging levels, see webMethods Integration Server Administrator’s Guide.

Important: Recording more information consumes more system resources.
Click Save Changes.

Adapter Runtime Exception Handling

The Adapter Runtime provides the following exception definitions:

AdapterException. All exceptions thrown by an adapter, excluding exceptions during adapter service execution, belong to this exception type or to a child of this exception type.
DetailedException. This type of exception is a child of AdapterException. It contains detailed information about an exception.
AdapterConnectionException. This exception is thrown when an issue occurs while establishing a connection to the back end or using a connection that has become stale. When the system returns an AdapterConnectionException WmART resets the connection pool.
All adapter services, notifications, and listeners use the connection pool. If an AdapterConnectionException occurs when an adapter service, notification, or listener tries to retrieve a connection from the connection pool, the Adapter Runtime treats the exception as a fatal one. WmART resets the connection pool and throws a DetailedSystemException.
DetailedServiceException. This type of exception provides detailed information about any exceptions thrown during service execution.