Customize budget alert email recipients

Overview

The default behavior of a budget is to send alert emails to Billing Account Administrators and Billing Account Users on the target Cloud Billing account when the budget alert threshold rules trigger an email notification.

Diagram of budget alert notifications
Figure 1: Illustrates the default email functionality for budget alert notifications and the optional method to customize the email recipients using Cloud Monitoring.

Billing Account Administrators will always receive budget alert emails, but they might not be the best recipient to take cost control actions based on the alerts. For example, you might want to email budget alerts to a project manager without needing the project manager to also be a Billing Account Administrator. Using Cloud Monitoring notifications, you can choose additional email addresses to receive alert emails, ensuring that your budget alerts are seen by the right people.

To customize additional people to receive the budget alert emails for a specific budget, Link monitoring email notifications to the budget, and select up to five email notification channels.

Using the optional Cloud Monitoring notifications, budget alert emails are sent to the following people:

  • The email addresses in the selected email notification channels.
  • Anyone assigned the role of Billing Account Administrator or Billing Account User on the Cloud Billing account that owns the budget.

Permissions required for this task

To set up Cloud Monitoring notification channels and link them to a Cloud Billing budget, you need the following roles:

  • To create or modify a budget for your Cloud Billing account, you need the Billing Account Administrator role on the Cloud Billing account.
  • To create or modify a Cloud Monitoring Workspace and/or to create or modify Cloud Monitoring notification channels, you need the Monitoring Editor role on the host project that contains the Cloud Monitoring Workspace that stores the notification channels.

    Specifically, you must have the following permissions:

    To edit an existing Cloud Billing budget to link it to an existing Cloud Monitoring notification channels, you need these specific permissions:

Permissions required for budget alert email recipients to view the budget

When you select Cloud Monitoring email notification channels to customize who receives alert emails (in addition to Billing Account Administrators and Billing Account Users on the target Cloud Billing account), the email addresses specified are sent the budget alert emails when the threshold rules trigger an alert.

The budget alert emails contain helpful links to the budget, so that you can quickly view it and take any appropriate actions. The people you specify to receive alert emails using email notification channels might not have the correct permissions to view the Cloud Billing budgets in the Cloud Console.

If you want the recipients of the alert emails to be able to view the budget, email recipients need permissions on the Cloud Billing account. At a minimum, ensure email recipients are added to the Billing Account Viewer role on the Cloud Billing account that owns the budget. See View a list of budgets, including month-to-date spend for additional information.

For more information about Google Cloud permissions, see:

How to setup and enable Cloud Monitoring email notifications

To customize the email addresses that will receive budget alert notifications, link notification channels to your budget.

To link, edit, or remove notification channels linked to your budget, do the following:

1. Create a Cloud Monitoring Workspace and notification channels

Before you link your Cloud Billing budget to Cloud Monitoring notification channels, we recommend you first create a Cloud Monitoring Workspace. Then in the Workspace, create a Cloud Monitoring notification channel for each of the email addresses you want to send budget alerts to.

A Cloud Monitoring Workspace is contained within an existing Cloud project. A Workspace is the top-level container that is used to organize and control access to your Monitoring notification channels.

Notification channels must belong to a Monitoring Workspace, so you need to create at least one Workspace before adding Monitoring notification channels.

  1. To create a Monitoring Workspace, follow the steps in Creating a Workspace.

  2. After you have a Monitoring Workspace, do the following to create new notification channels for email addresses:

    1. Sign in to the Google Cloud Console and go to the Monitoring page.

      Go to Monitoring

    2. In the Monitoring navigation pane, click the Workspace dropdown, and select your preferred Workspace.

    3. Click Alerting.

    4. Click Edit notification channels. The Notification channels dashboard contains a section for each notification channel type. Below a section header is a list of all configurations for that type.

    5. Scroll to the Email section to view a list of the email addresses already configured as notification channels.

      • To add an email, select ADD NOTIFICATION CHANNEL, and then select Email. Enter the email address (required) and display name (optional). Click Save after your changes are complete.
      • To modify an email, click Edit . Click Save after your changes are complete.
      • To delete an email, click Delete . Click Delete in the confirmation dialog.

To link a Cloud Billing budget to Cloud Monitoring Email notification channels, do the following:

  1. Sign in to the Google Cloud Console.

    Sign in to Cloud Console

  2. Open the console Navigation menu , and then select Billing.

    If you have more than one Cloud Billing account, do one of the following:

    • To manage Cloud Billing for the current project, select Go to linked billing account.
    • To locate a different Cloud Billing account, select Manage billing accounts and choose the account for which you'd like to manage a budget.
  3. In the Billing navigation menu, select Budgets & alerts.

  4. If necessary, create a budget. Or, to edit an existing budget and alert rules, click a budget name.

  5. In the Actions section, under Manage notifications, select Link Monitoring email notifications to this budget.

  6. In the Workspace field, click Select workspace and choose the Cloud Monitoring Workspace that contains the notification channels.

  7. Under Notification Channels, select up to five existing notification channels, or click Manage notification channels to edit or create email notification channels on demand in the Cloud Monitoring Workspace.

    • If you are editing a budget, you can link new notification channels or unlink previously selected email channels by toggling the checkboxes next to the channel names.
    • While editing a budget, if you can no longer see an email notification channel that you previously linked to the budget, this might be because the notification channel was deleted from the Cloud Monitoring Workspace. To learn more about viewing, editing, or deleting notification channels, visit Notification options.
  8. Click Save.

Delivery guarantees for Monitoring notifications

After you create a budget and link it to Cloud Monitoring email notification channels, you can expect emails to be sent as described here:

  • It may take several hours before receiving the first alert email.
  • Email alerts are sent only when triggered by the threshold rules.
  • If the Cloud Billing account has no usage, no email notification is sent.
  • If delivery fails due to notification channel misconfiguration, you will not be notified.
  • Delivery will fail if the notification channel no longer exists.