Skip to main content

What are Events?

An overview of Event management in CoolPlanetOS.

P
Written by Product Marketing
Updated over 2 months ago

Events are records of occurrences on a site, such as a compressor using too much energy over a period of time, which may indicate a malfunction. They are created by Watchers whenever a specific condition is met, based on a configuration provided by the user. Each event includes the following details:

  • Name: The name of the event (the name of the Watcher that created the event).

  • Start Date: The date and time when the event started.

  • End Date: The date and time when the event ended (when it was last seen to be true).

  • Duration: How long the event has occurred (or how long it has been ongoing).

  • Impact: The quantified impact of the event (optional).

  • Cost: The monetary cost associated with the event (optional).

  • Category: A category for the event (optional).

Event Group List View

The Event Group List view, shows a chronological list of the types of events which have occurred in the selected timeframe which match the search criteria (if any have been supplied). For each event group the following is displayed:

  • Name: The name from the Event Group (i.e. the watcher name)

  • Last Event Update: When the latest event started

  • Count: The number of times the Event occurred in the time period

  • Duration: Calculated from the start time until now/end time for each event in the Event Group for the time period

  • Impact: The impact of the events in the Event Group for the time period

  • Cost: The cost of the events in the Event Group for the time period

Clicking any of the rows on the Event Group List view brings you to the Event Group View, where you can see a detailed breakdown of the occurrences of the events of that type.

Event Group Details View

The Event Group Details View shows the details of the events in the Event Group, allowing evaluation to determine if they are problematic and require investigation or follow-up remediation tasks. By displaying multiple events in one view, users can identify patterns in event occurrences (e.g., consistently occurring first thing on a Monday). The Event Group View contains:

  • Name: The name of the Event Group the events are in

  • Date range: Defaults to the view used previously in the Event Group List View

  • Category: The name of the Event Group’s Category

  • Reporter: The name of the reporter (i.e. the watcher name)

  • Duration: Of the events in the Event Group for the time range.

  • Impact: Of the events in the Event Group for the time range.

  • Cost: Of the events in the Event Group for the time range.

The Event Group View includes a chart with the following:

  • Title: The chart will default to have the same title as the name of the Event.

  • Impact: A line showing the accumulating impact over time.

  • Cost: A line showing the accumulating cost over time.

  • Watcher Fired: A Boolean series showing when the events happened.

The time range displayed in the chart is controlled by the date range selector in the upper right of the screen.

Below the chart is a tabbed section with Events and Tasks tabs.

Events tab

This tab contains a list of each event in the Event Group within the specified timeframe. This Events list view includes:

  • Start time: When the event started

  • End time: When the event ended

  • Duration: Calculated from start time until now/end time of the event.

  • Impact: Of the event instance

  • Cost: Of the event instance

Tasks tab

This Tasks list view contains the following information:

  • Name: The name of the Task (from watcher if automatically created, otherwise given by user during manual creation)

  • Creation Date: When the task was created

  • Type: The type of the Task

  • Status: The Status of the Task

  • Time in Status: How long the task has been in the status

  • Assignee: Who the task is assigned to

Event Details View

The Event Details View is accessible by clicking the event in the Events Table. This view includes the following:

  • Name: The name of the Event Group to which this event belongs.

  • Category: The name of the Event Group’s Category

  • Reporter: The name of the reporter (i.e. the watcher name)

  • Started: When the event started

  • Ended: When the event ended (if it has ended)

  • Impact: Impact associated with this event.

  • Cost: Cost associated with this event.

  • Duration: Duration of this event

This view also contains a chart showing the following:

  • Title: The chart will default to have the same title as the name of the Event.

  • Impact: A line showing the accumulating impact over time.

  • Cost: A line showing the accumulating cost over time.

  • Watcher Fired: A Boolean series showing when the events happened.

  • Watcher Datasources: Each datasource used by the watcher that created this event is included in the chart.

  • Above and Below values: Any Simple Watcher "Below" and/or "Above" values are displayed as dashed lines.

  • Event Highlight: The time range during which the current event happened is highlighted with a vertical bar titled "This Event".

  • Data table: Under the chart is the data table used in the Expanded Widget view.

The chart has the following controls.

  • Change date range and interval (not persisted)

  • Enable a Period vs Period view (not persisted)

  • Add a datasource (not persisted). This uses the datasource picker to select an additional datasource to layer over the event data in the chart and table.

Did this answer your question?