Help Documentation


Alerts


Alerts can be configured to automatically send a variety of notifications when something significant happens in your log data. This will help you to identify and fix problems as soon as possible. Each alert will contain a hyperlink to Understand.io with the relevant filters already applied, so that you can perform additional analysis if needed.

Alert Configuration

Alert notifications can be delivered to a Slack channel, an email address or to any HTTP endpoint that you specify. You can specify multiple notification channels for each alert.

Output Services

Slack Service

This will allow you to send alerts to a Slack channel that you specify.

Email Service

This will allow you to send an email notification to one or more team members.

Push Service

The Push Service gives you the possibility to deliver alerts to any external HTTP endpoint.

Alert Configuration

Understand.io will perform an HTTP POST request to the configured URL with the following JSON structure:

{
	"reason": "Test: 6 event(s) found in the last 5 minutes",
	"url": "https://app.understand.io/my479m/search?tz=utc&f%5Bd%5D%5B0%5D=2016-10-20+14%3A37%3A51+-+2016-10-20+14%3A42%3A51",
	"sample_events": [
		{
			"id": "AVfiixlVJDAmSWF2T5TX",
			"datetime": "20-10-2016 14:42:28 UTC",
			"unix_timestamp": 1476974548,
			"url": "https://app.understand.io/my479m/events/mg93ww/AVfiixlVJDAmSWF2T5TX",
			"source": {
				"message": "my first event",
				"a": {
					"b": 1
				},
				"timestamp": 1476974548429
			}
		},
		{
			"id": "AVfiixlVJDAmSWF2T5TY",
			"datetime": "20-10-2016 14:42:29 UTC",
			"unix_timestamp": 1476974549,
			"url": "https://app.understand.io/my479m/events/mg93ww/AVfiixlVJDAmSWF2T5TY",
			"source": {
				"message": "my first event",
				"a": {
					"b": 1
				},
				"timestamp": 1476974549239
			}
		},
		{
			"id": "AVfiiwWfJDAmSWF2T5TU",
			"datetime": "20-10-2016 14:42:24 UTC",
			"unix_timestamp": 1476974544,
			"url": "https://app.understand.io/my479m/events/mg93ww/AVfiiwWfJDAmSWF2T5TU",
			"source": {
				"message": "my first event",
				"a": {
					"b": 1
				},
				"timestamp": 1476974544204
			}
		}
	],
	"total_count": 6,
	"threshold": 3,
	"type": "greater than",
	"from": 1476974271,
	"to": 1476974571,
}