Widget Alerts enable you to set up alerts directly on a widget based on a threshold, anomaly detected, or custom condition in your data and have the alert along with results sent via email/webhook/Slack.
Sections
- Creating a Threshold Widget Alert
- Creating an Anomaly Detection Widget Alert
- Creating a Custom Widget Alert
- Advanced Settings
- Send alert via Email
- Send alert via Webhook
- Send alert via Slack
- Sent alert via Teams
To get started, navigate to the widget you want to create an alert for and click the Add/Remove Alert Icon.
Creating a Threshold Widget Alert
- Navigate to the widget you want to create an alert for and click the Add/Remove Alert Icon.
- Select Add Alert + to open the Create Alert sidebar.
- Select the Threshold tab.
- Give your Alert a name. This is how it will be displayed in Alerts Management.
- In Alerts metric dropdown, select the field you want to set an alert on.
- Choose the the threshold type (i.e. >, >=, =, <=, <).
- In the Threshold box, enter the value that will trigger the alert.
- See section below for Advanced Settings.
- Select a Send Alert via action to configure alert to be sent via email/webhook/Slack/Teams
Creating an Anomaly Detection Widget Alert
Time-series anomaly detection is used to identify unusual patterns that do not conform to expected behavior, called outliers. This alert notifies you when such anomalies are detected within your data.
- Navigate to the widget you want to create an alert for and click the Add/Remove Alert Icon.
- Select Add Alert + to open the Create Alert sidebar.
- Select the Anomaly Detection (Beta) tab.
- Give your Alert a name. This is how it will be displayed in Alerts Management.
- In Alerts metric dropdown, select the field you want to set an alert on.
- Set the Anomaly Detection Threshold (default: 50). The threshold/band width determines the range of expected values. Values outside of the threshold are considered anomalies.
- Select the Date/Time Dimension - this is the time series feature of the selected dataset, typically used as the x-axis of time-series charts.
- Select a Dimension to detect anomalies across other fields in your dataset.
- Use the Preview button to preview the anomaly detection model which is trained and applied to the data.
- Select the type of dimension from Dimension drop-down to see the specific values.
- See section below for Advanced Settings.
- Select a Send Alert via action to configure alert to be sent via email/webhook/Slack/Teams.
Creating a Custom Widget Alert
- Navigate to the widget you want to create an alert for and click the Add/Remove Alert Icon.
- Select Add Alert + to open the Create Alert sidebar.
- Select the Custom tab.
- Give your Alert a name. This is how it will be displayed in Alerts Management.
- In the Cloud9QL condition editor, enter a custom alert condition syntax.
- The custom condition you’ve specified will trigger the alert.
- See the section below for Advanced Settings.
- Select a Send Alert via action to configure an alert to be sent via email/webhook/Slack/Teams.
Advanced Settings
These are additional options to configure your Alert. Check the Advanced Settings box to expand the menu.
- Generate Alert if no data is detected: Check this box to raise the alert if no data is returned from the alert condition.
- Attach conditional data: Check this box to attach the underlying dataset after the alert condition is applied as part of the alert. Expand Advance to attach a separate dataset when the condition is triggered. For example, if an alert is triggered for total Users crossing a threshold, but you need the data sent/attached to be from a list of Users from a separate dataset/query. Cloud9QL can be applied on that dataset to optionally manipulate the results
- Attach full dataset: Check this box to attach the full underlying dataset as a CSV
- Attach a Dashboard on trigger: Check this box to attach a PDF copy of the dashboard when the condition is triggered.
- Enable realtime alerts: Check this box to trigger the alert every time the dataset is updated. Not available for direct datasets. If users want to receive alerts based on time period, leave the box unchecked and specify the Run Every box with a value with minutes, hours, days, or months option. Mention the timezone in which you want the alert to trigger.
- Skip Alert if data is same as last alert: Check this box to skip this alert If the data is the same as the last alert. Useful to avoid repetitive alerts
Widget Alert Notifications: Send alert via
This section will walk you through setting up Alert notifications for Widget Alerts.
Email Alerts allows you to send the alert via email along with a CSV attachment of results to a list of recipients.
To set up an Email Alert:
- Under Send alert via, select the Email tab, then click Setup.
- Enter the Email Subject that will be displayed.
- Under Recipient List, enter the email address of the recipient(s). Comma separated for multiple recipients.
- Click on the Add Email From to enter the email address that the email will be sent from (support@knowi.com by default). This address will appear as the sender of the email when received in your inbox.
- Enter the Email Body. (Optional) Write custom HTML to customize the email template.
- Click Save Settings.
- Click Test Run (optional) to send a test email alert to the chosen recipient(s).
- Once configuration is complete, click Save Alert.
- You can add a new Alert or edit an existing one by clicking the Alert Icon in the widget.
Webhook
Webhook Alerts allow you to send an alert directly to your application (or third party applications). We'll send a POST request with a JSON payload of the data, which you can use to drive actions within your application.
The data in the POST will be a JSON formatted dataset of the full raw dataset for which the alert is generated.
To set up a Webhook Alert:
1. Under Send alert via, select the Webhook tab, then click Setup.
This opens up the Create new webhook sidebar.
2. Under Name, enter the name of the webhook.
3. Under URL to Invoke, enter the endpoint in your application that can accept a post request with JSON (Array of Objects). For example: https://webhook.site
4. Under the Authentication URL, enter the authentication endpoint to get a token, which can be passed into each subsequent query. Only required if the API requires it. This is an absolute URL.
5. Under Headers, enter any headers for HTTP requests to the “URL to Invoke” endpoint. There can be one header per line.
Knowi also provides the following C9 tokens which can be used to identify the alert on the Webhook headers.
- $c9_taskDate$: It denotes the date of the alert in the (yyyy-mm-dd) format
- $c9_taskName$: It defines the name of the webhook alert. For example: Test webhook
- $c9_taskId$: It denotes any Id of the alert. For example: 2971
- $c9_taskType$: This can be either “report” or “alert”
6. Under Auth Headers, enter any optional authentication-related headers. One header per line.
7. Click Create Webhook.
8. Click Test Run (optional) to send a test webhook alert to the chosen application.
9. Once the configuration is complete, click Save.
10. You can add a new Alert or edit an existing one by clicking the Alert Icon in the widget.
Slack
Slack integration allows you to trigger actions in your Slack channel(s) for a given condition triggered by an alert. When the condition is triggered, we'll send a message to a predefined channel(s) including the attachment of full data or conditional data depending on the options selected.
- Under Send alert via, select the Slack tab, then click Setup.
- If this is your first time connecting Knowi to Slack, click Add new Slack team. Follow the prompts to give Knowi access to your Slack account.
- Click Add New Slack Account. This opens up the Add Slack sidebar.
- Give your Alert a name.
- Under Alert Message, enter a user defined message that will show up when the Alert is received in Slack. If left blank, it will send a default message.
- In the Alert Team dropdown, choose the Slack workspace to send the Alert to.
- In the Alert Channels dropdown, choose the Slack channel to publish the Alert notifications to.
- Click Save Settings.
- Click Test Run (optional) to send a test Slack alert to the chosen channel(s). Here’s how the Alert will show up in you Slack channel:
- Once configuration is complete, click Save Alert.
- You can add a new Alert or edit an existing one by clicking the Alert Icon in the widget.
Teams
MS Teams integration allows you to trigger actions in your Teams channel(s) for a given condition triggered by an alert. When the condition is triggered, we'll send a message to a predefined channel(s) including the attachment of full data or conditional data depending on the options selected.
- Under Send alert via, select the Teams tab, then click Setup.
- If this is your first time connecting Knowi to Teams, click Add new teams account. Follow the prompts to give Knowi access to your Teams account. This opens up the Add Teams sidebar.
- Give your Alert a name.
- Under Alert Message, enter a user defined message that will show up when the Alert is received in Teams. If left blank, it will send a default message.
- In the Alert Team dropdown, choose the Teams workspace to send the Alert to.
- Click Save Settings.
- Click Test Run (optional) to send a test Teams alert to the chosen channel(s).
- Once the configuration is complete, click Save Alert.
- You can add a new Alert or edit an existing one by clicking the Alert Icon in the widget.