Events indicate that a policy has been violated, meaning all of the policy conditions have been met for the set duration. In other words, events indicate that Metricly has detected anomalous behavior in one or more of the elements in your environment.

For example, if you create a policy for all EC2 elements with the condition “CPU Utilization greater than 90%” and a duration of 10 minutes, an event will be generated when an EC2 element’s CPU Utilization metric exceeds 90% for 10 consecutive minutes.

Event Categories

Event categories are user-assigned via the Policy Editor and associated with the severity of the event. Each event can be assigned one category. There are three color-coded categories that indicate the severity of the event.

Category Color Description
Info Blue The Info category indicates that a policy has been violated, but the anomalous behavior is not critical.
Warning Yellow The Warning category indicates that a policy has been violated, and there will likely be a more critical event in the future.
Critical Red The Critical category indicates that a policy has been violated, and the cause of the event should be addressed quickly.

Table 1-3: Event categories.

Assigning an Event Category

  1. Open Policy Editor.
  2. Underneath the Policy’s name, in the Category drop-down menu, select Info, Warning, or Critical.
  3. After completing the remaining fields in Policy Editor, click Save.

Viewing Events

The following tools allow you to view and analyze events in the Metricly UI:

  • Event Explorer: Event Explorer displays a comprehensive list of all the events in your environment. You can filter the list by the event category, source (Metricly or External), element, element type, and/or tag of the element(s) to which an event is associated. You can also filter events within a specific time frame. For more information about Event Explorer, see below.
  • Metrics page: Metrics page displays the events and metric data for a specified element. The amount of data displayed can be limited by selecting a time frame setting and by showing or hiding metric charts. For more information about Metrics page, see Metrics page.

Event Explorer

Event Explorer allows you to view, search, and analyze events.

If one of your policies is particularly noisy, you can delete all events associated with the policy. See Editing a Policy for more information.

  1. Search: Contains several filters where you can search for Event (i.e. the policy that created the event), event category, source (Metricly or External), element, element type, Element tag, and/or Event tag. Expand the More filter to see additional filters; select a filter to add it to the list of active filters. For more information on creating event tags, see the external events section below.
  2. Events list: The Events list lists events by the date and time they occurred, the name of the policy that generated the event, the event category, the source of the event (Metricly or External), the name of the element(s) to which they are associated, and the type of the element(s) to which they are associated. Click the name of the policy in the Event column to view the violating metrics on the Metrics page (source = Metricly) or the event message (source = External). Click the Element’s name to view the element’s Element Detail panel. You can also navigate to Policy Editor to edit the policy associated with the event by clicking the Event name (events from Metricly only).
  3. Events graph: The Events graph displays the events in your environment based on the Time Frame setting and other search filters. Click an event to have the option of viewing the violating metrics on the Metrics page or edit the policy the event is associated with.
  4. Time Frame: The Time Frame controls the range of data displayed. To refresh data, click the refresh  button. Selecting “1w” in the Time Frame displays the most recent week of data and/or elements. By selecting “Ending Now,” you can specify a range of data beginning with a date other than today. For more information, see Time Frame.

Navigating to a metric chart from the Event Explorer

  1. Click a Metricly-based event. A menu will display.
  2. Click View Violating Metrics.
    The Metrics page opens with the metric chart displaying only the metrics that were referenced in the policy that generated the event.

Zooming in on the Events graph

  • Click and drag across a region of the Events graph.

To reset the zoom on the Events graph, click Reset on the Events graph.

External Events

Currently, Metricly only accepts Informational events generated from external sources. These events can be viewed on the events timeline. Informational events are any messages pushed to Metricly and displayed in the event timeline. In this case, both external and Metricly-generated events would show in the event timeline. An example messages would be errors, status, or updates which can be displayed on the timeline

The following documentation will help you send external events using one of our supported external sources:

Click an external event icon  on the Events Graph to view more information about the event, including the event message, the event ID, and any tags (key-value pairs).