Back to Docs
Guide

Analytics Guide

Understand how your agents use SkillRouter. Monitor executions, track costs, and set up alerts to stay in control.

1

Dashboard Metrics

Your analytics dashboard provides a real-time overview of all skill activity. Here are the key metrics you will see:

API Calls

12,847

Total requests including discovery and execution calls over the selected time range.

Executions

8,312

Successful skill executions that completed and returned a result to your agent.

Success Rate

99.2%

Percentage of executions that completed without errors. Includes retries handled by SkillRouter.

Avg Latency

142ms

Median end-to-end latency from request received to response sent, including skill execution time.

You can filter all metrics by date range, skill category, specific skill ID, or agent. The dashboard updates in real time and supports time ranges from the last hour up to the last 90 days.

2

Viewing Execution Analytics

Navigate to the Analytics tab in your dashboard to view execution data. You can also query analytics programmatically via the API:

from skillrouter import SkillRouter

sr = SkillRouter(api_key="sk_live_...")

# Get execution analytics for the last 7 days
analytics = sr.analytics.get(
    period="7d",
    group_by="skill_id"
)

for entry in analytics.data:
    print(f"{entry.skill_name}: {entry.executions} executions, "
          f"{entry.success_rate}% success, "
          f"{entry.avg_latency_ms}ms avg latency")
3

Usage Tracking & Billing

SkillRouter tracks usage at the execution level. Each successful skill execution counts toward your monthly quota. Here is what counts and what does not:

Does NOT count
  • Discovery / search queries
  • Failed executions (4xx / 5xx errors)
  • Analytics API calls
  • Authentication requests
Counts toward quota
  • Successful skill executions
  • Retried executions that succeed
  • Broadcast skill calls (per target)
  • Custom skill executions

You can view your current billing cycle usage on the Settings → Billing page. Usage resets on the first of each month at midnight UTC. Overages are billed at your plan's per-execution rate.

4

Setting Up Alerts & Limits

Configure alerts to get notified when usage approaches your limits or when error rates spike. You can set alerts from the dashboard or via the API:

# Set up a usage alert at 80% of your monthly quota
sr.alerts.create(
    type="usage_threshold",
    threshold=0.8,
    channels=["email", "webhook"],
    webhook_url="https://your-app.com/webhooks/skillrouter"
)

# Set up an error rate alert
sr.alerts.create(
    type="error_rate",
    threshold=0.05,  # Alert if error rate exceeds 5%
    window="15m",     # Over a 15-minute rolling window
    channels=["email"]
)

# Set a hard spending limit
sr.limits.set(
    type="monthly_executions",
    limit=50000,
    action="block"  # or "warn"
)

Alert channels

SkillRouter supports email, Slack, Discord, and webhook alert channels. Configure your preferred channels in Settings → Notifications. Webhook payloads include the alert type, current value, threshold, and a link to the relevant dashboard view.

Back to Documentation