Service Directory

Use the Service Directory's flexible search engine to drill into relevant information and perform actions on services

The Service Directory is a searchable, high-level aggregate view of all PagerDuty services in your organization, and their corresponding owners. It allows everyone to search for the services they support and learn more about the other services in their organization. From the Service Directory, you can dive into each individual service to learn more about it, make changes to the settings, and take further action.

The Service Directory is generally available on all PagerDuty plans and replaces the old Services list view. You can access the old Services list view by selecting Return to previous version of Service list at the top of the page.

🚧

Required User Permissions

All users can view the Service Directory. The displayed results may vary, however, depending on a user’s permissions. Only users who have permission to create or edit a service can take those actions from the Service Directory.

Navigate to the Service Directory

In the PagerDuty web app, navigate to Services Service Directory.

The Service Directory provides the following information about services:

  • Service incident state
    • 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.
    • 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.
  • Service name and description
  • Team
    • If your account does not have Teams, the associated escalation policy will be displayed.
  • On Call Now
    • The user who is currently on call for the service.
    • If there are three or more users on call, this field will display the total number. You can click through to the service details page to see the full list of current on-call users.
    • 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.
  • Last incident
    • The date and time of the last incident that was triggered on the service. You can click the link to quickly access the details for that last incident.
  • Open incidents
    • The current number of triggered and acknowledged incidents on the service.

Search

With the Services tab selected, you can search for a service by name or description. By default, the results are ordered by highest relevance to lowest.

If you are not seeing any services populate, check to see if you have any filters applied. You may want to adjust your team filter to All teams and your incident filter to Any time. If you are still not seeing any results, you may need to contact your PagerDuty Admin to confirm that you have the correct permissions to view the services in question.

Search by Integration Key

The Service Directory allows you to search by integration key, returning a list of services that have a matching key. To search by integration key, you’ll need to prepend your search with key:, for example key:INTEGRATION-KEY-HERE.

Filter and Sort

Refine your results by combining search queries, filters and sorting. You can use the following filters to narrow down search results:

  • Team
  • Business Service
  • Last Incident
  • Sort By

Team

The Team filter defaults to all of your teams, but can easily be adjusted to include All Teams, No teams or a specific team. If a service is not associated with a Team, it will not appear when a Team filter is active. Please note that this filter is only available to accounts with the Teams feature.

Business Service

The Business Service filter allows you to filter for the technical services associated with a Business Service. Please note that you will need to configure your Business Services in order to return any results

Last Incident

The Last Incident filter allows you to filter by services that have had a recent open incident. The options are Any time, Within 24 hours and Within 7 days.

Sort By

The Sort By dropdown lets you further organize your search results. When first visiting the page, this defaults to alphabetical order. Once you enter a search term, the sort will default to order by relevance. The sorting options include most relevant, Service name (A-Z), Service name (Z-A), Oldest incident and Most recent incident. If services have never had an incident, the Last Incident Time is considered infinite, so will be ordered after all other incidents for Most Recent Incident.

Maintenance Windows

You can review and manage Maintenance Windows in the Service Directory by selecting the Maintenance Windows tab. To learn more, read Maintenance Windows.

Additional Service Directory Actions

Create a New Service

Users with appropriate permissions can click +New Service in the top right to create a new service. For more info, please read Create a New Service.

View Service Incidents

To view a service’s incidents, as well as information about the on-call rotation and upcoming maintenance windows, select More View Incidents to the right of a service’s listing.

View incidentsView incidents

View incidents

View Service Integrations

For quick access to integrations, users with appropriate permissions can use the shortcut More View Integrations to the right of a service’s listing.

View integrationsView integrations

View integrations

Dynamically-Built URL

As you enter search criteria and apply filters, the query parameters dynamically build in your browser’s address bar. This can be handy for bookmarking the URL, sharing the link with others, or addressing the following questions, for example:

  • Which services owned by my teams had incidents in the last week?
  • How many of the services in my organization have the word “database” in them?
  • Are there any services that have never had an incident and are currently unowned by a team? (Should we delete those services from PagerDuty?)

Did this page help you?