...
The integration allows you to track PagerDuty Incidents, along with overviewing such objects as users, teams, services, etc. in Cloudaware CMDB. The object PagerDuty Incident now has lookups to AWS Account, AWS Region, AWS EC2 Instance, Azure Virtual Machine, Google GCE Instance.
PagerDuty Setup
1. Log in to your PagerDuty account. Click User icon → My Profile. Configure your User Profile adding Contact Information, Notification Rules, User Settings in 'Configuration':
...
Invite your team members. NOTE: each user will need to set up their Profile settings.
2. Generate an API key*. In your PagerDuty account go to Configuration → API Access → Create New API Key. In the section 'API version'‘API version’:
a. Check the box 'v2(Current)'
...
Click Create Key. Copy it to a safe place and click Close.
| Note |
|---|
*You must be an admin or account owner within PagerDuty to access your API key. |
3. Configure the Incident Notification Pipeline:
3.1. Add users to On-Call Schedules to distribute incident response responsibility across your teams. Go to Configuration → Schedules → +New On-Call Schedule to add users to a schedule, select a daily or weekly rotation and pick a start time for the schedule:
...
Click Create Schedule. Learn more
3.2. Add On-Call Schedules to an Escalation Policy. Go to Configuration → Escalation Policies → +New Escalation Policy tocreate to create an escalation policy specifying who will be assigned responsibility for resolution when a service is triggered:
...
Click Save. Learn more
3.3. Create Teams* to customize the UI for specific users in your PagerDuty account (optional). Learn more
3.4. Set up Services and Integrations. Go to Configuration → Services → +New Service to add a service (an application, component, or team) you wish to open incidents against. Manage settings of your Service selecting a tool and the escalation policy you created before:
...
Click Add Service. Learn more
4. Test your PagerDuty configuration by creating a test incident. Click
...
+New Incident → give your incident a name and select the appropriate policy → Create Incident.
...
Resolve your test incident. Learn more
| Note |
|---|
*Adding users and creating escalation policies and teams are actions that can only be performed by Admins, Global Admins and Account Owners. |
Cloudaware can also provide you with a PagerDuty account as part of Cloudaware subscription. Please contact your dedicated account manager or support@cloudaware.com for the details and pricing.
Cloudaware Setup
1. Log in to your Cloudaware account. Go to Admin → PagerDuty Accounts. Click +Add.
...
2. Insert the integration details. Click Save.
...
3. The green light in 'Status' means that your PagerDuty account has been added successfully. If there is a red light, please contact support@cloudaware.com.
...
With PagerDuty Accounts integration added, Cloudaware allows you to track activity of PagerDuty users and services:
...
Cloudaware parses PagerDuty incidents allowing you to gain visibility of events. Sample PagerDuty Incident in Cloudaware:
...
PagerDuty Notification Integration
...
The integration allows Cloudaware to create and update incidents in PagerDuty using Outbound Webhooks functionality:
...
Sample outbound use cases:
...
Cloudaware users can decorate events from third party monitoring systems such as Zabbix, New Relic, Splunk, etc. by sending them to Cloudaware first. Cloudaware may enrich events with details like AWS Account ID or Azure Resource Group and tags, so that further downstream PagerDuty can make more intelligent routing, suppression and escalation decisions.
PagerDuty Setup
1. Generate an API key*. In your PagerDuty account go to
...
Configuration → API Access and click Create New API Key. In the section 'API version':
...
Click Create Key. Copy it to a safe place and click Close.
| Note |
|---|
*You must be an admin or account owner within PagerDuty to access your API key. |
2. Add and configure a service in PagerDuty that Cloudaware will send notifications to:
2.1. Go to Configuration → Escalation Policies → New Escalation Policy to create an escalation policy specifying who will be assigned responsibility for resolution when a service is triggered.
2.2. Go to Configuration → Services → +New Service to add a service (an application, component, or team you wish to open incidents against) which will use this policy. Manage the settings:
'General Settings': give your service a meaningful name
'Integrations Settings':
a. Select a tool
b. Check the box 'Use our API directly'
c. Select Integration Type: 'Events API v2'
'Incident Settings': select the policy you created before
Click Add Service.
2.3. Review your service details:
'Integrations' creates incidents by connecting to your monitoring tools. You can add multiple integrations to a service.
'Extensions' provides additional functionality to PagerDuty services. Tied to services of your choice, service extensions can respond to actions taking place on services' incidents.
Cloudaware Setup
1. Log in to your Cloudaware account. Go to Admin → Other Integrations → PagerDuty Notification. Click +Add.
...
2. Insert the integration details:
...
2.1. You must type API names of fields in 'Incident Key Field', 'Resolve Time Field' and 'Fields' exactly as they are on the object (e.g. CA10__caUuid__c, CA10__disappearanceTime__c, etc).
...
2.4. In the field 'Fields' a list of fields separated by line break sign (\n). This is the list of API Name fields that will be transmitted into a description of the incident in PagerDuty. If you add “-” in this field, it won't be added into a description of the incident (e.g. - Id - will exclude 'Record ID').
Click Click Save.
3. Set up the workflow rule with outbound messages for creating incidents in PagerDuty:
...
3.2. In the Quick Find box start typing workflows to select Workflows & Approvals → Workflow Rules → New Rule
3.3. Select the object for the rule to be applied to and click Next.
3.4. Add Rule Name (1), set Evaluation Criteria(2) and Rule Criteria(3). Add Filter Logic if necessary. Click Save & Next.
In this example, we set up incidents creation for the object 'AWS EC2 Instance Status Event'. Every time any AWS EC2 Instance's status is changed, Cloudaware triggers a workflow rule to take into action creating a new incident in PagerDuty.
3.5. Add Workflow Action → New Outbound Message
3.6. Fill out your Outbound Message details. Endpoint URL can be copied from PagerDuty Notification integration you set up in Cloudaware before (e.g. https://inbound-dot-cloudaware-vm.appspot.com/inbound-message/pager-duty/{key}). Select Available Fields to be displayed in a PagerDuty incident. Click Save.
...
4. Once outbound messages are set up, check your PagerDuty Notification integration in Cloudaware. The green light in 'Status‘Status' means that the integration has been enabled successfully. If there is a red light, please contact support@cloudaware.com.
...