# Incident Management

When an alert triggers, Apica Ascent Insights sends alert details to its designated alert destinations. Apica Ascent Insights supports the following types of alert destinations.

* **E-mail**
* **ChatWork**
* **Generic Webhook (see** [**Webhooks**](#slack) **page)**
* **HipChat**
* [**ilert**](https://docs.apica.io/integrations/list-of-integrations/ilert)
* **Mattermost**
* **OpsGenie**
* **PagerDuty**
* **ServiceNow**
* **Slack**
* **Zendesk**
* **Zenduty**

## Configuring Destinations

To configure alert destinations navigate to **settings** and open the **“Alert Destinations”** tab

![](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FmKvtlYtS2Jt7zwXCWQtV%2FScreenshot%20from%202022-07-04%2017-13-01.png?alt=media\&token=1c270cef-ad42-4c0b-8c55-e943c4a0ba99)

### Email <a href="#email" id="email"></a>

{% hint style="info" %}
It’s required to [configure the e-mail](https://docs.apica.io/admin/email-configuration-setup) server to receive e-mail notifications.
{% endhint %}

1. Click on + New Alert Destination”, and pick Email.
2. Specify the recipient’s name & email address.
3. The subject is configurable. It’s recommended to use format: **Alert {alert\_name} changed status to {state}.** alert\_name and state are template parameters and will be replaced by the URLs to give more information about the alert that will have occurred.

![James Smith's Email configuration](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F5kdqUEbbvn6RU1G7vkPi%2FScreenshot%20from%202022-07-04%2016-45-37.png?alt=media\&token=6aff241d-1a07-46c8-931f-bf5fa47bd1ca)

Email destination is created by clicking the save button.

![Email Alert Destination](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FVbaGdWxClmo0NkJIU1nE%2FScreenshot%20from%202022-07-04%2016-46-00.png?alt=media\&token=e4e13c58-02de-411a-bd10-7fd9536a8261)

### Slack <a href="#slack" id="slack"></a>

In your [slack](https://my.slack.com/services/new/incoming-webhook/) console, pick or create a channel such as #alerts-events in this example and create an incoming webhook by clicking on "Add Incoming Webhooks Integration"

![Slack Webhooks integration](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LmzGprckLqwd5v6bs6m%2F-MEUjK03wTuuijqCMkY8%2F-MEUkGlTXqlR8HQLpjgG%2FScreen%20Shot%202020-08-11%20at%203.10.58%20PM.png?alt=media\&token=ed49458c-f23f-408e-880a-1968e7c49541)

In your Apica Ascent Insight's UI, Open the “Alert Destinations” tab in the settings screen, and click on ”+ New Alert Destination”. Pick “Slack” as the type. Set the name, channel, etc, and provide a “Slack Webhook URL”, from above

![Slack Destination Configuration](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FxRZB9GWoWPAB5SRocRSE%2Fslack.png?alt=media\&token=69f86e3d-27c2-49b4-9d70-d3e5d9ac4af9)

### Pager Duty <a href="#pagerduty" id="pagerduty"></a>

Obtain the PagerDuty Integration Key from your PagerDuty service. Use Events API v2 Integration Type.

![](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LmzGprckLqwd5v6bs6m%2F-MEUo7fkST5XJDm_ITRj%2F-MEUwjjGafOWQ34A4TNl%2FScreen%20Shot%202020-08-11%20at%204.31.41%20PM.png?alt=media\&token=0233e470-bce6-425f-abd3-ba99f2050795)

After obtaining the Integration Key:

1. Open the “Alert Destinations” tab in the settings screen, and click on ”+ New Alert Destination”.
2. Pick “PagerDuty” as the type.
3. Populate mandatory fields are Name and Integration Key obtained earlier.

![PagerDuty Configuration](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F6eVxZYWtXIWhOYBSjRVJ%2FScreenshot%20from%202022-07-04%2017-01-18.png?alt=media\&token=ce03d85b-7ec7-433b-bac4-b88efcac9c6e)

### OpsGenie <a href="#opsgenie" id="opsgenie"></a>

In the OpsGenie UI, navigate to your **Teams** page and select the team for which you want to create the alert integration. In the example below we will use the logflow team.

{% hint style="info" %}
NOTE: More than one OpsGenie alert destination can be defined in Apica Ascent
{% endhint %}

![Select the team](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FAPk2zkcYZQ9Xl7wtUpzI%2FScreen%20Shot%202021-11-16%20at%209.17.24%20PM.png?alt=media\&token=c6c50766-c7c2-4b83-8d94-828abf2a009c)

On the Teams page, select **Add integration** and create a new **REST API HTTPS over JSON** Integration type

![Add an integration to the team](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FKIItaPrxjQBZuPlEcQCC%2FScreen%20Shot%202021-11-16%20at%209.17.38%20PM.png?alt=media\&token=e016d2ca-f596-4c8c-97f0-7ee50f0f3193)

![REST API HTTPS OVER JSON](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FCRFpvNLEPzHSGSFVQiXX%2FScreen%20Shot%202021-11-16%20at%209.17.53%20PM.png?alt=media\&token=7fa639fd-6053-4faa-88ac-d96e6a80f683)

![](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F5Yx2mQ35s7DoPoUFqkqs%2FScreen%20Shot%202021-11-16%20at%209.18.49%20PM.png?alt=media\&token=fa167d74-19f0-40ce-9045-0e1c2b6e2e02)

Copy the API integration key from the integration created above.

{% hint style="info" %}
The API Key must be created with **Read** and **Create and Update** permissions and must be **Enabled**
{% endhint %}

You are now ready to add the OpsGenie integration in Apica Ascent under alert destinations. Provide a name for the integration and the **OpsGenie API key**. You are now ready to receive incident notifications from Apica Ascent.

![OpsGenie Alert destination](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FoA9x5piSsEKU72DBrE2L%2F2022-07-04_17-07.png?alt=media\&token=26a3ef81-dc53-49ff-82d4-0cbdf892c3e8)

#### OpsGenie alerts view for Apica Ascent alerts

You can now see the alerts being raised in the OpsGenie UI under the alerts tab.

![OpsGenie alerts table](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FF1k4O4aVVum9rRD4QUfe%2FScreen%20Shot%202021-11-16%20at%209.22.53%20PM.png?alt=media\&token=ea3e02b3-d1fd-4f91-ab84-756f0c33eee5) ![OpsGenie Apica Ascent generated alert detail](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FIG3K9uz7OBhYQXMltWvg%2FScreen%20Shot%202021-11-16%20at%209.23.18%20PM.png?alt=media\&token=f4397ad9-ef9b-4c7d-932e-a78cb4538f54)

## Associating alert destinations to alert

Once the Alert destinations are created, one or more alert destinations can be configured in the alert create or edit UI. Each configured destination is notified whenever that alert triggers.

![](https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F9rCRKGkOEVrP1PH2GXxz%2FScreenshot%20from%202022-07-04%2017-08-34.png?alt=media\&token=39db4af8-41e9-4a73-880c-a71b789e1a6f)
