Cloudaware Documentation

Basic PagerDuty Configuration

This guide explains how to configure a PagerDuty account. Skip it if your PagerDuty account set up for further configuration with Cloudaware.

Prerequisites


You must be an Admin or Account Owner within PagerDuty to access API Key and Integration Key that are required for configuring PagerDuty Account and/or PagerDuty Notification integrations in Cloudaware.


Setup in PagerDuty


1. Log in to PagerDuty. Click the User icon → My Profile. Configure the User Profile by adding Contact Information, Notification Rules, and User Settings:

user settings.png


2. Invite the team members. Go to PeopleUsersAdd Users.

add users.png

Each user will need to set up their Profile settings. 


3. Generate an API key. Go to Configuration (upper right corner) → API Access → click +Create New API Key.

config - api access.png

Give a description of the key → Create Key. Copy the key to a safe place and click Close.

One API key can be used for both types of PagerDuty integration in Cloudaware.


4. Configure the Incident Notification Pipeline:


4.1. Create a Team to add users, define their team roles, and customize the UI for specific users in PagerDuty (optional). Go to PeopleTeams+New Team.

add teams.png

Learn more about Teams

4.2. Create On-Call Schedule to distribute incident response responsibility across teams. Go to PeopleOn-Call Schedules → click +New On-Call Schedule.

add a schedule.png

Select a responsible team, add users, set up a rotation and a start time for the schedule. Click Create Schedule.

set up schedule.png

Learn more about Schedules

4.3. Create an Escalation Policy. Go to PeopleEscalation Policies → click +New Escalation Policy.

add esc policy.png

Add a team, select a user responsible for resolution when a service is triggered, and set up notification settings. Click Save.

set up policy.png

Learn more about Escalation Policies

4.4. Set up Services and Integrations to create incidents in PagerDuty. Go to ServicesService Directory+New Service to add a service such as an application, component, or team.

add service.png

Manage the Service settings: add one of the available integrations, select the escalation policy created before, and set up incident behavior. Click Add Service.

set up service.png

Learn more about Services & Integrations


5. Test the PagerDuty configuration by creating a test incident. Go to IncidentsAll Incidents → click +New Incident.

add incident.png

Give a name to the incident and select the appropriate escalation policy → Create Incident. Resolve your test incident.

Learn more about Incidents