Skip to main content

iLert

iLert is a modern uptime platform with advanced on-call and alerting features.

Alert and notify users using iLert. This integration was integrated and tested with API version 1 of iLert.

Configure iLert on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for iLert.

  3. Click Add instance to create and configure a new integration instance.

    ParameterRequired
    Server URLTrue
    The API key of the alert source (for triggering events only)True
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

iLert-submit-event#


Creates a new event/incident in iLert (in order to use this command you have to enter the Integration Key in the integration settings)

Base Command#

ilert-submit-event

Input#

Argument NameDescriptionRequired
incident_keyFor ALERT events, the incident key can be used to deduplicate or group events. If an open incident with the key already exists, the event will be appended to the incident's event log. Otherwise a new incident will be created. For ACCEPT and RESOLVE events, the incident key is used to reference the open incident which is to be accepted or resolved by this event.Optional
event_typeMust be either ALERT, ACCEPT, or RESOLVE. Default is ALERT.Optional
summaryThe event summary. Will be used as the incident summary if a new incident is created.Optional
detailsThe event details. Will be used as the incident details if a new incident is created.Optional
priorityMust be either HIGH or LOW. Will overwrite the evaluated priority of the alert source.Optional

Context Output#

There is no context output for this command.

Command Example#

!ilert-submit-event summary="Test incident"

Human Readable Output#

Incident has been created.

ilert-acknowledge-event#


Acknowledges an existing event in iLert

Base Command#

iLert-acknowledge-event

Input#

Argument NameDescriptionRequired
incident_keyThe incident key is used to reference the open incident which is to be accepted or resolved by this event.Optional
summaryThe event summary. Will be used as the event description in the incident timeline.Optional

Context Output#

There is no context output for this command.

Command Example#

!ilert-acknowledge-event incident_key="ctx312"

Human Readable Output#

Incident has been acknowledged.

ilert-resolve-event#


Resolves an existing event in iLert

Base Command#

ilert-resolve-event

Input#

Argument NameDescriptionRequired
incident_keyThe incident key is used to reference the open incident which is to be accepted or resolved by this event.Optional
summaryThe event summary. Will be used as the event description in the incident timeline.Optional

Context Output#

There is no context output for this command.

Command Example#

!iLert-resolve-event incident_key="ctx312"

Human Readable Output#

Incident has been resolved.