Manage events and event providers
Describes the event management system and event providers in Optimizely.
The events system provides a mechanism for distributing events between IIS applications and Optimizely websites in a load-balanced environment. The event system in Optimizely is provider-based, and you can either use the built-in event provider or develop your own customized one.
Event providers
An event provider, optimized for Microsoft Azure, is available on the NuGet feed. The event provider for Azure uses Service Bus for distributing events and requires no configuration of servers or network details. An event provider for Amazon Web Services also is available on the NuGet feed.
An alternative is to develop your own custom event provider, adapted for your hosting environment.
Configure an event provider
To use another custom event provider, add the provider configuration to the appsettings.json. For example:
{
"EPiServer" : {
"Cms" : {
"EventProvider" : {
"Provider" : "Custom Provider type"
}
}
}
}
See Use the Event API.
Event system process flow
The following procedure describes the logical setup and execution of event system actions.
- When an Optimizely Content Management System (CMS) website starts, it does the following:
- Creates a secret if one does not already exist in the site database.
- Initializes the Event Broker responsible for sending and receiving event messages remotely.
- Initializes each Event Provider that has been configured.
- Enables the Event system when the initialization process has completed (for example when CMS or Optimizely Customized Commerce has completed initialization).
- Code in a site obtains an
Event
object instance and subscribes to theRaised
and optionally to theMissed
event. - Code in a site obtains an
Event
object instance and calls theRaise
method (the Cache Manager could raise a cache changed event for example). - The
Event
object instance fires theRaised
event to notify the local subscribers. - The
Event
object instance informs the Event Broker about the event. - The Event Broker sends the event to all the other sites on the same server and other servers in the network using the configured Event Provider. In addition to the event information, a cryptographic HMAC block also is sent in the message to let the receiver test the authenticity of the event (this functionality can be disabled by the provider if a secure channel is already present).
- The Event Broker on another instance (either an IIS site on the local server or remote server) receives the sent message and does the following:
a. Makes sure the message was sent from another instance sharing the same database. If no match is found, the action will be logged, the message dropped and no further action taken.
b. Verifies the HMAC using the event data and the secret stored in the database (unless the provider disabled validation).
c. If the verification fails, the action is logged, the message dropped, and no further action taken.
d. Obtains theEvent
object instance for the event and calls theRaise
method to notify the local subscribers.
Test the event system
Examples of CMS functionality that use the events system are Cache
updates. To test cache events, edit a page on one CMS site and ensure the change is reflected on the second load-balanced CMS website:
- On CMS #1, navigate to a page in the example website.
- On CMS #2, enter edit view and navigate to the same page as in step 1.
- On CMS #2, add/edit/delete some text on the page and click Publish.
- On CMS #1, refresh the page and ensure it reflects the new information saved in step 3.
Updated about 1 month ago