pub.event:auditError

Integration Server 10.3 | Built-In Services Reference Guide | StartEvent Folder | Summary of Elements in this Folder | pub.event:auditError

WmPublic. Specification for audit error event handlers.

Input Parameters

time	String Date and time at which the audit error occurred. This parameter is in the format yyyy-MM-dd HH:mm:ss.SSS (for example, "2004-10-28 14:46:39.505").
destination	String Specifies the audit log destination to which the audit logging system attempted to write when the error occurred.
	Value	Audit logger where the error occurred…
	ServiceDBDest	Service audit logger
	ErrorDBDest	Error audit logger
	SessionDBDest	Session audit logger
	ProcessAuditDBDest	Process audit logger
	CoreAuditDBDest	All other audit loggers
message	String Error message of the exception.
stackTrace	String Stack trace for the exception.
errorCode	String Optional. The SQL error code returned with the exception.

Output Parameters

None.

Usage Notes

Remember to register your event handler using pub.event:addSubscriber. Set the EventType input variable to Audit Error Event.

An audit error event is fired in the following situations:

When a SQLException is encountered while trying to insert an audit record into the audit logging database.

When Integration Server initializes and cannot connect to the audit logging database.

When the Service logger is configured to retry failed auditing attempts, the audit error event is fired for the initial failure and each subsequent failure.

When you subscribe to an audit error event, you can supply a filter to limit the events that your event handler receives. The filter applies to the concatenated values of the destination and errorCode fields. You can use the asterisk (*) as a wildcard character in the filter. The following table shows how you can use filters to limit the events that your event handler will receive:

This filter...	Limits the events that the event handler receives to...
YourSearchTerm	Events that contain only YourSearchTerm.
*YourSearchTerm	Events that contain YourSearchTerm at the end of the audit error event value.
YourSearchTerm*	Events that contain YourSearchTerm at the beginning of the audit error event value.
YourSearchTerm	Events that contain YourSearchTerm anywhere within the audit error event value.

Use the watt.server.event.audit.async server parameter to indicate whether event handlers for audit error events are invoked synchronously or asynchronously. When this parameter is set to true, Integration Server invokes the event handlers that subscribe to audit error events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to audit error events synchronously. The default is true (asynchronous).