Get events | NVIDIA Fleet Intelligence Documentation

{
  "events": [
    {
      "eventId": "550e8400-e29b-41d4-a716-446655440000",
      "nodeUUID": "node-123",
      "bmcHostname": "bmc-a.example.com",
      "component": "gpu",
      "computeZone": "compute-zone-1",
      "computeZoneId": "550e8400-e29b-41d4-a716-446655440002",
      "createdAt": "2024-01-15T14:30:00Z",
      "dataSource": "inband",
      "gpuType": "NVIDIA-H100-80GB-HBM3",
      "hostname": "node-001",
      "message": "GPU error occurred",
      "name": "gpu_error",
      "nodeGroup": "node-group-1",
      "nodeGroupId": "550e8400-e29b-41d4-a716-446655440001",
      "nodeName": "node-001",
      "suggestedActions": [
        {
          "action": "Restart the application",
          "code": "RESTART_APP",
          "persona": "tenant",
          "type": "immediate"
        }
      ],
      "timestamp": "2024-01-15T14:30:00Z",
      "type": "Warning"
    }
  ],
  "hasMore": true,
  "page": 0,
  "pageSize": 50,
  "total": 100
}

Get events with optional inventory, table, and time-range filters. Each row includes the node’s resolved GPU type, independent of the event data source. Events associated with soft-deleted nodes are excluded.

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

sortByenumOptionalDefaults to timestamp

Sortable column

sortOrderenumOptionalDefaults to desc

Sort direction

Allowed values:

pageintegerOptionalDefaults to 0

Page number (0-indexed)

pageSizeintegerOptionalDefaults to 50

Page size

Response

Array of events with pagination info

eventslist of objectsOptional

hasMorebooleanOptional

pageintegerOptional

pageSizeintegerOptional

totalintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

499

Client Closed Request Error

500

Internal Server Error

503

Service Unavailable Error