Customizing event definitions

You can use the CyberArk Configuration Console (or the Logging MMC snapin) to customize the Description and Translation of existing event definitions. Other properties of an event definition (such as event IDs, field names, and field types) cannot be customized.

To customize an existing event definition

  1. Open the CyberArk Configuration Console (or the Tools MMC snapin), and open the Tools node.
  2. Click the Event Definitions node.
  3. In the bottom panel, double click on an Event.
  4. You can customize both the Description and the Translation.

    Macros are allowed. You can see what content will be provided in the macros when you look at the event definition.

    For example, if the content for Text 2 is "Contact", you could incorporate the corresponding macro, $Event.Text2$, like this:

    For additional information, please reach out to $Event.Text2$.

    If you incorporated this into an email notification, the resulting paragraph would replace $Event.Text2$ with the contact's name, and might look like this:

    For additional information, please reach out to Jon Smith.

  5. When you're done, click Apply.

Resetting to original event definitions

When you change an event definition, it gets marked as "customized" and is stored separately from the default event definitions. This means your customizations are preserved during upgrades, even when the underlying default definitions are updated.

You can revert an event definition to the default by clicking the Undo arrow next to the event description or the event translation.

TIP  If you are having trouble with events after upgrade, it's possible that the default behavior for an event changed, and that is conflicting with a customization you have made. Check to see if you have any customized events by looking on the Events Definitions panel, and reviewing the Customized column. If there are customized events, try resetting them to the default to see if that resolves your issue.

IMPORTANT  Always use the Event Definitions UI to customize events. Do not directly edit event definition schemas through configuration tools or the database, as those changes will be overwritten during upgrades.