Skip to content

Commit

Permalink
Add iLert Integration Tile (DataDog#801)
Browse files Browse the repository at this point in the history
* add ilert integration

* add ilert to codeowners

* fix review issues
  • Loading branch information
yacut authored Feb 9, 2021
1 parent 5884727 commit dbe8061
Show file tree
Hide file tree
Showing 10 changed files with 134 additions and 0 deletions.
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@
/hbase_master/ @everpeace
/hbase_regionserver/ @everpeace
/jfrog_platform/ @vinayagg
/ilert/ @yacut [email protected]
/k6/ @ppcano [email protected]
/kernelcare/ @grubberr [email protected]
/launchdarkly/ [email protected]
Expand Down
7 changes: 7 additions & 0 deletions ilert/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# CHANGELOG - iLert Integration

1.0.0
==================
### Changes

* [FEATURE] Initial iLert Integration Tile.
90 changes: 90 additions & 0 deletions ilert/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
## Overview

The [iLert][1] integration sends Datadog alerts to iLert and seamlessly take actions on these alerts within the iLert platform.

Integrate with iLert to:

- Trigger and resolve incidents from Datadog
- Tackle incidents and set up escalation policies as they occur
- Set up a daily reminder of who is on-call

## Setup

### In iLert

#### Create Datadog alert source

1. Switch to the **Alert Sources** tab and click on the "Create new alert source" button

2. Assign name and select escalation chain

3. Select **Datadog** in the Integration type field and save.

![iLert Alert Source New][2]

4. On the next page a **Webhook URL** is generated. You will need this URL at the bottom of the setup in Datadog.

![iLert Alert Source View][3]

### In Datadog

#### Add iLert Webhook as alerting channel

1. Go to Datadog integrations page and [**install Webhooks integration**][8]:
2. Click an Webhooks integration, scroll to bottom and add a new webhook:

![Datadog Webhook New][4]

3. Enter a name, the **Datadog webhook URL** from iLert alert source and **template payload**:

```json
{
"body": "$EVENT_MSG",
"last_updated": "$LAST_UPDATED",
"event_type": "$EVENT_TYPE",
"alert_transition": "$ALERT_TRANSITION",
"alert_id": "$ALERT_ID",
"link": "$LINK",
"title": "$EVENT_TITLE",
"date": "$DATE",
"org": {
"id": "$ORG_ID",
"name": "$ORG_NAME"
},
"id": "$ID"
}
```

![Datadog Webhook View][5]

4. Click save button
5. The integration is now set up!

View the [official documentation][6] from iLert for more details on setup.

## Data Collected

### Metrics

iLert integration does not include any metrics.

### Events

Your iLert Triggered / Resolved events will appear iLert platform dashboard.

### Service Checks

iLert integration does not include any service checks.

## Troubleshooting

Need help? Contact [Datadog Support][7].

[1]: https://www.ilert.com
[2]: https://raw.githubusercontent.com/DataDog/integrations-extras/master/ilert/images/datadog-alert-source-new.png
[3]: https://raw.githubusercontent.com/DataDog/integrations-extras/master/ilert/images/datadog-alert-source-view.png
[4]: https://raw.githubusercontent.com/DataDog/integrations-extras/master/ilert/images/datadog-webhook-new.png
[5]: https://raw.githubusercontent.com/DataDog/integrations-extras/master/ilert/images/datadog-webhook-view.png
[6]: https://docs.ilert.com/integrations/datadog
[7]: https://docs.datadoghq.com/help/
[8]: https://app.datadoghq.com/account/settings#integrations
1 change: 1 addition & 0 deletions ilert/assets/service_checks.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
[]
Binary file added ilert/images/datadog-alert-source-new.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ilert/images/datadog-alert-source-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ilert/images/datadog-webhook-new.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ilert/images/datadog-webhook-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
34 changes: 34 additions & 0 deletions ilert/manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"display_name": "iLert",
"maintainer": "[email protected]",
"manifest_version": "1.0.0",
"name": "ilert",
"metric_prefix": "ilert.",
"metric_to_check": "",
"creates_events": false,
"short_description": "Get notified of your Datadog alerts & take actions using iLert.",
"guid": "875497b9-a27e-4099-92e9-968a70c592fa",
"support": "contrib",
"supported_os": [
"linux",
"mac_os",
"windows"
],
"public_title": "iLert Integration",
"categories": [
"issue tracking",
"collaboration",
"notification",
"monitoring"
],
"type": "crawler",
"is_public": true,
"integration_id": "ilert",
"assets": {
"dashboards": {},
"saved_views": {},
"monitors": {},
"service_checks": "assets/service_checks.json",
"metrics_metadata": "metadata.csv"
}
}
1 change: 1 addition & 0 deletions ilert/metadata.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
metric_name,metric_type,interval,unit_name,per_unit_name,description,orientation,integration,short_name

0 comments on commit dbe8061

Please sign in to comment.