Report Badges

Embed data quality status indicators in Databricks, Looker, Notion, and other tools

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.

Why Use Report Badges

Data teams context-switch constantly. Opening a separate monitoring tool to check data quality breaks flow:

Badges provide “always-on” visibility into data quality wherever you work.

Where Badges Work

Any tool that supports image embeds can display badges:

Platform	How to Embed
Databricks	Markdown cell: 
Looker	Custom visualization with HTML
Tableau	Web content or image object
Notion	Paste URL as embed
Confluence	Insert image by URL
Slack	Post badge URL directly
GitHub	Add to README

Badge Status

Badges show one of three states:

Badge	Meaning
	All monitored tables pass quality checks
	Tables have schema drift, freshness violations, or metric anomalies
	Badge disabled or configuration error

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:

   Check	What It Monitors
   Schema Drift	Column additions, removals, type changes
   Freshness	SLA violations on data recency
   Metrics	Anomalies in row counts, null percentages, etc.

   Enable all three for comprehensive 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:

https://app.anomalyarmor.ai/badges/{public-id}.svg

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:

# Data Quality Status

![Data Quality](https://app.anomalyarmor.ai/badges/abc123.svg)

The badge above shows real-time quality status for our analytics tables.

Notion Page

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

GitHub README

## Data Quality

[![Analytics Quality](https://app.anomalyarmor.ai/badges/abc123.svg)](https://app.anomalyarmor.ai)

Our analytics tables are monitored by AnomalyArmor.

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:

Scenario	Cache Duration
Default	5 minutes
Embedded images	Respects HTTP cache headers

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:

Location	Why
Dashboard header	Quality context before analysis
ETL documentation	Status of pipeline outputs
Data catalog	Trust indicator for consumers
Team wiki	Always-visible quality status

4. Link to Details

When embedding, make badges clickable:

[![Status](badge-url)](https://app.anomalyarmor.ai/assets/your-asset)

This lets viewers click through to investigate issues.

Troubleshooting

Badge shows Unknown

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

Badge not updating

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

Badge shows Issues unexpectedly

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

Badge not rendering in tool

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.

Related Topics

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