Events
Itential Platform publishes events using an internal event system.
To subscribe to an event topic, provide a source and event handler in the format source, topic, handler:
Job events
The table below lists event topics published to the Itential Platform environment.
Event payload structure
All job event payloads contain a job property with the complete job document from the database at the time the system publishes the event. The job document’s structure and content vary based on the workflow definition and the job’s current state.
Standard job events
Standard job events (jobStart, jobComplete, jobError, jobFix, jobPause, jobResume, jobCancel) follow this structure:
Subscribe to job events
You can subscribe to job events using the global eventSystem object available in applications and adapters. This example subscribes to multiple job events:
Job SLA events
Job SLA events are supported in Itential Platform 6, 2023.2, and 2023.1.
You can use the events defined above within the platform through Operations Manager triggers and the EventListenerJob task within a workflow. You can build automations in Operations Manager that trigger when a job breaches its service level agreement (SLA). For more information, see Event triggers.
jobSlaBreach payload structure
The jobSlaBreach event includes additional properties beyond the standard job document:
- job: The complete job document from the database at the time of the SLA breach.
- runTime: The job’s runtime in milliseconds.
- slaDelta: The amount in milliseconds that the job overran its SLA threshold. For example, if you set the SLA threshold to 2000 ms and the job runs for 3086 ms, the
slaDeltais 1086 ms.
Example jobSlaBreach event
In this example, the job had an SLA threshold of 1000 ms but took 2086 ms to complete, resulting in an SLA breach with a slaDelta of 1086 ms.
Configure the EventListenerJob task
The following figure shows how to configure the EventListenerJob task to receive the jobSlaBreach event.

For additional SLA information, see Setting job metrics.