scout alerts

Query alert history from the Scout platform. Results include alert name, state, previous state, timestamp, dashboard UID, and tags.

Usage

scout alerts [flags]

Flags

Flag	Type	Default	Description
--limit	integer	20	Maximum number of results (1–100)
--since	duration	—	Time window (e.g., 2h, 1d). Max: 7 days. Conflicts with --start
--start	RFC 3339	—	Start time. Conflicts with --since
--end	RFC 3339	—	End time. Requires --start
--tag	string	—	Filter by tag. Repeatable for multiple tags
--dashboard	string	—	Filter by dashboard UID
--raw	bool	false	Output JSON

Examples

Query the 20 most recent alerts:

scout alerts

Query alerts from the last 2 hours:

scout alerts --since 2h

Query alerts in a specific time range:

scout alerts --start 2026-03-26T14:00:00Z --end 2026-03-26T16:00:00Z

Filter by tag:

scout alerts --tag critical --tag payment

Filter by dashboard and output JSON:

scout alerts --dashboard abc123 --raw

Get more results:

scout alerts --since 1d --limit 100

Time Ranges

Use --since for relative time windows or --start/--end for absolute ranges. These two approaches are mutually exclusive.

Flag	Format	Example
--since	Duration string	30m, 2h, 1d
--start	RFC 3339	2026-03-26T14:00:00Z
--end	RFC 3339	2026-03-26T16:00:00Z

warning

The maximum time range is 7 days. Queries exceeding this limit will return an error.

See Also

• logs — query service logs
• traces — query distributed traces
• metrics — query service metrics