Service Profile

The service profile provides a high-level view of current context on a service's details. When collaborating across teams, you can see at-a-glance who owns the service, who’s on-call, or how to contact the Team responsible for the service. To access a service’s profile, navigate to Services Service Directory and click the desired service’s name.

🚧

Required User Permissions

  • Full Stakeholders, Observers, Responders, Managers, Admins and Account Owners can view all services.
  • Restricted Access users will only be able to view services that they have been access to via team or object permissions.
  • Limited Stakeholders cannot view services.

Service Details

Service Name and Description

The name and description of the PagerDuty service. Managers of a service and Global Admins can edit a service name or description inline by clicking the Edit button. For best practices on naming your services, please see Step 1 of Create a Service.

Status

The status is the current state of the service with regards to whether there are any open incidents.

  • No Open Incidents: There are currently no open incidents on the service.
  • Awaiting Response: There are one or more open incidents on the service with a Triggered status that have not been Acknowledged yet.
  • Response in Progress: There are one or more open incidents on the service with an Acknowledged status.
  • Disabled: The service is currently disabled and will not trigger any new incidents.
  • Maintenance: The service is currently in maintenance mode.

Status takes the following precedence:

Disabled Maintenance Window Active with/without incidents.

On Call Now

The current user(s) on call for the service. This will display the full list of users on call at the first level of the escalation policy. If no one is currently on call for the service, this information will be highlighted so that you can easily identify gaps in on-call coverage.

Escalation Policy

The escalation policy being used by the service. You may click the name of the escalation policy to view its details.

Team

The Team that is associated with this service. If your account does not have the Teams feature available, the escalation policy associated with this service will be displayed instead.

Communication Channel

The Communication Channel field allows you to configure a link back to your preferred communication channel where the service’s owner and/or Team can best be reached. This may be an email, URL to a Slack channel, or a link to another form of contact.

📘

Note

The Communication Channel added here is for your Teams’ internal use, and doesn’t impact any webhooks you may have configured.

Activity Tab

The Activity tab gives an overview of your service’s activity related to incidents, change events, suppressed alerts and maintenance windows.

Open Incidents

The Open Incidents table allows you to view open incidents on your service, search by incident ID and take bulk actions such as acknowledge, resolve, merge or snooze. You may view alerts from each incident by clicking SHOW DETAILS under the incident's Title.

Recent Changes

If your service has a change events integration configured, the Recent Changes section will provide a list of the most recent change events that have taken place on the service. You will be able to view the change event Summary, Type of integration and the Created date and time. To view more details about the change event, click the Summary title.

If your service does not have a change events integration configured, there will be an empty table with the ability to Add a Change Integration on the right.

Resolved Incidents

The Resolved Incidents table allows you to view resolved incidents on your service, search by incident ID, or merge resolved incidents.

Suppressed Alerts

If there are event rules that suppress specific alerts for your service, you can view some of the most recent alerts in the Suppressed Alerts table.

Maintenance Windows

If you have maintenance windows on your service, they will be listed in the Maintenance Windows section in order of when they are scheduled.

Integrations Tab

The Integrations tab includes any integrations and extensions that you connect to and receive PagerDuty alerts from.

Integrations

In the Integrations section, you can view and configure inbound integrations to send events to the service. You can view and copy an integration key by clicking the to the right of the integration and clicking the clipboard icon next to it:

Add an Integration to a Service

Please read our Services and Integrations article for instructions on how to create a new service and add integrations, or add integrations to an existing service.

Edit an Existing Integration

Please read our Services and Integrations article for instructions on how to edit an existing integration.

Edit Alert and Incident Settings

To edit Alert and Incident Settings:

  1. Navigate to Services Service Directory click the name of your desired service select the Integrations tab click Edit next to Alert and Incident Settings.
  2. Select whether you would like to Create both alerts and incidents or Create incidents only.
  3. Click Save Changes.

Settings Tab

The Settings tab includes settings that help your team respond to incidents.

Automate

Automate incoming alerts and how they are managed with Event Rules and Alert Grouping.

Assign and Notify

Assign and notify your responders when an incident is triggered with custom escalations, notification behaviors, support hours, and actions.

