> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/fleet-intel/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/fleet-intel/_mcp/server. # Get events GET /v1/events Get list of events with optional filtering by node UUID, component, and time range. Returns events from the events table for the specified time period. Reference: https://docs.nvidia.com/fleet-intel/fleet-intel/api-explorer/events/get-v-1-events ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: fleet-intelligence version: 1.0.0 paths: /v1/events: get: operationId: getV1Events summary: Get events description: >- Get list of events with optional filtering by node UUID, component, and time range. Returns events from the events table for the specified time period. tags: - events parameters: - name: startTime in: query description: >- 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. required: false schema: type: string - name: endTime in: query description: >- End time in RFC3339 format (required for absolute mode, e.g., 2024-01-01T01:00:00Z) required: false schema: type: string - name: timeMode in: query description: Time mode for range selection. Defaults to absolute. required: false schema: $ref: '#/components/schemas/V1EventsGetParametersTimeMode' - name: window in: query description: >- 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) required: false schema: type: string - name: nodeUUID in: query description: Filter by node UUID (optional) required: false schema: type: string - name: component in: query description: Filter by component (optional) required: false schema: type: string - name: page in: query description: 'Page number (default: 0)' required: false schema: type: integer default: 0 - name: pageSize in: query description: 'Page size (default: 50, max: 100)' required: false schema: type: integer default: 50 responses: '200': description: Array of events with pagination info content: application/json: schema: $ref: '#/components/schemas/models.EventsResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '403': description: Forbidden - UAM authorization denied content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '499': description: Client Closed Request - request was canceled by the client content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' '503': description: Service Unavailable content: application/json: schema: $ref: '#/components/schemas/models.ErrorResponse' components: schemas: V1EventsGetParametersTimeMode: type: string enum: - absolute - relative title: V1EventsGetParametersTimeMode models.ActionPersona: type: string enum: - tenant - dc_admin description: Target persona (stored in DB, stripped before API response) title: models.ActionPersona models.ActionType: type: string enum: - immediate - investigatory description: 'Action type: "immediate" or "investigatory"' title: models.ActionType models.SuggestedAction: type: object properties: action: type: string description: Resolution action from Guidance Classes sheet code: type: string description: Action code from NVIDIA XID catalog persona: $ref: '#/components/schemas/models.ActionPersona' type: $ref: '#/components/schemas/models.ActionType' title: models.SuggestedAction models.Event: type: object properties: component: type: string description: Component name createdAt: type: string eventId: type: string description: Unique event identifier message: type: string name: type: string description: Event name nodeUUID: type: string description: Node UUID suggestedActions: type: array items: $ref: '#/components/schemas/models.SuggestedAction' description: Suggested actions for resolving the event timestamp: type: string type: type: string description: Event type title: models.Event models.EventsResponse: type: object properties: events: type: array items: $ref: '#/components/schemas/models.Event' hasMore: type: boolean page: type: integer pageSize: type: integer total: type: integer title: models.EventsResponse models.KASRequestStatus: type: object properties: requestId: type: string description: Request ID for tracing statusCode: type: string description: Status code from KAS statusDescription: type: string description: Status description from KAS description: >- RequestStatus contains KAS-specific error details This is added to reflect the field in OpenAPI docs for UI reference and not populated by our code If KAS returns an error, the request will not be forwarded to the backend title: models.KASRequestStatus models.ErrorResponse: type: object properties: details: type: string description: Detailed error information error: type: string description: Error message or type requestStatus: $ref: '#/components/schemas/models.KASRequestStatus' description: >- Standard error response returned by all API endpoints. For KAS API errors, requestStatus fields are populated. title: models.ErrorResponse ``` ## Examples **Response** ```json { "events": [ { "component": "gpu", "createdAt": "2024-01-15T14:30:00Z", "eventId": "550e8400-e29b-41d4-a716-446655440000", "message": "GPU error occurred", "name": "gpu_error", "nodeUUID": "node-123", "suggestedActions": [ { "action": "Restart the application", "code": "RESTART_APP", "persona": "tenant", "type": "immediate" } ], "timestamp": "2024-01-15T14:30:00Z", "type": "error" } ], "hasMore": true, "page": 0, "pageSize": 50, "total": 100 } ``` **SDK Code** ```python import requests url = "https://api.example.com/v1/events" response = requests.get(url) print(response.json()) ``` ```javascript const url = 'https://api.example.com/v1/events'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.example.com/v1/events" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.example.com/v1/events") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.example.com/v1/events") .asString(); ``` ```php request('GET', 'https://api.example.com/v1/events'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.example.com/v1/events"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://api.example.com/v1/events")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```