Before creating an integration using Integration Hub, we recommend reading through the following articles to get started.

• Integration Hub Overview
• Enabling the Integration Hub

Creating a PagerDuty Integration

PagerDuty is an Incident Tracking and Management platform and the Cyara integration with PagerDuty allows you to track Cyara Test Case and Campaign failures as incidence tickets for further investigation. 

To build an integration with PagerDuty, follow the steps below.

1. Login to your Cyara Portal.
2. Click on Tools > Integrations. (If this menu does not appear in the Tools menu, confirm that the user account you're currently logged into is provisioned to use the Integration Hub).
3. Click the New Integration button.
4. Select PagerDuty from the Type dropdown menu.
   
   
   
5. Enter a Name and a Description for the integration.
6. In the PagerDuty Details section, enter the API Url and Incident Portal Url that are exposed by your PagerDuty deployment. (In the example below make sure you replace "Instance" with the instance name of your PagerDuty endpoint, as well as including the {id} tag in the Url in the following format to include the Incidence Ticket reference).

   https://instance.pagerduty.com/incidents/{id}

   
   
   
   Enter the authentication details for the API Requests that Cyara will send to PagerDuty. Enter the email address of a valid PagerDuty user on the account associated with the supplied API user token from your PagerDuty login.
   
   
7. In the Field Mapping section, select the New PagerDuty Field to add a pre-formatted field mapping for a set PagerDuty field. Or if you click on New Custom Field you can design your own field mapping by entering a Key Value Pair.
   1. When you click the New Custom Field button to create a new field that is customizable, you will be prompted for the following information.
      1. Field Name - The property name to send to PagerDuty. For a complete list of available property names consult the PagerDuty API Documentation here : https://api-reference.pagerduty.com/#!/Incidents/post_incidents
      2. Display Label - The display name for this field, shown when a user creates an incident.
      3. Type - The Field type. A Choice for multiple fixed values. A single or multiple line text input, or a Lookup for values that are built using an API call.
      4. Field Value - Enter either a Constant, a Choice formatted as a comma separated list where the first is value is the default or to use a Variable. For more information on Field Values set as Variables, see the Incidence Field Variables table below.
         
      5. The final checkboxes allow you to configure field properties such as Required, Read-Only and Overridable.
      6. Click Add Field to add the new field to the Field Selection table.
8.  Click Save Details to save your changes, and Enable the integration using the toggle in the top right corner of the integration editing screen.

Navigation Backlink

By using the $Url field variable in the table below, you can create a link to the Cyara Test Case from your PagerDuty incident ticket. This is useful to allow for quick navigation directly from PagerDuty back to Cyara for troubleshooting. By default Cyara will automatically create a link from the Test Case to your PagerDuty deployment for any raised incidents.

Incidence Field Variables

The following table shows possible template values of fields to be pushed to ServiceNow. A template can contain one or more replacement variables from the table below: