Managing Events
Events / Managing Events

Event communication is one of the primary features of StatusDashboard.  Events are service disruptions or degradations (either planned or unplanned) that impact the services you display on your dashboard.  It is critical that you create and update events in a timely fashion and communicate status effectively with your customers and users, and StatusDashboard gives you the tools to facilitate that interaction.

There are two types of events in StatusDashboard, Incidents and Scheduled Maintenance.  Incidents are typically unplanned service disruptions and scheduled maintenance events are service disruptions that are known and scheduled in advance.  To create events, navigate to Events > Create [Incident | Maintenance] and complete the relevant fields.  The list of fields and options related to events are detailed below.  All fields may be updated after the event is created.

Field

Event Type

Required

Description

Start Date

All

Yes

The start date of the event, shown in the timezone of the user creating the event. Incident events may not have start dates/times in the future.

Start Time

All

Yes

The start time of the event, shown in the timezone of the user creating the event. Incident events may not have start dates/times in the future.

End Date

All

Depends

The end date of the event, shown in the timezone of the user creating the event. This field is optional for incident events and when excluded, indicates that the incident is still open. This field is required for maintenance events.

End Time

All

Depends

The end time of the event, shown in the timezone of the user creating the event. This field is optional for incident events and when excluded, indicates that the incident is still open. This field is required for maintenance events.

Description

All

Yes

The description of the event.

Severity

All

No

The severity of the event.  The currently supported severities are:

  • Minor Performance Issue
  • Major Performance Issue
  • Minor Outage
  • Major Outage 

Status

All

Yes

The current status of the event.  As you update an event throughout its lifecycle, you should change the event status to let your customers and subscribers know what progress is being made.

Incident Events

Investigating

There is a known, active incident that is currently being investigated, but the cause and resolution are unknown.

Identified

The cause of the incident has been identified, and your team is actively working on a resolution.

Monitoring

A fix for the incident has been implemented, and the services are currently being monitored to verify resolution.

Resolved

The incident has been fully resolved and all services have returned to a normal state. When setting an incident to a resolved state, an end date must be supplied.


Maintenance Events

Planning

The maintenance event is being planned.

Started

The maintenance event has started.

In Progress

The maintenance event is under way.

Verifying

The maintenance has been completed, and all changes are being verified.

Completed

The maintenance event has been completed.

Event Visibility

All

No

Control whether or not the event is visible in different areas of the admin or dashboard. When any of the toggle buttons are selected, the event will be excluded from that specific feature.

Impact Analysis

All

No

Any potential or expected consequences of the event may be listed here.

Coordinator

All

No

If a particular individual or team member will be responsible for coordinating the event, their contact details may be listed.

Services Impacted

All

Yes

A listing of all services that are impacted by the event.

Automatic Start/End

Maintenance

No

When enabled, we'll automatically start and end your event based on the times for the event that you have selected. We'll also trigger any notification methods that you have set in your default notification options when we start and end the event. Note that your start/end times must have seconds equal to '00' in order for us to start/end the event.

You are highly encouraged to use this option when scheduling maintenance events so that your event timeline matches the scheduled maintenance.

Notifications

All

No

A number of notification methods for alerting users about events are supported.  The following integrations are currently supported for notifying users whenever events are created or updated. Each time an event is updated, you can select which notification methods you want to activate as well as any custom options for that notification method.

Email

Send email notifications with all current event information to users who have subscribed to dashboard email updates.

HipChat

Post a message to one or more HipChat rooms with a custom message and a link to the dashboard event page.

Slack

Post a message to one or more Slack channels with a custom message and a link to the dashboard event page.

SMS

Send SMS notifications with a link to the dashboard event page to users who have subscribed to dashboard SMS updates.

Twitter

Post a tweet to a configured Twitter timeline with custom text and a link to the dashboard event page.

Webhooks

Send programmatic messages to subscribed http/https endpoints with a JSON payload containing all current information about the event.


Updating Events

To update an existing event, navigate to Events and select either Incident List or Maintenance List.  You may modify the event by selecting the edit icon next to the event in the search results.  From the event update screen, you may enter an event update (including a status change), modify any of the existing event parameters and broadcast notifications to your subscribed customers.  In order for the event timeline to be updated, you must enter an event update in the update field (e.g. if you only change the event status or another event parameter, the timeline will not be updated).

Scheduled Maintenance Templates

Scheduled maintenance templates can be used as a starting point when creating scheduled maintenance events. If you frequently schedule maintenance events where you use the same settings and language, you can create templates to greatly simplify future event creation.  Once a maintenance template has been created, the only values that you need to enter in order to create a maintenance event are the start/end date and time.

Still have questions?  Contact our support team.  We're always happy to help with any questions you might have.