All Products
Search
Document Center

Application Real-Time Monitoring Service:Connect ARMS alert management to PagerDuty

Last Updated:Oct 16, 2024

PagerDuty is an incident response platform for IT departments. You can connect ARMS alert management to PagerDuty to trigger automatic events or track service changes.

Background information

PagerDuty is an incident response platform for IT departments. When an incident occurs, PagerDuty can alert IT departments by phone call, text message, or email. For more information about PagerDuty, visit PagerDuty's official website.

Step 1: Register a PagerDuty account

You can register a PagerDuty account with a 14-day free trial on the PagerDuty official website. perform the following operations:

  1. Go to the sign-up page of PagerDuty.

  2. In the Try PagerDuty section, perform the following steps:

    1. Enter the email address, and then click GET STARTED!.

    2. Enter a name and click NEXT STEP.

    3. Enter a password and click NEXT STEP.

    4. Enter a subdomain, select the check box for the Terms of Service and Privacy Policy, and then click CREATE ACCOUNT.

    After the account is created, the PagerDuty welcome page appears. Welcome

Step 2: Create a service

Create a service for ARMS alert management in the PagerDuty console. perform the following operations:

  1. Log on to the PagerDuty console.

  2. In the top navigation bar, choose Services > Service Directory.

  3. On the Service Directory page, click + New Service.

  4. On the Create a Service page, do the following:

    1. Enter a service name and click NEXT.

    2. Select the Generate a new Escalation Policy and click NEXT.

    3. Select the Intelligent and click NEXT.

    4. Select a Events API v1 or Events API V2 as required, and then click Create Service.

      Note

      Both Events API v1 and Events API V2 can connect ARMS alert management to PagerDuty. However, Events API V2 provides a direct interface to set PD-CEF fields in PagerDuty alerts. This makes it easier for ARMS alert management to generate rich alert data in PagerDuty for classification, filtering, and operations. For more information, see Events API.

  5. Copy and save Events API v1 Integration Key and Integration URL, Events API V2 Integration Key and Integration URL (Alert Events) in the Integrations area.

    Key and URL for Integrations

Step 3: Create a webhook

Select a webhook for Events API v1 or Events API V2 as needed, and use the webhook to send alerts to PagerDuty.

Create a webhook for a Events API v1

  1. Log on to the ARMS console.

  2. In the left-side navigation pane, choose Alert Management > Notification Objects.

  3. Click the Webhook Integration tab, and click Create Webhook.

  4. In the Create Webhook dialog box, set the following parameters.

    1. Enter a webhook name.

    2. Set Post to the Integration URL of the Events API v1.

    3. Enter Integration Key in the text boxes of the notification template and recovery template using the following format.

      integration_key=********4463
  5. Click Send Test.

    If a status=success appears in the returned message, the configuration is successful.

  6. Click OK.

Create a webhook for a Events API V2

  1. On the Webhook Integration tab, click Create Webhook.

  2. In the Create Webhook dialog box, set the following parameters.

    1. Enter a webhook name.

    2. Set Post to the Integration URL (Alert Events) of the Events API V2.

    3. Enter Integration Key in the text boxes of the notification template and recovery template using the following format.

      integration_key=********4463
  3. Click Send Test.

    If a status=success appears in the returned message, the configuration is successful.

  4. Click OK.

Step 4: Create a notification policy

Set the created webhook as an alert notification object.

  1. Log on to the ARMS console.

  2. In the left-side navigation pane, choose Alert Management > Notification Policies.

  3. On the page that appears, click Create Notification Policy in the upper-right corner.

  4. In the Notification Objects section, set the created webhook as the notification object.

    For more information about how to set other parameters, see Create and manage a notification policy.

  5. Click Save.