To edit these settings, you can click Edit and then change the default settings. There are four options to configure how your team is notified for an incident:

  • High-urgency notifications, escalate as needed: Any incidents triggered with this setting will notify the on-call responder based on the high-urgency notification settings on their profile and the incident will escalate using escalation policy rules.
  • Low-urgency notifications, do not escalate: Any incidents triggered with this setting only notify the current on-call responder based on the low-urgency notification settings on their profile, and it will not escalate the incident.
  • Dynamic Notifications based on alert severity: Notify users about incidents classified as either high or low based on the criticality defined by the integrated monitoring tool.
  • Based on support hours: Responders will only be notified within your predefined Support Hours. You may designate specific notification settings during and outside of Support Hours. Optional: You may also choose to check the Raise urgency of unacknowledged incidents to high checkbox.

You can learn more in our Configurable Service Settings article.

Remediate

Remediate incidents faster with a link to your team’s runbook for triaging incidents, or a custom incident action.

Co-ordinate Responders and Stakeholders

Coordinate responders and stakeholders by automatically adding a default conference bridge to incidents on this service and immediately run a response play to engage stakeholders.

Impact Tab

Service Dependencies

🚧

Required User Permissions

Users with permission to view each service in a dependency relationship will be able to see Service Dependencies. If a user does not have permission to view one or both of the services, they will not be able to see the dependency relationship.

Service Dependencies can be used to define other technical or business services that your service uses or is used by your service. If an issue arises on your service or one of the dependencies you have configured, you can use the impact tab to quickly assess the scope of the impact.

You can expand each technical service to see details such as the associated escalation policy and who is currently on-call.

Add or Remove Service Dependencies via the Web App

🚧

Required User Permissions

Managers, Admins and Account Owners can add or remove Service Dependencies.

  1. Navigate to Services Service Directory and click the title of your desired service.

  2. Select the Impact tab. There are two sections: Add/Edit services that this service uses or add/edit ones that this service is used by. Click Add services or Edit Services to add/edit to your desired use case.

  3. On the Edit Services screen, you may search by service name, or select one from the Business Services or Technical Services tabs.

    • To add a service dependency: Click the button to add your preferred service(s); you may add multiple Business and Technical services. Optional: You may also create a new Business or Technical service from this screen by clicking Create a New Business Service or Create a New Technical Service from each of their corresponding tabs. This will open the Business Service or Technical Service configuration screen in a new tab.
    • To remove a service dependency: Click the button next to the service name.
  4. Click Save Changes.

Add Service Dependencies via API

You may add service dependencies using our REST API.

Service Dependencies in Incidents

You may view and add Service Dependencies from incidents using our Technical Service Dependencies for Triage feature.

Suggested Service Dependencies

Suggested Service Dependencies uses machine learning to suggest other services that may depend on your service, or that your service depends on. If incidents on your service tend to be followed by incidents on another service, or vice versa, Suggested Technical Service Dependencies will be provided. This feature ensures that a service’s dependency topography is continually up-to-date as your technical infrastructure evolves and changes. You may view Suggested Service Dependencies on individual services’ Impact tabs or on an active incident, which will have a blue pill with the number of suggested dependencies, if they are available:

View and Add Suggested Service Dependencies

  1. Navigate to Services Service Directory click your desired service’s name Impact tab. If your service has suggested dependencies, you will be able to view them by clicking the blue Suggested Technical Dependencies dropdown. If the machine learning algorithm has not detected any suggested dependencies, this blue dropdown will not be available.
  2. To add a Suggested Service Dependency: Click the next to the service name. To dismiss a Suggested Service Dependency: If you do not feel that a Suggested Service Dependency correlates with your service, click the next to the service name to dismiss the suggestion. Please Note: Once you dismiss a suggestion, it will never be shown again as a suggestion. If you change your mind, however, you may always manually add that dependency.

Service Dependencies in the Mobile App

Service dependencies can be viewed in the mobile app by navigating to Service Directory select your desired service tap the Dependencies button at the bottom of the details page. This will take you to the service dependencies page which will list the Business or Technical service(s) it uses or is used by.

FAQ

I already have a Slack channel configured for my service, why is it not appearing under Communication channel?

Communication channels are configured separately from Slack extensions for the service. You may have a channel where you’ve configured your PagerDuty notifications to appear, but the Communication channel should be where other teams can best reach out to your team. This may or may not be the same as the channel where your Slack extension is configured.

Updated 6 days ago


Service Profile


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.