Services

A service is what catches all of your incoming alerts and routes the alerts to the appropriate escalation policy.

Create a Service

  1. On the left navigation bar, select Services.
  2. Select the + in the lower right.
  3. Fill out the requested information and select Submit.

Create Integration key

The integration key is the key (clever, I know) used by GoAlert to map API calls or inbound emails to your service for alert creation. You must have an integration key to send alerts to your service. To create this key, select Integration Key. Then, on the integration key page for your service, select the + in the lower right and give your generic API key a name.

You can use this key to create alerts via any API call, email, or with ShuttleIO. If you’d like, you can call the GoAlert API directly to create alerts. Review our API documentation at yourgoalertdomain.com/docs or under Sending Alerts within our documentation for additional information.

Alerts

On a service, you have the ability to view all alerts associated to that specific service. Next to the Alerts option on the service details page, you’ll see a green bar if there are no active alerts and a yellow bar if you have one or more alerts in an unacknowledged or acknowledged status.

By selecting Alerts on the service details page, you can see all alerts that have ever been associated to this specific service. Also, on the service’s alerts page you can Acknowledge/Close All active alerts on the service. This feature is useful when you have receive multiple alerts at the same time. To use this feature, select the ellipsis in the menu bar (upper right corner) and then select Acknowledge All Alerts or Close All Alerts. Note, this action will apply to any active alert currently associated with the service.

Assign Escalation Policy

In order for a service to send notifications, it must be associated to an escalation policy. To do this, perform the following

  1. Select the ellipsis in the menu bar (upper right corner) and then select Edit Service
  2. Search for any existing escalation policy in the Escalation Policy drop down. Note, a service can be associated with one and only one escalation policy.
  3. Select Submit to save your changes. Your escalation policy will now be listed in the top section of the Service Details page.

On-Call Users

Once you have everything you need for a service to notify people of alerts, you’ll see the people who are currently on-call and at which step in the escalation policy they will be notified in the On-Call Users table. This table is a quick way you can verify that you’ve got everything configured to send alert notifications.