A service may represent an application, component or team you wish to open incidents against.
Many monitoring tools can integrate with PagerDuty using an API integration. However, if we do not offer an API Integration, you can use the generic email integration to integrate with any monitoring tool that has the ability to send emails (even in-house solutions).
Create a new service
You can access all services by going to Configurations → Services. If you are creating a new service, click Add New Service. Otherwise, you can skip to adding integrations to an existing service.
Give your service a name. Then select your app from the Integration Type menu and enter an integration name.
For the Integration Type, you have 3 options:
Select a Tool. Check to see if we have an existing integration for your service. Search for your service by clicking on the drop down menu next to Integration Type.
Integrate via Email. If you do not see your service in the drop-down, you can select Integrate via email. If your service can send out email alerts, you can create an integration email address in PagerDuty that you can point your service to for alerting.
Use our API directly. If your service is able to make basic HTTP API calls, then you can interact directly with our API to trigger, acknowledge, and resolve incidents. Our developer documentation provides several examples of how to integrate with PagerDuty using our API.
Add integrations to an existing service
PagerDuty allows you to add multiple integrations to a single service. This enables you to represent the actual entities you are monitoring, managing, and operating as services in PagerDuty, whether those entities are specific applications, individual micro-services in an application’s architecture, or cross-cutting shared infrastructure (such as networks, security, etc.).
With this functionality you are able to consolidate integrations under one service allowing you to share the service specific settings as well. Once these integrations are consolidated under the same service, you will get proper service-level reporting in our Reporting & Analytics UI.
Navigate to Configurations → Services and select a service to add an integration to. Open the Integrations tab and click New Integration.
Select your integration type as described above and name your integration. Click Save.
Once these integrations are added, you can also move integrations to other Services. For more information on this, please check out our article moving integrations to another service.
For additional tips on how to use multiple integrations to best represent your internal systems, please check out our best practices article here.
Delete an integration from a service
If an integration is no longer needed, it can be deleted. After an integration has been deleted, it cannot be recovered and you will need to create a new integration of the same type on the service should you wish to use that integration again.
Note: If you'd like to instead temporarily deactivate an integration, you can either place the service in maintenance mode, or temporarily move the integration to an inactive service.
Find the integration to delete by navigating to Configurations → Services → Integrations.
Click the gear icon for the integration and select the Delete option.
When an integration is deleted, we do not remove the incidents. There are no changes to the open or resolved incidents.