Configuring Services and Integrations

Follow

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 ConfigurationsServices. 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:

Services_img1.png

  1. 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.

  2. 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.

  3. 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.

  1. Navigate to ConfigurationsServices and select a service to add an integration to. Open the Integrations tab and click New Integration.

    NewIntegrationButton.png

  2. 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. 

  1. Find the integration to delete by navigating to ConfigurationsServicesIntegrations.

  2. Click the gear icon for the integration and select the Delete option.DeleteIntegration_img1.png

  3.  

When an integration is deleted, we do not remove the incidents. There are no changes to the open or resolved incidents.

Disable a Service 

If a service is no longer in use and you want to preserve its settings for future use, or you would like to disable it so that incidents are not triggered, you can disable the service and re-enable it later with the settings intact.

Disabling a service is very similar to putting a service in maintenance mode, in that no incidents will be created and triggered when a service is in either of these states.

However, whereas when a service is in maintenance mode, PagerDuty can automatically bring the service back to an "Active" state so that incidents can be triggered, when a service is disabled, you will need to manually re-enable it so that incidents can be triggered. 

To disable your service:

  1. Go to the Configuration menu and select Services.

  2. Click on the name of the service you would like to disable.

  3. Click Disable Service on the right-hand sight of the page and then click OK on the confirmation dialog.

    DisableService_img1.png

To re-enable a service:

  1. Go to the Configuration menu and select Services.

  2. Click on the name of the service you would like to enable.

  3. Click on the Enable this service button, and your service will be enabled.

    DisableService_img2.png

Have more questions? Submit a request

Comments