IBM Cloud Pak for AIOps alert channel
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
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
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
{
"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>