Ascend includes a notification system to alert operators on events occurring in the platform. Notifications are configured per Data Service and are sent as a webhook. Each Data Service contains multiple webhooks, each of which can customize:

The webhook endpoint
Body, templatized through "Handlebars" syntax
HTTP headers
Which Platform Events to subscribe to

The customizability of Ascend's notification system allows for integrating with most common alerting systems, like PagerDuty and OpsGenie, as well as custom webhook processors.

Screen Shot 2021-01-12 at 8.05.55 PM.png

Platform Event Categories

The full list of Platform events is broken down into different categories of the Ascend API and which Ascend entities the events apply to.

Category	Event	Applicable Entities
Dataflow Events	Create Modify Delete View Records	Read Connector Transform
Management Events	Create Modify Delete	Data Service Dataflow Service Account User Team Membership Permission
User Login / Signup Events	Log In Sign Up	User
System Processing Events	Up to Date Error	Read Connector Transform Write Connector
Ad-Hoc Query Processing Events (Users issuing data queries)	Submission Completion Cancellation	Query

Payload Template

Ascend will send a default JSON HTTP body in the webhook for the event subscription. However, each endpoint may customize the body through through "Handlebars" syntax.

The payload is rendered with an "event" variable, enabling a dynamic webhook body. Below is an example of creating a JSON formatted body using a few different variables.

{
  "fields": {
    "Email": "{{event.user.email}}",
    "Action": "{{event.type}}",
    "Time": "{{event.event_time}}",
    "Environment": "{{event.environment}}"
  }
}

The Webhook Notification Event Variable reference documentation contains the full list of fields available.