# Anomalies Overview

Source: https://userguide.qualytics.io/anomalies/overview/

An anomaly records one or more quality check failures found by a Scan. It points to a record, a data structure, or a set of rows that did not meet what a check expects, and it keeps the evidence your team needs to decide what happened. This hub gathers everything about reviewing, triaging, and resolving anomalies.

The Deep Dive pages explain the concepts, from what an anomaly is and how a Scan creates it to its status, Impact, and fingerprint. The How-tos walk through each task step by step, grouped by what it changes. The API page covers the endpoints, and the FAQ answers the common questions.

> **Info: Permissions**
>
> The **Reporter** team permission on the datastore is enough to see its anomalies. Changing an anomaly's status, tags, assignees, or description, and archiving or deleting it, requires the **Author** team permission. See [Anomaly Permissions](https://userguide.qualytics.io/anomalies/deep-dive/permissions/) for the full matrix.

## Deep Dive

Understand what an anomaly is, how a Scan creates it, and what each part of an anomaly tells you.

- **Getting Started**

  A first triage: find an anomaly, read it, assign it, and set its status.

  [Getting Started](https://userguide.qualytics.io/anomalies/deep-dive/getting-started/)
- **Introduction**

  What an anomaly is, why it matters, and a short tour of every topic in this Deep Dive.

  [Introduction](https://userguide.qualytics.io/anomalies/deep-dive/introduction/)
- **How It Works**

  How a Scan creates anomalies, AI Managed and Authored checks, the lifecycle, duplicates, and notifications.

  [How It Works](https://userguide.qualytics.io/anomalies/deep-dive/concepts/how-it-works/)
- **Record Anomalies**

  Anomalies that flag one row: when they are created, how rows are grouped, and examples.

  [Record Anomalies](https://userguide.qualytics.io/anomalies/deep-dive/concepts/record-anomalies/)
- **Shape Anomalies**

  Anomalies about many rows or the whole dataset: what creates them, what they count, and examples.

  [Shape Anomalies](https://userguide.qualytics.io/anomalies/deep-dive/concepts/shape-anomalies/)
- **AI Managed and Authored**

  How anomalies from AI Managed and Authored checks differ, the AI badge, and how triage tunes AI Managed checks.

  [AI Managed and Authored](https://userguide.qualytics.io/anomalies/deep-dive/concepts/ai-managed-and-authored/)
- **Impact**

  How the Low to Critical impact level is decided from the failed checks, and when it updates.

  [Impact](https://userguide.qualytics.io/anomalies/deep-dive/triage/impact/)
- **Status**

  The lifecycle of an anomaly, from Active and Acknowledged to the archived statuses.

  [Status](https://userguide.qualytics.io/anomalies/deep-dive/triage/status/)
- **Assignees**

  How the Assignees field works, who can be assigned, and when assignees are notified.

  [Assignees](https://userguide.qualytics.io/anomalies/deep-dive/triage/assignees/)
- **Fingerprints**

  How Qualytics recognizes a newly detected anomaly as a duplicate of one it already found.

  [Fingerprints](https://userguide.qualytics.io/anomalies/deep-dive/triage/fingerprints/)
- **Anomaly Views**

  The four screens that show anomalies: how to reach each one, what it shows, and what you can do there.

  [Anomaly Views](https://userguide.qualytics.io/anomalies/deep-dive/anomaly-details/anomaly-views/)
- **Description**

  The business-friendly explanation of the data quality issue behind an anomaly.

  [Description](https://userguide.qualytics.io/anomalies/deep-dive/anomaly-details/description/)
- **Source Records**

  The rows behind an anomaly, how to read them, and how masked values are protected.

  [Source Records](https://userguide.qualytics.io/anomalies/deep-dive/anomaly-details/source-record/)
- **Tickets**

  Linked Jira and ServiceNow tickets: sync modes, what reaches the ticket, and status sync.

  [Tickets](https://userguide.qualytics.io/anomalies/deep-dive/anomaly-details/tickets/)
- **Timeline**

  The record of every change to an anomaly, and how comments and mentions work.

  [Timeline](https://userguide.qualytics.io/anomalies/deep-dive/anomaly-details/timeline/)
- **Examples**

  Real scenarios that follow an anomaly from the Scan that finds it to the decision that closes it.

  [Examples](https://userguide.qualytics.io/anomalies/deep-dive/examples/)
- **Best Practices**

  Guidelines for keeping the anomaly list short, trusted, and acted on.

  [Best Practices](https://userguide.qualytics.io/anomalies/deep-dive/best-practices/)
- **Permissions**

  The team permission and user role behind every anomaly action.

  [Permissions](https://userguide.qualytics.io/anomalies/deep-dive/permissions/)

## How-tos

Triage and manage anomalies step by step.

- **Acknowledge Anomalies**

  Mark an anomaly as reviewed while it stays in the open list.

  [Acknowledge Anomalies](https://userguide.qualytics.io/anomalies/how-tos/managing/acknowledge-anomalies/)
- **Archive Anomalies**

  Close an anomaly as Resolved, Duplicate, Invalid, or Discarded.

  [Archive Anomalies](https://userguide.qualytics.io/anomalies/how-tos/managing/archive-anomalies/)
- **Restore Anomalies**

  Bring an archived anomaly back to the open list as Acknowledged.

  [Restore Anomalies](https://userguide.qualytics.io/anomalies/how-tos/managing/restore-anomalies/)
- **Delete Anomalies**

  Permanently remove archived anomalies that are no longer needed.

  [Delete Anomalies](https://userguide.qualytics.io/anomalies/how-tos/managing/delete-anomalies/)
- **Edit Anomaly Description**

  Rewrite the explanation shown in an anomaly's Description section.

  [Edit Anomaly Description](https://userguide.qualytics.io/anomalies/how-tos/managing/edit-description/)
- **Add Tags**

  Apply tags to an anomaly to categorize it.

  [Add Tags](https://userguide.qualytics.io/anomalies/how-tos/tags/add-tags/)
- **Remove Tags**

  Take tags off an anomaly.

  [Remove Tags](https://userguide.qualytics.io/anomalies/how-tos/tags/remove-tags/)
- **Bulk-Edit Tags**

  Add or replace the tags on many anomalies at once.

  [Bulk-Edit Tags](https://userguide.qualytics.io/anomalies/how-tos/tags/bulk-edit/)
- **Add Anomaly Assignees**

  Make one or more users responsible for an anomaly.

  [Add Anomaly Assignees](https://userguide.qualytics.io/anomalies/how-tos/assignee/add-assignee/)
- **Remove Anomaly Assignees**

  Take users off an anomaly's Assignees list.

  [Remove Anomaly Assignees](https://userguide.qualytics.io/anomalies/how-tos/assignee/remove-assignee/)
- **Bulk-Assign Anomalies**

  Assign users to many anomalies at once.

  [Bulk-Assign Anomalies](https://userguide.qualytics.io/anomalies/how-tos/assignee/bulk-assign/)
- **Add a Comment to an Anomaly**

  Leave a comment on an anomaly's Timeline and mention teammates.

  [Add a Comment to an Anomaly](https://userguide.qualytics.io/anomalies/how-tos/comments/add-a-comment/)
- **Comment on an Anomaly Change**

  Attach a comment to one Timeline entry, such as a status change.

  [Comment on an Anomaly Change](https://userguide.qualytics.io/anomalies/how-tos/comments/comment-on-a-change/)
- **Reply to an Anomaly Comment**

  Answer a comment in its thread.

  [Reply to an Anomaly Comment](https://userguide.qualytics.io/anomalies/how-tos/comments/reply-to-a-comment/)
- **Edit an Anomaly Comment**

  Change the text of a comment you wrote.

  [Edit an Anomaly Comment](https://userguide.qualytics.io/anomalies/how-tos/comments/edit-a-comment/)
- **Delete an Anomaly Comment**

  Remove a comment from an anomaly's Timeline.

  [Delete an Anomaly Comment](https://userguide.qualytics.io/anomalies/how-tos/comments/delete-a-comment/)
- **Change a Ticket's Sync Mode**

  Choose whether Qualytics writes back to a linked ticket.

  [Change Sync Mode](https://userguide.qualytics.io/anomalies/how-tos/ticket/change-ticket-sync-mode/)
- **Create a Jira Ticket**

  Open a new Jira issue from an anomaly, already linked to it.

  [Create a Jira Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/jira/create-ticket/)
- **Link an Existing Jira Ticket**

  Connect an anomaly to a Jira issue that already exists.

  [Link an Existing Jira Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/jira/link-existing-ticket/)
- **Unlink a Jira Ticket**

  Remove the link between an anomaly and a Jira issue.

  [Unlink a Jira Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/jira/unlink-ticket/)
- **Create a ServiceNow Ticket**

  Open a new ServiceNow incident from an anomaly, already linked to it.

  [Create a ServiceNow Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/servicenow/create-ticket/)
- **Link an Existing ServiceNow Ticket**

  Connect an anomaly to a ServiceNow incident that already exists.

  [Link an Existing ServiceNow Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/servicenow/link-existing-ticket/)
- **Unlink a ServiceNow Ticket**

  Remove the link between an anomaly and a ServiceNow incident.

  [Unlink a ServiceNow Ticket](https://userguide.qualytics.io/anomalies/how-tos/ticket/servicenow/unlink-ticket/)
- **Refresh Anomaly Source Records**

  Load the latest copy of an anomaly's source records.

  [Refresh Anomaly Source Records](https://userguide.qualytics.io/anomalies/how-tos/source-records/refresh-source-records/)
- **Download Anomaly Source Records**

  Export an anomaly's source records as a CSV file.

  [Download Anomaly Source Records](https://userguide.qualytics.io/anomalies/how-tos/source-records/download-source-records/)
- **Reveal Masked Values in Source Records**

  Show the real values of masked fields, with an audit trail.

  [Reveal Masked Values in Source Records](https://userguide.qualytics.io/anomalies/how-tos/source-records/reveal-masked-values/)
- **View the Masking Audit Log**

  See who revealed masked values, when, and which fields.

  [View the Masking Audit Log](https://userguide.qualytics.io/anomalies/how-tos/source-records/view-masking-audit-log/)
- **Filter and Sort Anomalies**

  Search an anomaly list, filter it, and change its sort order.

  [Filter and Sort Anomalies](https://userguide.qualytics.io/anomalies/how-tos/filter-and-sort/)

## Reference

- **API**

  Read, update, archive, and delete anomalies, and work with their comments, source records, and tickets programmatically.

  [API](https://userguide.qualytics.io/anomalies/api/)
- **FAQ**

  Common questions about types, Impact, status, duplicates, tags, tickets, and assignees.

  [FAQ](https://userguide.qualytics.io/anomalies/faq/)

*Last updated: November 3, 2026.*
