Incidents and events

An event occurs when the conditions for an alerting policy are violated. When an event occurs, Cloud Monitoring opens an incident. To view a list of incidents and events, do the following:

  1. In the Cloud Console, select Monitoring

    Go to Monitoring

  2. Select Alerting.

Incidents

The Incidents pane of the Alerting dashboard displays a partial list of incidents. The incidents are categorized under three tabs:

  • Open
  • Acknowledged
  • Closed

To view all incidents, click See all incidents. In the Incidents window, you can add filters to restrict the incidents that are displayed. To add a filter, click Filter table, and make a selection for the filter type. Based on the type you select, make a selection for the filter value or enter the value.

Open incidents

If an incident is Open, then the policy's set of conditions is currently being met or if there is no data to indicate that the condition is no longer met.

If a policy specifies multiple conditions, incidents open depending on how the conditions are combined. See Combining conditions for more information.

Acknowledged incidents

If an incident is listed in the Acknowledged tab if it is open and if the incident is marked as acknowledged. Marking an incident as acknowledge indicates that the incident is being investigated. Marking an incident as acknowledged doesn't change its state.

To mark an incident as acknowledged, go to the incident details and click Acknowledge incident. You must have the Monitoring Editor role, roles/monitoring.editor, to acknowledge incidents; for more information, see Access control: Predefined roles.

Resolved incidents

If an incident is Resolved state, then the policy's conditions are no longer met. An incident is listed as resolved if there is no data to indicate whether the condition still holds and the incident has expired.

For example, assume you have an alerting policy that is triggered if the HTTP latency is above 2 seconds for 10 consecutive minutes. If the alerting policy is triggered, an event occurs and an incident is created. If the next measurement of the HTTP latency is equal to or below 2 seconds, then the incident is resolved.

To mark an incident as Resolved, in the Incidents window, identify the incident, click More , and select Resolve.

You can mark an incident as Resolved but this action doesn't reconcile the underlying cause for the incident. That is, if the condition that generated the incident is true on the next alerting cycle, a new incident is generated.

Inspecting events

The Events pane of the Alerting dashboard displays the most recent events and includes a graphical indicator:

Part of an events listing.

  • To view an events details, click the event name. The details window includes when the incident was opened, the duration, and the status.

  • To view all events, click See all events. This opens the Events window. All events are listed.

    • To page through the events, use the Forward and Backward buttons.
    • To filter the events, click Show filters. You use the filter dialog to select the types of activities, the resources, and the name. If you leave a field at the default value, then this field isn't considered.

      Display of the event filter dialog.

      For example, to show all activities that are open, select Opened in the Activity types menu, and leave all other fields at the default value.

The following table describes the graphical indicators:

Indicator Meaning
Maintenance message icon. Maintenance message.
Cloud account added message. Cloud event message.
Database backup, config, or maintenance message. Database backup, configuration, or maintenance message.
Violation acknowledged, resolved, or opened message. Violation acknowledged (blue), resolved (green), or opened (red) message.
Instance migration or pre-emption, or Kubernetes message. Instance was migrated or pre-empted message. Kubernetes setup failure, not ready, or disk space limitation message.

Creating events

To manually create an event, do the following:

  1. In the Cloud Console, select Monitoring:

    Go to Monitoring

  2. Select Alerting, and then select See all events in the Events pane:

    Part of an events listing.

  3. Click Create event and complete the Add Custom Event diaglog:

    Custom event creation dialog.

What's next

  • To create and manage alerting policies with the Cloud Monitoring API or from the command line, see Using the API.
  • For a detailed conceptual treatment of alerting policies, see Alerting policies in depth.