# PagerDuty Plugins
# Overview
Process Automation integrates with PagerDuty Incident Response through a variety of plugins listed below. By integrating Process Automation with Incident Response, users can automatically update incidents, run response plays, add diagnostics and much more.
# Setup
Authentication for the PagerDuty plugins can be configured for the entire system or for an individual project.
# Add PagerDuty API Key to Key Storage
In the PagerDuty web app:
- Navigate to Integrations -> API Access Keys and click Create New API Key.
- Enter a Description that will help you identify the key later on. If you would like it to be read-only, check the Read-only option.
- Click Create Key.
- A unique API key will be generated. Copy it to a safe place, as you will not have access to copy this key again. Once it has been copied, click Close.
- If you lose a key you will need to delete it and create a new one.
Now that the PagerDuty API Key has been created, add it to Key Storage - either at the System or Project level:
System Level
- Click on the System Menu (gear icon) in the upper right.
- Click on Key Storage
- Click +Add or Upload a Key. Select Password for the Key Type.
- Paste the PagerDuty API Key you saved earlier into the field.
- Click Save.
Project Level
- In the specific project, click on Project Settings in the lower left.
- Click on Key Storage.
- Click +Add or Upload a Key. Select Password for the Key Type.
- Paste the PagerDuty API Key you saved earlier into the field.
- Click Save.
# Project Level Configuration
Use the following steps to configure authentication for the PagerDuty plugins for a specific project.
- In the specific project, click on Project Settings in the lower left.
- Click on Edit Configuration then click on Plugins.
- Click on +PluginGroup.
- Select PagerDuty from the list.
- Click Select next to the API Key field and find the API Access Key stored in Key Storage.
- (Optional) Place a valid PagerDuty email address into the PagerDuty Email field. Specific plugins, such as Add Incident Note, require this field to be provided.
- Click Save for the plugin configuration.
- Click Save for the Project Settings:
# System Level Configuration
Use the following steps to configure authentication for the PagerDuty plugins for the whole Process Automation system.
- Click on the System Menu (gear icon) in the upper right.
- Click on System Configuration.
- Navigate to the PagerDuty section and click on the Pencil Icon in the upper right:
- Click on Select next to the API Key field and find the API Access Key stored in Key Storage.
- (Optional) Place a valid PagerDuty email address into the PagerDuty Email field. Specific plugins, such as Add Incident Note, require this field to be provided.
- Click Save for the plugin configuration:
← Kubernetes Sensu →