Fleet Intelligence — ReferenceAPI Explorerevents

Get event counts bucketed by time

View as Markdown

Returns time-bucketed event counts for histogram display. The server picks a clean bucket interval based on the maxBuckets hint.

Query parameters

startTimestringOptional

Start time in RFC3339 format (required for absolute mode, e.g., 2024-01-01T01:00:00Z). Cannot be more than 1 year in the past.

endTimestringOptional

End time in RFC3339 format (required for absolute mode, e.g., 2024-01-01T01:00:00Z)

timeModeenumOptional
Time mode for range selection. Defaults to absolute.
Allowed values:
windowstringOptional

Relative duration window (required for relative mode). Valid units: h, m, s (e.g. 24h, 1h30m, 90m). ‘d’ is not supported; use hours instead (e.g. 168h for 7 days)

nodeUUIDstringOptional

Filter by node UUID (optional)

componentstringOptional

Filter by component (optional)

maxBucketsintegerOptionalDefaults to 100

Maximum number of buckets (default: 100, max: 1000)

Response

Time-bucketed event counts

bucketIntervalstringOptional
bucketslist of objectsOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
499
Client Closed Request Error
500
Internal Server Error
503
Service Unavailable Error