Webhook Alert Channel

Alerting

To configure, head over to "Settings → Team Settings → Events & Alerts → Alert Channels → Add Alert Channel".

Webhook URL format: protocol://domainOrIPAddress:port/path

webhook alert channel

The following Webhook events are received as an HTTP POST to the configured URLs (HTTP or HTTPS).

Note: This is the Instana Webhook format. It is not compatible with third party tools which expect an incoming Webhook in their format. You might want to use a custom made adapter or If This Then That to connect to third party tools.

On Open Issues/Incidents

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "issue",
    "state": "OPEN",
    "start": 1460537793322,
    "severity": 5,
    "text": "Garbage Collection Activity High (11%)",
    "suggestion": "Tune your Garbage Collector, reduce allocation rate through code changes",
    "link": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
    "zone": "prod",
    "fqdn": "host1.demo.com",
    "entity": "jvm",
    "entityLabel": "Test jvm",
    "tags": "production, documents, elasticsearch",
    "container": "test-container"
  }
}

On Close Issues/Incidents

{
  "issue": {
    "id": "6596e1c9-d6e4-4a8e-85fd-432432eddac3",
    "state": "CLOSED",
    "end": 1460537777478
  }
}

On Online/Offline/Change events

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "presence",
    "start": 1460537793322,
    "text": "online",
    "description": "Java virtual machine on Host host1.demo.com",
    "link": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
    "zone": "prod",
    "fqdn": "host1.demo.com",
    "entity": "jvm",
    "entityLabel": "Test jvm",
    "tags": "production, documents, elasticsearch",
    "container": "test-container"
  }
}

Providing Custom HTTP Request Headers

Some Webhook integrations need the specification of additional Headers which can be added in this section. An example is the addition of an API token for AWS API Gateway.

FAQ

How can I ensure that the Instana servers can establish a TCP/TLS connection?

The Instana servers are issuing requests from AWS / Google Cloud servers. It is therefore important that the JavaScript and source map files are generally accessible from the internet. Additionally you need to make sure that your server has a working TLS configuration with a complete certificate chain. You can check for any TLS issues by using the free SSL Test from SSL Labs/Qualys or by executing the following on the command line.

openssl s_client -showcerts -connect {{YOUR_DOMAIN_HERE}}:443