Telemetry Agent

NVIDIA NEO REST API Guide v2.7.20

Description

Configures the server data where the data will be collected from all the Mellanox operating systems.

Create Collector Data

Request URL

POST /neo/app/telemetry/collector_data/

Request Data

{

"address": < Collector_Data - IPV4 - Adress > ,

"port": < Collector_Data - Port - Number >

}

Response

The HTTP response location header will contain an ID created for the new collector.

Status Codes

Note: For status code 400 see error details in the body


Get Collector Data

Request URL

GET /neo/app/telemetry/collector_data/<id>

Response

{ 

"port": 50051,

"address": "10.209.36.123"

}


Get Available Collectors

Description

Get available collectors for Telemetry.

Request URL

GET / neo/app/telemetry/available_collectors

Request Data

{

"allowed_collectors":[ <Collectors types>],

"max_collectors": <Max collectors to add>

}


Get Supported Profile Sessions per Collector

Description

Get supported profile sessions per collector.

Request URL

GET / neo/app/telemetry/supported_collectors

Request Data

{ <Collector name>: <Supported profile IDs}

Description

Configures telemetry sessions on a switch and starts the sessions for data transfer.

Create Session

Description

Creates a telemetry session.

Request URL

POST /neo/app/telemetry/session/

Request Data

{

"collector-data-id":0

}

Response

The HTTP response location header will contain an ID created for the new collector

Status Codes

Note: For status code 400 see error details in the body

Description

Gets a telemetry session.

Request URL

GET /neo/app/telemetry/session/<session-id>

Response

{

"telemetry-protocol": "gRPC",

"telemetry-profile-id": "0",

"telemetry-sample-interval": 5,

"telemetry-collector-id": 0

}


Start Session

Description

Starts a telemetry session.

Request URL

POST neo/app/telemetry/session/<session>/start

Request

{

"object_ids": "system_ips"],

"object_type": "System"

}

Response

{

"location": "/neo/app/jobs/job_id",

"objectID": "job_id"

}


Stop Session

Description

Stops a telemetry session.

Request URL

POST /neo/app/telemetry/session/<session-id>/stop

Request

{

"object_ids": "system_ips"],

"object_type": "System"

}

Response

{

"location": "/neo/app/jobs/job_id",

"objectID": "job_id"

}

Status Codes

Note: For status code 400 see error details in the body


Get Session Members

Description

Retrieves session members.

Request URL

GET /neo/app/telemetry/session/<session-id>/members

Response

[

{

"errorMessages": [

{

"severity": "Warning",

"message": "Agent communication error"

}

],

"ip": "10.209.37.182",

"status": "Warning",

"lastSample": "2020-07-23 16:04:45",

"requiresRecirculation": true,

"recirculationPort": "Eth1/1"

}

]


Edit Collectors to an Existing Telemetry Session

Description

Edit collectors to an existing telemetry session.

Request URL

POST /neo/app/telemetry/session/<sessions_id>/collectors


Upgrade Telemetry Agent

Description

Get supported profile sessions per collector

Request URL

POST /neo/actions/telemetry_agent/upgrade

Request

{

"object_ids:" "system_ips"],

"object_type": "System"

}

Response

{ "location": "/neo/app/jobs/job_id", "objectID": "job_id" }

Status Codes

Note: For status code 400 see error details in the body


© Copyright 2023, NVIDIA. Last updated on Nov 16, 2023.