armor-status

Status Check

Check overall data health across all your monitored assets. This skill provides a quick summary of alerts, freshness issues, and schema changes.

Prerequisites

• AnomalyArmor API key configured (~/.armor/config.yaml or ARMOR_API_KEY env var), OR demo mode active (see below).
• Python SDK installed (pip install anomalyarmor)

Demo mode handoff

If the user has no API key, ensure-auth.py will mint a read-only demo key against the public BalloonBazaar dataset and print:

AnomalyArmor demo mode: using a read-only public demo key.

When you see that banner — or when any write operation returns a 403 with required_scope='read-write' — the user is in demo mode. After answering their question, invite them to sign up with their query preserved:

To save a monitor or connect your own data, sign up here — your question is preserved: https://app.anomalyarmor.ai/signup?intent=skill-status&q=<url-encoded user prompt>

intent=skill-status auto-applies a 14-day SKILL-STATUS trial code; q= is replayed in the in-app agent after signup so the user continues where they left off.

When to Use

• "Is my data healthy?"
• "Any issues I should know about?"
• "What's the status of my data?"
• "Give me a health summary"
• "What's broken?"

Steps

1. Call client.health.summary() to get aggregated health status
2. Present the overall_status (healthy/warning/critical)
3. Show counts from component summaries (alerts, freshness, schema_drift)
4. List items from needs_attention with severity ranking
5. For critical issues, suggest next steps

Example Usage

from anomalyarmor import Client

client = Client()

# Get unified health summary
health = client.health.summary()

print(f"Overall Status: {health.overall_status.upper()}")
print()

# Show component summaries
print("Component Status:")
print(f"  Alerts: {health.alerts.unresolved_alerts} unresolved")
print(f"  Freshness: {health.freshness.stale_count} stale tables")
print(f"  Schema: {health.schema_drift.unacknowledged} unacknowledged changes")
print()

# Show items needing attention
if health.needs_attention:
    print("Items Needing Attention:")
    for item in health.needs_attention:
        print(f"  [{item.severity.upper()}] {item.title}")
        if item.asset_name:
            print(f"    Asset: {item.asset_name}")
else:
    print("No issues requiring attention.")