Skip to navigation
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. GPU type filtering uses the node’s resolved GPU type independently of event data source.

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)

nodeGroupIdslist of stringsOptional
Filter by node group IDs
computeZoneIdslist of stringsOptional
Filter by compute zone IDs
excludeNodeGroupIdslist of stringsOptional
Exclude node group IDs
excludeComputeZoneIdslist of stringsOptional
Exclude compute zone IDs
nameSearchstringOptional

Case-insensitive substring matched against the in-band hostname, OOB machine name, BMC hostname, and node UUID

eventNameslist of stringsOptional
Exact event names
severitieslist of stringsOptional
Exact severity values
componentslist of stringsOptional

Exact component values; cannot be combined with component

dataSourceslist of enumsOptional
Event data sources
Allowed values:
gpuTypeslist of stringsOptional
Resolved node GPU types
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