Managing user notifications

This guide explains how to set up and manage notifications in Adverity.

Introduction

Set up notifications so that Adverity alerts you or other users about what happens in your workspaces and datastreams. Notifications are divided into several topics. For more information, see Notification topics.

You can only set up notifications for workspaces where you have Notifications Administrator privileges. For more information, see Managing user permissions.

Setting up notifications

Prerequisites

Before you complete the procedure in this guide, perform the following actions, if required:

Slack notifications

Set up a Slack workflow that starts with a Webhook event.
When setting the workflow, enter the notification message that you want to receive manually.

For more information, see the Slack documentation.

Microsoft Teams notifications

Set up a Microsoft Teams internal Webhook.

Procedure

To set up notifications, follow these steps:

Go to the Administration page.
In the secondary menu, in the Notifications section, choose the type of notification you want to set up: Email, Slack, or Microsoft Teams.
In the top right corner, click + Create subscription.
In the User field, select the user who should receive the notifications.
Enter the required information for the user. The information you need to provide here depends on the notification type:
- For email notifications, in the Email field, enter the user's email address.
- For Slack or Microsoft Teams notifications, in the Webhook URL field, enter the webhook URL. To test the webhook URL, click Open next to this field.
(Optional) For Slack notifications, in the Channel field, select the Slack channel where you want to receive the notifications. If you leave this field empty, Adverity sends the notifications to the default Slack channel.
In the Topics field, select the topics for which you want to receive notifications. For more information, see Notification topics.
Select the Enabled checkbox to turn the notification on. If you need to turn the notification off later, deselect this checkbox.
(Optional) Select the Notify about empty extracts checkbox to receive a notification when Adverity fetches a data extract without any data.
(Optional) For the Daily import status topic, select the time (UTC) at which you want Adverity to send these notifications.
In the Workspaces field, select the workspaces for which you want to receive notifications. If you leave this field empty, you will receive notifications for all workspaces that you have access to.
In the Datastreams field, select the datastreams for which you want to receive notifications. You can only select datastreams that belong to the workspaces you select in the Workspaces field. If you leave this field empty, you will receive notifications for all datastreams in these workspaces.
Click Save.

Editing notifications

To edit notifications, follow these steps:

Go to the Administration page.
In the secondary menu, click the type of notification you want to edit: Email, Slack, or Microsoft Teams.
Click the user for whom you want to edit notifications.
Edit the notifications.
Click Save.

Cancelling notifications

To cancel notifications that you do not want to receive any more, follow these steps:

Go to the Administration page.
In the secondary menu, click the type of notification you want to delete: Email, Slack, or Microsoft Teams.
Select the checkboxes of the users for whom you want to remove notifications.
In the top left corner of the page, in the drop-down menu for the selected users, click Delete selected subscriptions.

As a result, the selected users will no longer receive the selected type of notifications.

Notification topics

Notifications, errors, and warnings are divided into several topics. Each of the topics has several notifications, errors, and warnings associated with them. These are as follows:

Data Quality issues

This feature is at the Beta stage. It is only available to Adverity customers who are participating in the Beta testing. For more information, see Introduction to the Data Quality page.

Select this topic to be notified about data quality errors and warnings. This topic is available only for email notifications.

You will be notified if fetched data violates the rules of the monitors assigned to a datastream.

(Optional) Select the Exclude warnings for Data Quality or datastream and transformation issues checkbox to only receive notifications about errors. You will not receive notifications about warnings.

Datastreams and transformations

Select this topic to be notified about datastream and transformation errors and warnings.

Errors:
- Anything that prevents the datastream API query from completing, and stops data from being collected.
- Script errors during the transformation stage of the task, including errors that occur while setting up the script.
More comprehensive error reports can be created using a transformation script with a mailto instruction and a sub-table. For more information on configuring this custom script transformation, see Using custom script transformations and our guide to the mailto instruction.
Warnings:
- Incorrect datastream settings, such as not selecting any accounts for which to collect data.
- Large amounts of data in a datastream, which may cause the fetch to take a long time.
- Automatic adjustments to your datastream settings, e.g., if a date range is changed automatically to meet the connector requirements.
- Fields that are not supported or not found in a specific datastream or report type.

(Optional) Select the Exclude warnings for datastream and transformation issues checkbox to only receive notifications about errors. You will not receive notifications about warnings.

Unify Location Data transformation

Select this topic to be notified if an error occurs when using the Unify Location Data transformation to transform your data.

Import errors

Select this topic to be notified about the following issues when loading data into a destination, Adverity Data Storage or file storage:

Errors regarding the unique key or unique index.
Alerts that the number of allowed characters is exceeded.
Alerts that the primary key is not unique (or the primary key too long, this applies to MySQL only).
Errors raised when applying a mapping table to a data extract.

Daily status

Select this topic to receive a daily import notification. The daily import notification contains a summary of your daily import statistics from all active datastreams in your Adverity instance.

When selecting this topic, set the time at which you want to send the notifications (UTC time zone).

Match & Map transformation

Select this topic to be notified if the Match & Map transformation detects any new values in your data. These values will automatically be added to the current values.

Mapping

Select this topic to receive mapping notifications. These notifications inform you of all the successful new entries created by mapping tables, including:

A list of the new field entries.
The datastream and data extract to which the new entries have been added.
The workspace that contains the datastream with the new entries.

Authentication

Select this topic to be notified about the following authentication updates and issues:

A change or expiry of a datastream's authorization credentials.
Any datastream authorization tokens that have expired.

You will receive a notification about an authorization expiry only when it causes a fetch error.

Performance outliers

Select this topic to receive notifications if a task takes longer than usual. This notifies you of any performance outliers, as described in the Performance outliers section of our guide to the Performance Manager.

Data Mapping

Select this topic to be notified about any changes to the Data Mapping in the workspaces and datastreams you select.

Smart Naming Convention

Select this topic to be notified about the following Smart Naming Convention issues:

An error message when there are problems with the data that prevent it from splitting into columns, including:
- No delimiters are present in the data extract rows.
- Too many empty columns are detected (Adverity's limit is 9).
A warning that a value does not comply with the setup rules. For example, the rules are looking for a number but the value is a string.
A warning that a mandatory column needed for Smart Naming Convention is empty.