Skip to main content

Overview

Every connected agent gets a health score from 0 to 100, recalculated hourly by a pg_cron job. The score is a weighted composite of five components.

Score breakdown

ComponentWeightWhat it measuresHow it scores
Uptime30 ptsLast health check recency30 if < 24h and healthy, 15 if < 7d, 0 otherwise
Success rate25 ptsTool call success/error ratio (24h)Proportional to success percentage
Block rate20 ptsPercentage of blocked tool calls (24h)Lower block rate = higher score
Response time15 ptsAverage tool call duration (24h)15 if < 500ms, 10 if < 2s, 5 if < 5s, 0 otherwise
Config10 ptsHas active traces5 if agent has any traces in 24h

Grades

GradeScore range
A90–100
B75–89
C60–74
D40–59
F0–39

Trend tracking

Score snapshots are recorded hourly to the agent_score_history table. The dashboard shows score trends over 7 and 30 days.
Health Score — Last 30 Days
100 ┤
 90 ┤    ╭──╮          ╭───────────
 80 ┤───╯  ╰──────╮   ╯
 70 ┤              ╰──╯
 60 ┤
    └──────────────────────────────
    Mar 1                    Mar 27

Additional stats

The agent score view also surfaces:
StatDescription
tool_call_count_24hTotal tool calls in the last 24 hours.
tool_call_count_7dTotal tool calls in the last 7 days.
top_toolsTop 5 most-used tools (24h).
avg_duration_msAverage tool call duration (24h).
blocked_count_24hNumber of blocked calls (24h).

Score history retention

Score history is kept for 90 days, then automatically cleaned up.