Alerts

Stellate includes an "Alerts" module, that allows you to configure when to send alerts, which criteria trigger alerts in the first place, and who should be notified.

You will find the Alerts as a new tab in your service configuration and by default, each service has 3 alerts set up. Those will alert you for HTTP/4xx, HTTP/5xx, and GraphQL errors, notifying all of the users in your organization.

However, you can delete and customize those alerts to your liking. Each alert allows you to specify an interval, as well as an error condition that needs to be met. You also need to configure a name for the alert, as well as the notification channels used.

We currently support email-based notifications, both to users within your domain or a specific notification email you might be already using, as well as notifications in your Slack workspace.

Filters for GraphQL alerts

In addition to the default options available on all alerts, alerts for GraphQL errors allow you include or exclude specific GraphQL errors based on the error message or error code.

Notification Targets

Email

No specific configuration is required to send notifications via email.

Each notification email will include the name of the affected service, the error conditions as well as the last error message. The email will also include a link to change the alert configuration or unsubscribe from that specific alert.

Slack

We currently only support public Slack channels as notification targets.

To send notifications via Slack, you will first need to add the Stellate/GraphCDN Slack app to your Slack workspace. You can do this by heading to the Integrations for your organization and clicking the Connect link.

Once Slack is connected, you can select it as a notification target when creating or editing alerts and afterward select the specific channel or DM you would like to send the alert to.

PagerDuty

You can use email-based alerts to trigger PagerDuty incidents based on alerts configured in Stellate. PagerDuty includes a full guide on integrating with external services via email, which is a great place to get started.

At a high level the required steps to send Stellate alerts to PagerDuty look like this:

1. Create a new Service in PagerDuty, give it a name, and optionally a description.
2. Select which Escalation Policy this service should be a part of.
3. Select Email as the integration
4. Copy the Integration Email
5. Head over to the Alerts configuration page on your Stellate dashboard.
6. Click + Add notification.
7. Select Team member from the dropdown.
8. Add the PagerDuty email address from step 4 to the text field.
9. Make sure to save the updated alert.