Registered events

On startup all WinGate modules and components will register the events that can take place during their operation with the Events system.

Each registered event is defined by 2 factors:

1. Source Type

   The Source Type is the component or service in WinGate that registered the particular event with the Events system. In the case where services and components register the same type of events, the Source Type helps to identify their registered instance of that event. This helps you to define the component or service where the event will take place. The source of an event will also determine how the source is capable of responding to the event, and what event data is available when the event occurs.

2. Event Type

   This is the type of event that the WinGate component or service registers with the Events system.

Registered events are displayed and referred to throughout WinGate by their registered format of SourceType:EventType.

e.g. WWWProxyServer:ClientConnect, or FTPProxyServer:ProxyRequest

Compatible event types

When components and services register their events, there are certain events that are common to more then one source. For example the ClientConnect event is registered by a range of TCP based services.

Since these events share a commonality of all being registered by a TCP based service, and they are all of the same Event Type (i.e. ClientConnect) they are considered compatible type events. WinGate will use several different factors to determine whether event types are considered compatible.

Rather then configuring an event processor to handle each of the individual compatible events, compatible event types can often be grouped and handled all together by an event processor (if it is capable). The Policy system is an example of an event processor that can handle compatible events. It allows you to create a single policy based on a particular group of compatible events. This means that instead of creating a separate policy for each event, all of these compatible events can be managed within the one policy.

User defined events

When you create an event in the Notification or Scheduler systems, these events are also registered with the Events system. Like other registered events they become available to the different event processors to respond to whenever they occur.

These events are registered with the Source Type of the system where they were configured.

e.g. If you create a scheduled event in the Scheduler it will be registered as: Scheduler:ScheduledEventName.

Normally user defined events will also be compatible events, depending on the source. For example, each notification event you create under a notification plan in the WinGate Notifications system is registered as a Notifications:Name of Notification event. Since they all share the common source and event type (Notification event) they will be available to be handled as a group by a capable event processor such as the Policy system.

Accessing registered events

All registered events are listed on the Events Panel, located at Control Panel > Events in the WinGate Management console. You can specify which event processor(s) should process each event from the Events panel.

Read more