Notification Options

When you create an alerting policy, you can have up to 16 notification channels to use for incidents. This page lists the supported notification channel types and explains how to configure them.

Profile and account settings

You must configure most notification channels before you use them in alerting policies. To configure a notification channel, you must have Editor access to the Stackdriver account.

Notifications are configured in two places in Stackdriver:

  • The Profile page is where you configure SMS notifications and the Cloud Mobile App. Click on your name in the top-right corner of the Stackdriver Monitoring console and select Profile.

  • The Account Settings page is where you configure other notification channels. Click on the account name in the top-left of the Stackdriver Monitoring console and select Account settings near the bottom of the list. Then select Notifications and the type of notification.

Other users with Editor access to your Stackdriver account can enter their own notification information. You will see their configurations, as well as your own, when you set up notification options for your alerting policy.

Email

When you create an alerting policy, select Email in the Notifications section and enter your email address. It's not necessary to configure email addresses before setting up your alerting policy.

If you wish to manage your project's existing email notification addresses, visit Account Settings > Notifications > Email. From here, you can select email addresses to change or delete:

Email configuration

Go to Email notification settings

Cloud Mobile App

Use Cloud Mobile App to monitor your GCP Console resources and Stackdriver information from anywhere.

To configure your mobile device to receive Stackdriver notifications, do the following:

  1. Install Cloud Mobile App from your mobile device's app store.
  2. In Cloud Mobile App: Select the Settings menu to configure the app for your Stackdriver account. You will be able to see your GCP Console resources.
  3. In Stackdriver: Go to your user profile and add your mobile devices:

    Go to your Profile

When you create an alerting policy, select Cloud Console mobile app in the Notifications section and choose your mobile device from the list.

PagerDuty

Integration with PagerDuty allows for one-way or two-way incident resolution with Stackdriver. To set up PagerDuty, do the following:

  1. In PagerDuty: Create a PagerDuty account at the PagerDuty site. You can optionally configure PagerDuty Sync for two-way sync with Stackdriver.

    For more information, see PagerDuty's Stackdriver Integration Guide.

  2. In Stackdriver: Visit Account Settings > Notifications > PagerDuty:

    Go to PagerDuty setup

  3. Click Add PagerDuty Service and follow the instructions.

    PagerDuty configuration

When you create an alerting policy, select PagerDuty in the Notifications section and choose your PagerDuty configuration.

In this document, the screenshots for Stackdiver are from an older version, but the information is accurate.

SMS notifications

To configure SMS notifications, first set up your phone number:

  1. In Stackdriver: Go to your user profile and add your phone number or SMS in the Phone Numbers section:

    Go to your Profile

When you set up your alerting policy, select the SMS notification type and choose a phone number from the list.

Slack

The Stackdriver Slack integration allows your alerting policies to post to a Slack channel when a new incident is created. To setup Slack, do the following:

  1. In Slack: Create a Slack channel at the Slack site.
  2. In Stackdriver: Go to Account Settings > Notifications > Slack:

    Go to Slack setup

  3. Click Authorize Stackdriver and follow the instructions on the Slack website.

    Slack configuration

When you create an alerting policy, select Slack in the Notifications section and choose your Slack configuration.

Campfire

The Stackdriver Campfire integration allows your alerting policies to post to a Campfire room when a new incident is created. To setup Campfire, do the following:

  1. You should already have a Campfire account and room. Campfire is no longer offered to new customers. For more information, see the Campfire site.
  2. In Stackdriver: Go to Account Settings > Notifications > Campfire:

    Go to Campfire setup

  3. Click Add Campfire Room and follow the instructions.

    Campfire configuration

When you create an alerting policy, select Campfire in the Notifications section and choose your Campfire configuration.

HipChat

The Stackdriver HipChat integration allows your alerting policies to post to a HipChat room when a new incident is created. To setup HipChat, do the following:

  1. In HipChat: Create a HipChat account and room at the HipChat site.
  2. In Stackdriver: Go to Account Settings > Notifications > HipChat:

    Go to HipChat setup

  3. Click Add HipChat Room and follow the instructions.

    HipChat configuration

When you create an alerting policy, select HipChat in the Notifications section and choose your HipChat configuration.

Webhooks

Stackdriver supports webhooks to notify remote services about incidents that occur. To set up webhooks, do the following:

  1. The webhook handler: Identify an endpoint URL that will receive webhook data from Stackdriver.
  2. In Stackdriver: Go to Account Settings > Notifications > Webhooks:

    Go to Webhooks setup

  3. Click Add Webhook and follow the instructions. The page has a sample of the data that will be sent to the endpoint, and some authorization options.

    Webhooks configuration

When you create an alerting policy, select Webhook in the Notifications section and choose your webhook configuration.

The sample message shown on the configuration page is the JSON representation of an incident. This indicates which alerting policy was triggered, when, the current status of the incident, and so forth. See Incidents and Events for more information.

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Monitoring