IBM Cloud Pak for AIOps alert channel

Learn about sending alert notifications from Instana to IBM Cloud Pak for AIOps.

To send alert notifications from Instana to IBM Cloud Pak for AIOps in real time, create an IBM Cloud Pak for AIOps alert channel.

Creating an alert channel

Edit online

To create an IBM Cloud Pak for AIOps alert channel, follow these steps:

From the navigation menu in the Instana UI, click Settings > Global Settings > Events & Alerts > Alert Channels > Add Alert Channel.

Add the Cloud Pak for AIOps Webhook URL. For more information, see Incoming Webhooks documentation.

Alerting examples

Edit online

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

See the following examples:

On open issues or incidents

Edit online

{
  "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

Edit online

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

Edit online

Providing custom HTTP request headers

Edit online

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

Edit online

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>