> # Configuring Event Tracing

> Events are generated when the client application accesses data and when specific server activities occur, such as when a service starts or an error occurs. Depending on which SequeLink profiles are active, the information generated by the event is displayed as it occurs in the runtime monitor and is stored persistent in the event trace file.

> By default, the event trace file is located in the installdir\tracing directory where installdir is your SequeLink Server installation directory.

> On Linux and UNIX, both a monitoring and an event trace profile are enabled when you install SequeLink Server.

> NOTE: You can configure only one event trace profile for each SequeLink service.

> ### Creating an Event Trace Profile

> 1. Select the Profiles node for a SequeLink service (beneath the service's Configuration node). Select Action / New / Event Trace Profile. The Event Tracing Properties window appears.

> 2. Enable and disable events:
> - To enable a group of events, select the check box beside the appropriate group name (Service, Session, Network, Error, Statement, Transaction, or Others).
> - To enable individual events, select the check box beside the event in the scroll box. See "SequeLink® Events" for a list and a description of all events.
> - To disable a group of events, clear the check box beside the appropriate group name (Service, Session, Network, Error, Statement, Transaction, or Others).

> NOTE: Event names that do not start with Service, Session, Network, Error, Statement, or Transaction are Other events (for example, Cursor Closed).

> - To disable individual events, clear the check box beside the event in the scroll box.
> 3. Optionally, you can place a filter on any event or group of events. To add a filter, type the filter in the Filter text box. Some events have a set of attributes. You can place a filter on the attributes of an event. For example, if you want to monitor and trace only authentication events for sessions started by administrators, you could write the following filter for the Session Authenticated event:

> ${Authorization} = "administrator"

> See "SequeLink® Events" for an explanation of the filter syntax, and a list and description of the attributes for each event.

> 1. Click Next. The Add Event Trace Profile window appears. Click Finish in this window to add the profile.
> 2. Save the configuration.
> 3. Restart the SequeLink service to activate the new event trace profile.

> ### Changing an Existing Event Trace Profile

> 1. Select the Profiles node for a SequeLink service (beneath the Configuration node). The existing event trace profile is displayed in the Details pane. Double-click the event trace profile. The Events window appears.

> 2. Enable and disable events:
> - To enable a group of events, select the check box beside the appropriate group name (Service, Session, Network, Error, Statement, Transaction, or Others).
> - To enable individual events, select the check box beside the event. See "SequeLink® Events" for a list of all events and their definition.
> - To disable a group of events, clear the check box beside the appropriate group name (Service, Session, Network, Error, Statement, Transaction, or Others).
> - To disable individual events, clear the check box beside the event in the scroll box.
> 3. Optionally, you can place a filter on an event or group of events. Type a filter in the Filter text box. Some events have a set of attributes. You can place a filter on the attributes of an event. For example, if you want to monitor and trace only authentication events for sessions started by administrators, you could write the following filter for the Session Authenticated event:

> ${Authorization} = "administrator"

> See "SequeLink® Events" for an explanation of the filter syntax, and a list and description of the attributes for each event.

> 4. Click OK.
> 5. Save the configuration.
> 6. Restart the SequeLink service to activate the new event trace profile.

> ### Deleting an Event Trace Profile

> 1. Select the Profiles node for a SequeLink service (beneath the service's Configuration node). The existing event trace profile is displayed in the Details pane.
> 2. Right-click the event profile, and select Delete.
> 3. You are prompted to confirm the deletion. Click OK to confirm. The event profile is deleted from the service configuration.
> 4. Save the configuration.