This document describes how to edit, list, and view your alerting policiesby using the Google Cloud console. For example, it describes how to edit a policyso that it is associated with anApp Hub application.This page also describes how to view the JSON representation of a policy,how to add alerting policies to a custom dashboard, which lets you view yourpolicies in the same context as your metric data.

This document doesn't describe how to edit, list, and view your alertingpolicies by using the Cloud Monitoring API.For more information, seeManage alerting policies by API.

This feature is supported only for Google Cloud projects.ForApp Hubconfigurations, select the App Hub host project or management project.

Before you begin

Complete the following in the Google Cloud project that stores your alertingpolicies:

1. To get the permissions that you need to create and modify alerting policies by using the Google Cloud console, ask your administrator to grant you theMonitoring Editor (roles/monitoring.editor) IAM role on your project. For more information about granting roles, seeManage access to projects, folders, and organizations.

   You might also be able to get the required permissions throughcustom roles or otherpredefined roles.

   For more information about Cloud Monitoring roles,seeControl access with Identity and Access Management.

2. Verify that you're familiar with the general concepts of alerting policies.For more information, seeAlerting overview.

Edit, list, or delete alerting policies

1. In the Google Cloud console, go to thenotifications Alerting page:

   Go toAlerting

   If you use the search bar to find this page, then select the result whose subheading isMonitoring.

   TheAlerting page displays panes that list summary information,incidents, and alerting policies.

2. In the toolbar of the Google Cloud console,select your Google Cloud project. ForApp Hubconfigurations, select the App Hub host project or management project.

3. ClickSee all policies in thePolicies pane.

   ThePolicies page lists all policies, includes a filter bar, andfor each policy, options to edit, copy, or delete the policy:

   • To filter the list of alerting policies, do one of the following:

     • Enter a name on the filter bar. For example, to display only policieswhose name containsExample, enterExample.A case-sensitive comparison tests whether a policy is listed.
     • ClickFilter policies, select the filter property, and then eitherenter a value for the filter or select a value from the menu.

     When you add multiple filters, a logicalAND joins the filters.

4. Optional: To view the details of a policy, click the name of the policy. For information about thePolicy details page, seeView an alerting policy.

5. Optional: To edit or copy a policy, clickmore_vertMore options, and select the corresponding option. Editing and copying a policy is similar tocreating a metric-based alerting policy. However, not all fields can be modified. When done, clickSave policy.

6. Optional: To delete a policy, clickmore_vertMore options and selectDelete. In the confirmation dialog, selectDelete.

   If a dashboard contains a chart that displays data for an alerting policy,then that chart stops displaying data when the alerting policy is deleted.For more information, seeAlerting policy widget doesn't display any data.

View an alerting policy

1. In the Google Cloud console, go to thenotifications Alerting page:

   Go toAlerting

   If you use the search bar to find this page, then select the result whose subheading isMonitoring.

2. In the toolbar of the Google Cloud console,select your Google Cloud project. ForApp Hubconfigurations, select the App Hub host project or management project.

3. To list all policies, clickSee all policiesin thePolicies pane.

4. Find the policy that you want to view, and then select it.

   The details page for the alerting policy opens. Here, you can monitor or edityour policy and view related data, such as incidents and notifications.Additionally, you can do the following:

   • Modify the time range for the data shown in the chart. Charts have limitedresolution and might not show every measurement for some time ranges.

   • Edit your alert to add user-defined labels, which will be included in yourincidents and notifications. For more information, seeAnnotate incidents with labels.

   • Change the enabled state of the policy. When a policy is disabled, you won'tget notifications.

   Note: A re-enabled policy might trigger immediately. For more information,seeNotifications for disabled alerting policies.

View the JSON representation of an alerting policy

When you create or modify an alerting policy by using the Cloud Monitoring API,you provide a JSON representation of that policy to the API method. You cancreate the JSON yourself by using the API documentation to guidethe content. An alternative is to create a policy by usingthe Google Cloud console, and then download the policy to your local system.The JSON file that you downloaded can be edited and used as a template for otherpolicies. For examples of policies described by JSON, seeSample policies.

To download the JSON representation of an alerting policy,do the following:

1. In the Google Cloud console, go to thenotifications Alerting page:

   Go toAlerting

   If you use the search bar to find this page, then select the result whose subheading isMonitoring.

2. In the toolbar of the Google Cloud console,select your Google Cloud project. ForApp Hubconfigurations, select the App Hub host project or management project.
3. Find the policy that you want to view, and then click the policy name to openthePolicy details page.
4. Clickget_appJSON.

To view the JSON representation of an alerting policy when you're editing it,clickcode View code.

Add alerting policy to dashboard

To view your alerting policies in the same context as your metric data,add those policies to acustom dashboard.When you view that dashboard, itshows a chart for each alerting policy that you added. These charts displaythe monitored metric, the threshold, and the number of open incidentsfor the policy. These charts also contain links that let you view or editthe policy.

You can add policies with one condition to custom dashboards. Policies thatcontain multiple conditions can be viewed only from the alerting context.

To display a summary of an alerting policy on a custom dashboard,do the following:

1. In the Google Cloud console, go to thedashboard Dashboards page:

   Go toDashboards

   If you use the search bar to find this page, then select the result whose subheading isMonitoring.

2. In the toolbar of the Google Cloud console,select your Google Cloud project. ForApp Hubconfigurations, select the App Hub host project or management project.
3. Select a dashboard or clickCreate dashboard.
4. In the toolbar, clickadd Add widget.
5. In theAdd widget dialog, selectnotificationsAlert Policy.
6. Clickarrow_drop_downAlert policy, and then select analerting policy. Only single-condition alerting policies can be selectedfrom theAlert policy menu.
7. To apply your changes to the dashboard, in the toolbar,clickApply. To discard your changes, clickCancel.

The following screenshot illustrates a chart for an alerting policy:

In this example, the alerting policy is monitoring the CPU usage of twodifferent virtual machines. The dashed line shows the condition threshold,which is set to 50%. The green chip with the labelNo incidentsindicates that there are no open incidents for the alerting policy. Ifyou place your pointer on the chip that shows the number of openincidents, then a dialog opens that links to the underlying alertingpolicy.

For more information, seeDisplay alerting policies and incidents on a dashboard.

Associate an alerting policy with an App Hub application

By adding user-defined labels to an alerting policy, you can associate itwith a service or workload that is part of anApp Hub application. These labels are included inincidents and notifications, and the alerting policy is also listed in theApplication Monitoring dashboards. To learn more about labels, seeAnnotate incidents with labels.

To associate an alerting policy with a workload or service by usingthe Google Cloud console, do the following:

1. In the Google Cloud console, go to thenotifications Alerting page:

   Go toAlerting

   If you use the search bar to find this page, then select the result whose subheading isMonitoring.

2. In the toolbar of the Google Cloud console,select your Google Cloud project. ForApp Hubconfigurations, select the App Hub host project or management project.
3. Find the alerting policy, clickmore_vertView more,selectEdit, and then go to theNotifications and name section.

4. In theApplication labels section, select your application andthen select your service or workload:

   

5. ClickSave policy.

After you complete these steps, labels with the following keys are attached toyour alerting policy. These labels identify your application and your service orworkload:

• apphub_application_location
• apphub_application_id
• apphub_service_id orapphub_workload_id

You can also add user labels to an alerting policy by using theGoogle Cloud CLI, Terraform, or the Cloud Monitoring API.However, you must use the label keys shown in the previous example.For more information, see the following:

• Manage alerting policies by API.
• Manage alerting policies with Terraform.