This document explains how to integrate Personalized Service Health with PagerDuty by:

- Setting up PagerDuty alert notifications.
- Synchronizing PagerDuty incidents with incidents in Personalized Service Health.

## Before you begin


[Verify that billing is enabled for your Google Cloud project](https://docs.cloud.google.com/billing/docs/how-to/verify-billing-enabled.md.txt#confirm_billing_is_enabled_on_a_project).

1. [Enable the Service Health API](https://docs.cloud.google.com/service-health/docs/manage-access.md.txt#enable-service-health-api-single-project) for the project that you want to create alerts for.
2. Set [permissions to configure log alerts](https://docs.cloud.google.com/service-health/docs/manage-access.md.txt#access_logs_and_configure_log_alerts).

## Set up an alert

Do the following:

1. [Create a PagerDuty notification
   channel](https://cloud.google.com/monitoring/support/notification-options#pagerduty).
   Cloud Monitoring controls the state shown by PagerDuty.

2. [Set up an alerting
   policy](https://docs.cloud.google.com/service-health/docs/configure-alerts-cloud-logging#set_up_an_alerting_policy), which
   describes the circumstances under which you want to be alerted and how you
   want to be notified. You'll define the alert condition, where you can set
   fields such as the Google products, locations, and state.

3. [Customize the content](https://docs.cloud.google.com/service-health/docs/configure-alerts-cloud-logging.md.txt#customize_the_content_of_the_alert)
   of the header and the alert notification.