Setting up alert channels
Quickly and efficiently react for built-in events and custom events.
Define alerts to receive alert notifications to any of your alert integrations in real time.
Creating an alert channel
To set up an alert integration, create an alert channel with the Instana UI:
- From the main navigation, click .
- Within the section Events & alerts, click Alert channels.
- Click Add alert channel.
- Within the Add an alert channel window, select the channel that you want to add. Then, click Add alert channel.
- Configure your alert channel settings. Then, click Create.
You need to enter a Name for the channel, and any required details for connecting to the selected application. As an example, the following image shows the configuration page for configuring a generic webhook alert channel.
You can associate teams with the alert channel. To add teams and view the list of teams you belong to, select teams from the list. You can associate one or more teams with the alert channel.
Supported channels
The following alert channels are currently supported:
| Technology | Details |
|---|---|
| App for Microsoft Teams (public preview) | Link |
| App for Slack (public preview) | Link |
| App for ServiceNow ITSM app | Link |
| Technology | Details |
|---|---|
| Generic webhook | Link |
| Link | |
| Slack | Link |
| Office 365 | Link |
| Opsgenie | Link |
| PagerDuty | Link |
| ServiceNow | Link |
| Google chat | Link |
| VictorOps | Link |
| Prometheus | Link |
| Cisco Webex Teams webhook | Link |
| IBM Cloud Pak for AIOps webhook | Link |
| IBM Z ChatOps (public preview) | Link |
| Salesforce (public preview) | Link |
Alert payload key mapping to UI elements
The following table explains each key in the alert payload and how it corresponds to UI elements on the issue page:
| Alert value | Description | UI representation |
|---|---|---|
| ID | A unique identifier for the issue | Not explicitly shown |
| type | Indicates this is an issue |
Not explicitly shown, but the Issue Overview represents it |
| state | Indicates whether the issue is open or closed |
Not explicitly shown, but an active issue suggests it is open |
| start | The timestamp (in milliseconds) when the issue started | Displayed under Started |
| severity | The severity level of the issue represents specific values in Instana events: 5 for Warning and 10 for Critical | Displayed under Severity |
| text | The title of the issue | Displayed in the Issue Overview |
| suggestion | Suggested actions for resolving the issue | Displayed under Description |
| link | Provides a URL linking to the full issue details on the Instana platform | Not explicitly shown |
| entityType | The type of system affected (for example, Java virtual machine (JVM)) | Shown as the label after On |
| entityLabel | A more detailed label for the affected entity | Appears as text after On in the UI, providing a more specific identifier |
| FQDN | The fully qualified domain name (FQDN) of the affected host | Not directly visible |
| relatedEntities | Other entities that are related to the issue | Not directly visible |