# Alert Policies

{% hint style="danger" %}
This feature is deprecated as of 25.4.4 (2025-12-30)
{% endhint %}

Telmai provides a set of out-of-the-box policies that are automatically created when a new dataset is added. Users also have the flexibility to create their own custom policies

## Out-of-box Policies

Below is the list of pre-defined policies

| **Policy**                        | **What is Monitored?**                                                                                                                                         |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Completeness Drifts*             | Changes in percentage of empty records                                                                                                                         |
| *DQ Rules Violation*              | Detection for any rule violation                                                                                                                               |
| *Data Difference*                 | <p>Addition/Removal of different records across tables.</p><p><br>Note: <a href="../profiling-data/data-diff">Data diff</a> must be enabled first</p>          |
| *Data Drifts*                     | Changes in various value formats (length, special characters, number of tokens, etc.)                                                                          |
| *Data Process Failures*           | Detection of any scan failure                                                                                                                                  |
| *Freshness Drifts*                | Table freshness drifts                                                                                                                                         |
| *Numeric Value Drifts*            | Changes in averages of numeric values for an attribute                                                                                                         |
| *PII Exposure*                    | <p>Presence of PII data in your dataset (email, IP, etc).<br></p><p>Note: This policy is disabled by default</p>                                               |
| *Record Count Correlation Drifts* | <p>Changes in data volume across correlated tables with defined lineage.</p><p>Note: For this policy to take effect, you need to define the tables lineage</p> |
| *Record Count Drifts*             | Changes in the number of scanned rows                                                                                                                          |
| *Record Id Uniqueness Drifts*     | <p>Changes in data uniqueness of record Id<br></p><p>Note: For this policy to take effect, you need to enable table Id</p>                                     |
| *Schema Drifts*                   | Changes in schema; example: column added or removed                                                                                                            |
| Top Values Drifts                 | This feature monitors the changes for the top 10 values. An alert is generated if new values are added or removed                                              |
| *Uniqueness Correlation Drifts*   | <p>Changes in data uniqueness across tables with defined lineage</p><p>Note: For this policy to take effect, you need to define the tables lineage</p>         |
| Uniqueness Drifts                 | Changes in data uniqueness across attributes                                                                                                                   |
| *Value Distribution Drifts*       | Changes in the distribution of the top 20 most frequent categorical values                                                                                     |
| ~~*Correctness Drifts*~~          | ~~Changes in the percentage of correct records based on defined expectations~~                                                                                 |

## Modifying/Reviewing Existing Policies

You can view, modify, or disable existing policies anytime by navigating to the **“Alerting Policies”** page and selecting the relevant dataset. The policies are displayed in a table with the following properties:

* **Name**: Policy name (User-defined policies are marked in yellow; Telmai out-of-the-box policies are marked in green)
* **Metric**: The monitored metric
* **Tags:** A list of text tags. These tags are user defined, and can be used for tracking purposes
* **Impact:** User defined property for impact reporting. Value can be `LOW`, `MED` or `HIGH`
* **Status**: Indicates whether the policy is enabled or disabled
* **Create ticket automatically:** Optional to auto create ticket when incidents are created
  * If checked, user will need to specify a [ticket template](https://docs.telm.ai/telmai/api-reference/ticket-integration-api)
  * Ticketing integration must be setup for this feature to be visible (ex: [Jira](https://docs.telm.ai/telmai/integrations/jira-integration))
* **Actions**:
  * **Edit**: Modify policy properties or scope.
  * **Notifications**: Toggle notifications on or off
  * **Delete**: Remove the policy (Available only for custom policies)

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2FyiHeQGRc0ZkS8EtcXB6C%2Fimage.png?alt=media&#x26;token=a335c2d0-79f4-4451-8ea9-b9cddc266e57" alt=""><figcaption></figcaption></figure>

## User Defined Policy

Users can create custom policies to monitor any of the calculated metrics. These metrics are tracked by specifying a threshold that triggers an alert when violated. The supported thresholds include:

### **Supported Threshold**

* **Telmai-ML**\
  Telmai’s built-in anomaly detection using machine learning
* **Relative Drift**\
  Percentage change in data compared to previous scans or the average of scans
* **Acceptable Range**\
  Check if a metric falls within a specified range

### **Steps to Create a Custom Policy**

1. Navigate to “Alerting Policies” page & choose the “Policies” Tab
2. Click the "New Policy" button to start defining your policy.
3. A side menu will appear similar to this image<br>

   <figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2FHA3ubSmDh4LxoR9tDznH%2Fimage.png?alt=media&#x26;token=0fc572a6-f1a8-424e-80ea-e1058c34b218" alt=""><figcaption></figcaption></figure>
4. Select desired “Tracked Metric” from the list of
   * User-defined metrics, or
   * Health metric calculated by Telmai
5. Based on Metric selection, the user may need to select tracked attributes (ex: correctness, the user will need to specify associated attributes)
6. Select detection type\
   Note: In case of Relative and Range detections, the user can specify how to handle the metric when not available (replace by zero or average)
7. Add [notification](https://docs.telm.ai/telmai/monitoring-data/monitors-management/configuring-notifications) channels, by clicking "Notifications" button
   1. Click +Add Channel
   2. Select a value from the list of defined channels.
   3. Repeat above for all desired channels
8. Click Save
