IBM Watson AIOps alert channel

To send alert notifications from Instana to IBM Watson AIOps in real time, create a IBM Watson AIOps alert channel.

Creating a Google Chat alert channel

To create a IBM Watson AIOps alert channel, click Settings > Team Settings > Events & Alerts > Alert Channels > Add Alert Channel in the Instana UI.

IBM Watson AIOPS alert channel

Add the Watson AIOps Webhook URL, which you can create by following the Incoming Webhooks documentation.

Alerting examples

After you create the alert channel, alerts for events are received as an HTTP POST to the configured IBM Watson AIOps URL (HTTP or HTTPS), the address which the alerts will be sent to.

See the following examples:

On open issues or 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 or incidents

A resolution event that contains a similar set of parameters will 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 are automatically Base64-encoded and provided as the following HTTP header value:

Authorization: Basic <base64 encoded credentials>