Skip to main content
Report badges let you embed AnomalyArmor data quality status directly into your dashboards, wikis, and operational tools. See pass/fail status at a glance without leaving your workflow. Report badge showing data quality status

​
Why Use Report Badges

Data teams context-switch constantly. Opening a separate monitoring tool to check data quality breaks flow: Workflow comparison showing time savings with badges Badges provide “always-on” visibility into data quality wherever you work.

​
Where Badges Work

Any tool that supports image embeds can display badges:

​
Badge Status

Badges show one of three states:

​
Creating a Badge

1

Navigate to Report Badges

Go to Report Badges from the main navigation.
2

Click Create Badge

Click the Create Badge button.
3

Select Asset

Choose the asset (database or schema) you want to monitor:
  • production.analytics
  • production.core
  • production.reporting
Select a schema to monitor all tables within it. This keeps the badge focused on a logical group of related tables.
4

Configure Tag Filters (Optional)

Narrow the scope using tags:Tag Filters:
  • critical
  • customer-facing
  • revenue
When specified, only tables with matching tags are included in the badge status.
5

Select Quality Checks

Choose what the badge monitors:Enable all three for full quality monitoring.
6

Include Upstream (Optional)

Toggle Include Upstream to also check the quality of upstream dependencies.
Including upstream expands the scope significantly. Only enable if you want the badge to reflect the entire data lineage, not just the selected asset.
7

Save Badge

Click Create to generate the badge.

​
Copying the Badge URL

After creating a badge:
  1. Find the badge in the Report Badges list
  2. Click Copy URL next to the badge
  3. The URL is copied to your clipboard
Badge URLs follow this format:
Badge URLs are public and require no authentication. Anyone with the URL can view the badge status. URLs use randomly generated IDs that are not guessable.

​
Embedding Examples

​
Databricks Notebook

Add a markdown cell:

​
Notion Page

  1. Type /embed
  2. Paste the badge URL
  3. The badge renders inline

​
GitHub README

​
Slack

Simply paste the badge URL. Slack will render the SVG inline.

​
Managing Badges

​
Viewing All Badges

Navigate to Report Badges to see all badges:
  • Badge status (live preview)
  • Scope (asset and tag filters)
  • Enabled checks (schema drift, freshness)
  • Copy URL action

​
Editing a Badge

  1. Click the badge row in the list
  2. Modify configuration
  3. Click Save
The badge URL remains unchanged. Embedded badges automatically reflect the updated configuration.

​
Deleting a Badge

  1. Click the delete icon on the badge row
  2. Confirm deletion
Deleting a badge immediately invalidates the URL. Embedded badges will show “Unknown” status.

​
Disabling vs Deleting

If you want to temporarily hide a badge:
  1. Edit the badge
  2. Toggle Active off
  3. Save
Disabled badges show “Unknown” status but retain their URL for later reactivation.

​
Caching Behavior

Badges cache their status for performance: This means:
  • Badge status updates within 5 minutes of quality changes
  • High traffic won’t overload AnomalyArmor
  • Multiple embeds of the same badge share cached results

​
Best Practices

​
1. One Badge Per Logical Domain

Create badges for logical groupings: Good:
  • Analytics Schema Badge
  • Core Tables Badge
  • Customer-Facing Badge
Avoid:
  • All Tables Badge (too broad)
  • Single Table Badge (too narrow)

​
2. Use Tags for Precision

Combine asset selection with tags:
  • Asset: production.analytics
  • Tags: ["critical", "customer-facing"]
  • Result: Only critical, customer-facing tables in analytics

​
3. Place Badges Strategically

Embed badges where decisions are made: When embedding, make badges clickable:
This lets viewers click through to investigate issues.

​
Troubleshooting

Causes:
  • Badge was deleted
  • Badge was disabled
  • Invalid badge URL
Solutions:
  1. Verify the badge exists in Report Badges
  2. Check the badge is marked Active
  3. Ensure URL is correct and complete
Causes:
  • Browser caching old image
  • Within 5-minute cache window
Solutions:
  1. Hard refresh the page (Cmd+Shift+R / Ctrl+Shift+R)
  2. Wait 5 minutes for cache to expire
  3. Add cache-busting parameter: badge-url?t=timestamp
Causes:
  • Schema drift detected on monitored tables
  • Freshness SLA violated
  • Metric anomaly detected (row count, null percentage, etc.)
  • Upstream tables have issues (if enabled)
Solutions:
  1. Click badge or navigate to AnomalyArmor
  2. Review asset details for specific issues
  3. Resolve underlying quality problems
Causes:
  • Tool doesn’t support SVG images
  • Tool blocks external image URLs
  • Firewall blocking AnomalyArmor domain
Solutions:
  1. Check tool’s image/embed documentation
  2. Try alternative embed method (HTML vs Markdown)
  3. Verify network access to app.anomalyarmor.ai

​
Security Considerations

  • Public URLs: Badge URLs are accessible without authentication
  • Non-guessable IDs: URLs use random UUIDs that cannot be enumerated
  • Read-only: Badges only display status; they cannot modify data
  • No sensitive data: Badges show pass/fail only, not table contents
If you need to revoke access to a badge, delete it. A new badge for the same scope will have a different URL.

​
Common Questions

​
Where can I embed an AnomalyArmor badge?

Any tool that accepts an image URL. That includes Databricks notebooks, Looker, Tableau, Notion, Confluence, Slack, and GitHub READMEs. Paste the badge URL like you would any SVG or Markdown image.

​
Are badge URLs public?

Yes. Badge URLs require no authentication so they render anywhere. They use randomly generated, non-guessable IDs and only show pass/fail status, never table contents or row data. Delete and recreate a badge to rotate the URL.

​
How fast does badge status update when something breaks?

Within 5 minutes. Badges cache for performance so high-traffic embeds don’t overload AnomalyArmor. If you need an immediate refresh, add a cache-busting query parameter or wait out the cache window.

​
Why is my badge showing ‘Unknown’?

Either the badge was deleted, disabled, or the URL is malformed. Check Report Badges, confirm the badge is marked Active, and verify the embedded URL matches exactly.

​
Can one badge cover multiple tables?

Yes. Scope a badge to a schema and it will reflect the status of every table inside. Use tag filters (for example, critical or customer-facing) to narrow it further without creating one badge per table.

Freshness Monitoring

Set SLAs on data freshness

Data Quality Metrics

Track row counts, null percentages, and detect anomalies

Schema Monitoring

Detect structural changes

Alert Rules

Get notified of quality issues