Subscriptions Overview

A subscription listens for Control Hub events and then completes an action when those events occur. For example, you can create a subscription that sends a message to a Slack channel or emails an administrator each time a job status changes.

You configure the following components for each subscription:

Event
A subscription is triggered by a Control Hub event - such as a changed job status, a triggered data SLA, or a registered Data Collector that has stopped responding. You can create a subscription for a single event type.

You can also define conditions to filter subscription events so that only a subset of events performs an action. For example, you can configure a subscription so that Control Hub sends an email only when the job named WestCoastSales changes status instead of when every job changes status.

Action
After the event occurs, the subscription performs an action - such as using a webhook to send an HTTP request to an external system or sending an email.
Important: Before Control Hub can trigger subscriptions for your organization, your organization administrator must enable events for your organization.

Working with Subscriptions

The Subscriptions view lists all subscriptions that you have created.

You can complete the following tasks for subscriptions:

  • Create subscriptions.
  • Edit subscriptions.
  • Enable and disable subscriptions.
  • Share subscriptions with other users and groups.
  • Delete subscriptions.

The following image shows a list of subscriptions in the Subscriptions view. Each subscription is listed with its configured event and action:

Note the following icons that display for subscriptions when you select a subscription. You'll use these icons frequently as you manage subscriptions:

Icon Name Description
Add Add a subscription.
Refresh Refresh the list of subscriptions.
Toggle Filter Column Toggle the display of the Filter column, where you can filter the list of subscriptions by status.
Share Share subscriptions with other users and groups, as described in Permissions.
Edit Edit the subscription
Enable Enable the subscription so that it can listen for events.
Disable Disable the subscription.
Delete Delete the subscription.