Get complete timeline for a specific alert (level 3) | NVIDIA Fleet Intelligence Documentation

{
  "alertUuid": "550e8400-e29b-41d4-a716-446655440000",
  "nodeUuid": "node-uuid-456",
  "alertStatus": "Critical",
  "component": "GPU",
  "componentDisplayName": "GPU",
  "computeZone": "Compute Zone Name",
  "customerID": "customer-123",
  "hasMore": true,
  "isBackendComponent": true,
  "nodeGroup": "Node Group Name 1",
  "page": 0,
  "pageSize": 50,
  "timeline": [
    {
      "alertStatus": "Critical",
      "error": "Temperature critically high",
      "eventTimestamp": "2024-12-01T10:00:00Z",
      "eventType": "detected",
      "extraInfo": {},
      "incidents": [
        null
      ],
      "message": "GPU critical temperature alert",
      "suggestedActions": [
        {
          "action": "Restart the application",
          "code": "RESTART_APP",
          "persona": "tenant",
          "type": "immediate"
        }
      ]
    }
  ],
  "total": 120
}

Get complete timeline for a specific alert. Returns alert UUID, component, current alertStatus, nodeGroup, computeZone, and complete event timeline. This is the third level of the progressive disclosure API for alert timelines. Events default to newest-first (most recent update first); pass order=asc for chronological (oldest-first) order. Pagination of the timeline events is optional and backward compatible: omit pageSize to receive the full timeline (default); supply pageSize to page through the events, in which case the response also carries page/pageSize/total/hasMore metadata.

Path parameters

nodeUUIDstringRequired

Node UUID

alertUUIDstringRequired

Alert UUID

Query parameters

orderenumOptionalDefaults to desc

Sort direction on event time: ‘desc’ (default, most recent update first) or ‘asc’ (chronological, oldest first)

Allowed values:

pageintegerOptionalDefaults to 0

Page number (0-indexed). Only applied when pageSize is supplied, but always validated: an invalid value returns 400 either way

pageSizeintegerOptional

Timeline events per page. Omit for the full, unpaginated timeline (default behavior)

Response

Complete timeline for the alert

alertUuidstring

nodeUuidstring

alertStatusstringOptional

Current alert status: severity if active, state if resolved/detected

componentstringOptional

componentDisplayNamestringOptional

computeZonestringOptional

Compute zone display name from node inventory

customerIDstringOptional

hasMorebooleanOptional

isBackendComponentbooleanOptional

nodeGroupstringOptional

Node group display name from node inventory

pageintegerOptional

Pagination metadata for the timeline events. These fields are populated only when the caller opts into pagination by supplying the pageSize query parameter; they are omitted entirely otherwise, so existing clients that expect the full, unpaginated timeline are unaffected. When present, Timeline holds only the requested page (order controlled by query param) and Total is the count of all timeline events for the alert.

pageSizeintegerOptional

timelinelist of objectsOptional

Sorted by eventTimestamp (default DESC = newest-first; query param order=asc reverses)

totalintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

499

Client Closed Request Error

500

Internal Server Error