Links

X-Pack Alerting (Elasticsearch Watcher) Integration

With the ilert X-Pack Alerting integration, you can create alerts in ilert based on Watcher alerts.
X-Pack alerting is a set of administrative features that enable you to watch for changes or anomalies in your data and perform the necessary actions in response.

In ilert: Create a X-Pack Alerting alert source

  1. 1.
    Go to Alert sources --> Alert sources and click on Create new alert source
  2. 2.
    Search for X-Pack Alerting in the search field, click on the X-Pack Alerting tile and click on Next.
  3. 3.
    Give your alert source a name, optionally assign teams and click Next.
  4. 4.
    Select an escalation policy by creating a new one or assigning an existing one.
  5. 5.
    Select you Alert grouping preference and click Continue setup. You may click Do not group alerts for now and change it later.
  6. 6.
    The next page show additional settings such as customer alert templates or notification prioritiy. Click on Finish setup for now.
  7. 7.
    On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

In X-Pack Alerting

X-Pack license required
To set up the integration, you must have X-Pack license with Watcher feature enabled.

Create a watcher

  1. 1.
    Go to Kibana and then to Management -> Watcher, then click on the Create button and on the Create advanced watch button**.**
  1. 2.
    On the next page, name the watcher e.g. ilert, define conditions and actions the Webhook URL that you generated in ilert as follows:
{
...
[CONFIGURATIONS OF YOUR X-PACK ALERTING ALERT]
...
"actions" : {
"ilert" : {
"webhook" : {
"scheme" : "https",
"method" : "POST",
"host" : "api.ilert.com",
"port" : 443,
"path" : "/api/v1/events/eswatcher/[YOUR API KEY]",
"headers" : {
"Content-Type" : "application/json"
},
"params": {},
"body" : "{{#toJson}}ctx{{/toJson}}"
}
}
}
}
  1. 3.
    Finished! Your X-Pack alerts will now create alerts in ilert.

FAQ

Will alerts in ilert be resolved automatically?
No, unfortunately Watcher's notification is not compatible with ilert's resolve event.
Can I connect X-Pack Alerting with multiple alert sources from ilert?
Yes, simply add more watchers in X-Pack Alerting.