IBM Watson AIOps Integration

Alerting with Incoming Webhook

To configure IBM Watson AIOps as an Alerting Channel, head over to "Settings > Team Settings > Events & Alerts > Alert Channels > Add Alert Channel".

IBM Watson AIOPS alert channel

Add the Watson AIOps Webhook URL, which you can create using the documentation at Incoming Webhooks.

The following events are received as an HTTP POST to the configured IBM Watson AIOps URL (HTTP or HTTPS).

Examples

On Open Issues/Incidents

{
  "resource": {
    "name": "test",
    "hostname": "test.fqdn",
    "displayName": "test",
    "availabilityZone": "zone 1",
    "customZone": "zone",
    "type": "JVM"
  },
  "severity": "Warning",
  "summary": "Garbage Collection Activity High (11%)",
  "type": {
    "eventType": "issue",
    "statusOrThreshold": "OPEN"
  },
  "deduplicationKey": "someId",
  "details": {
    "containerNames": []
  },
  "expiryTime": 86400,
  "timestamp": 1615456994340,
  "sender": {
    "name": "Instana",
    "displayName": "Instana Server"
  },
  "urls": [
    {
      "url": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
      "description": "Link to Instana"
    }
  ]
}

On Close Issues/Incidents

A resolution event containing a similar set of parameters would be sent.

{
  "resource": {
    "name": "test",
    "hostname": "test.fqdn",
    "displayName": "test",
    "availabilityZone": "zone 1",
    "customZone": "zone",
    "type": "JVM"
  },
  "severity": "Warning",
  "summary": "Garbage Collection Activity High (11%)",
  "type": {
    "eventType": "issue",
    "statusOrThreshold": "OPEN"
  },
  "deduplicationKey": "someId",
  "details": {
    "containerNames": []
  },
  "timestamp": 1615457004340,
  "sender": {
    "name": "Instana",
    "displayName": "Instana Server"
  },
  "resolution": true,
  "urls": [
    {
      "url": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
      "description": "Link to Instana"
    }
  ]
}

HTTP Request Headers

Providing Custom HTTP Request Headers

Some Webhook integrations need the specification of additional Headers that can be added in this section. For example, HTTP headers with key:value.

Webhook URL Basic Authentication

As an alternative to provide the respective Authorization HTTP request header manually, you can use HTTP basic authentication by using the webhook URL. By prepending username and password to the hostname, such as https://username:password@webhookurl.com, the credentials will be automatically Base64- encoded and provided as the following HTTP header value:

Authorization: Basic <base64 encoded credentials>