data_quality_scorecard
Read-only
Scores OT tag data 0-100 for trustworthiness, flagging staleness, dead heartbeats, bad quality, flatlines, gaps, and anomalies. Rolls up per endpoint and fleet to reveal unreliable feeds.
Instructions
[READ][risk=low] Fleet data-TRUST scorecard across endpoints' tag feeds.
Scores each tag 0-100 on whether its data can be BELIEVED — staleness, dead
heartbeat, bad-quality, flatline, gaps, anomaly — then rolls up per endpoint
and across the fleet. NOT process health (it does not score whether a value is
alarming, only whether it is trustworthy). Pure analysis over provided feeds.
Args:
feeds: Per-endpoint feeds — {endpoint, tags:[{ref, label?, samples:[scalars
or {value, good|quality, timestamp?}], expected_update_s?, heartbeat?}]}.
default_staleness_s: Max sample-age before 'stale' when a tag sets no
expected_update_s (default 300).
now: ISO-8601 reference time for staleness (deterministic); omit for now-UTC.
Returns dict: {evaluated_endpoints, evaluated_tags, fleet_score (0-100),
fleet_status, issue_breakdown{}, worst_endpoints[], worst_tags[],
endpoints:[{endpoint, score, status, status_counts, worst_tag}]}.
Example: data_quality_scorecard(feeds=[{"endpoint":"line1","tags":[{"ref":"hb",
"heartbeat":true,"samples":[5,5,5,5]}]}]).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| now | No | ||
| feeds | Yes | ||
| default_staleness_s | No |