Generate Event

This action causes a DirXML user-defined event to be sent to NsureTM Audit.


Example


Generate Event

The following is an example of the Named String Builder, used to provide the strings argument:


Generate Event


Fields

ID

ID of the event. The provided value must result in an integer in the range of 1000-1999 when parsed using the parseInt method of java.lang.Integer.


Level

Level of the event.

Level Description

log-emergency

Events that cause the DirXML engine or driver to shutdown.

log-alert

Events that require immediate attention.

log-critical

Events that can cause parts of the DirXML engine or driver to malfunction.

log-error

Events describing errors which can be handled by the DirXML engine or driver.

log-warning

Negative events not representing a problem.

log-notice

Events (positive or negative) an administrator can use to understand or improve use and operation.

log-info

Positive events of any importance.

log-debug

Events of relevance for support or engineers to debug operation of the DirXML engine or driver.


Strings

User-defined string, integer, and binary values to include with the event. These values are provided using the Named String Builder.

Tag Description

target

The object being acted upon.

target-type

Integer specifiying a predefined format for the target. Predefined values for target-type are currently:

  • 0 = None
  • 1 = Slash Notation
  • 2 = Dot Notation
  • 3 = LDAP Notation

subTarget

The sub-component of the target being acted upon.

text1

Text entered here will be stored in the text1 event field.

text2

Text entered here will be stored in the text2 event field.

text3

Text entered here is stored in the text3 field.

value

Any number entered here is stored in the value event field.

value3

Any number entered here will be stored in the value3 event field.

data

Data entered here will be stored in the blob event field.

data-type

MIME-type of data. See logevents.h, for a complete list.


Remarks

DirXML user-defined event IDs must be between the range of 1000 to 1999. Valid event levels are definend in the following table. The remaining event data fields are provided by four string elements with name attributes. The Nsure Audit event structure contains a target, a subTarget, three strings (text1, text2, text3), two integers (value, value3), and generic field (data). The text fields are limited to 256 bytes, while the data field may contain up to 3KB of information, unless a larger data field is enabled in your environment.

A detailed discussion of generating events using Policy Builder is contained in the Identity Manager 2 Administration Guide in the "Logging and Reporting Using Nsure Audit" section.