What can I help you with?

NVIDIA NVOS User Manual for NVLink Switches v25.02.2141

NVIDIA Docs Hub NVIDIA Networking Networking Software Switch Software NVIDIA NVOS User Manual for NVLink Switches v25.02.2141 Statistics Commands

On This Page

nv show system stats
nv show system stats category
nv show system stats files
nv set/unset system stats state
nv set/unset system stats category state
nv set/unset system stats category interval
nv set/unset system stats category history-duration
nv action clear system stats category
nv action clear system stats category
nv action generate system stats category
nv action generate system stats
nv action clear system stats
nv action delete system stats files
nv action upload system stats files

Statistics Commands

nv show system stats

	nv show system stats Display configuration for system statistics collection reports.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show system stats operational applied ---------- ----------- -------------- state enabled enabled [category] cpu [category] disk [category] fan [category] mgmt-interface [category] temperature`
REST API	GET https://<ip>/nvue_v1/system/stats
Related Commands	nv set/unset system stats state
Notes

nv show system stats category

	nv show system stats category [<category-id>] Get statistic categories.
Syntax Description	category-id	Display configuration for specified category.
Default	N/A
History	25.02.1884
Example	Copy Copied! admin@nvos:~$ nv show system stats category History Duration (days) Interval (minutes) State -------------- ----------------------- ------------------ ------- cpu 365 5 enabled disk 365 30 enabled fan 365 5 enabled mgmt-interface 365 5 enabled temperature 365 5 enabled Copy Copied! `admin@nvos:~$ nv show system stats category fan operational applied ---------------- ----------- ------- history-duration 365 365 interval 5 5 state enabled enabled`
REST API	GET https://<ip>/nvue_v1/system/stats/category GET https://<ip>/nvue_v1/system/stats/category/< category-id >
Related Commands	nv set/unset system stats category
Notes

nv show system stats files

	nv show system stats files [<file-name>] Display statistic report files.
Syntax Description	file-name	Display content of specified CSV file.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show system stats files Statistic report file File path ---------------------------------------- ---------------------------------------------------- stats_fan_gorilla-62_20230704_112407.csv /host/stats/stats_fan_gorilla-62_20230704_112407.csv` Copy Copied! `admin@nvos:~$ nv show system stats files stats_fan_gorilla-62_20230704_112407.csv`
REST API	GET https://<ip>/nvue_v1/system/stats/files GET https://<ip>/nvue_v1/system/stats/files/< file-name >
Related Commands	nv action generate system stats category
Notes	Autocomplete returns also generated tar file (in case if it was generated before), but it can't be displayed, only *.csv files can be displayed

nv set/unset system stats state

	nv set/unset system stats state [{ enabled \| disabled }] Set/unset state.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set system stats state disabled` Copy Copied! `admin@nvos:~$ nv unset system stats state`
REST API	PATCH https://<ip>/nvue_v1/system/stats
Related Commands	nv show system stats
Notes

nv set/unset system stats category state

	nv set/unset system stats category <category-id> state [{ enabled \| disabled }] Set/unset category state.
Syntax Description	category-id	Change state for specified category.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set system stats category fan state disabled` Copy Copied! `admin@nvos:~$ nv unset system stats category fan state`
REST API	PATCH https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv show system stats category
Notes

nv set/unset system stats category interval

	nv set/unset system stats category <category-id> interval Set interval in minutes.
Syntax Description	category-id	Change sampling interval for specified category.
Default	5 (30 for disk category)
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set system stats category fan interval 60` Copy Copied! `admin@nvos:~$ nv unset system stats category fan interval`
REST API	PATCH https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv show system stats category
Notes	Sampling interval is in minutes.

nv set/unset system stats category history-duration

	nv set/unset system stats category <category-id> history-duration[{ 1–365 }] Sampling history duration in days.
Syntax Description	category-id	Change history-duration for specified category.
	history-duration	1–365 days
Default	365
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set system stats category fan history-duration 31` Copy Copied! `admin@nvos:~$ nv unset system stats category fan history-duration`
REST API	PATCH https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv show system stats category
Notes	History duration is in days.

nv action clear system stats category

	nv action clear system stats category <category-id> Clear statistic category sampled data.
Syntax Description	category-id	Category to be cleared.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action clear system stats category fan`
REST API	POST https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv action generate system stats category
Notes

nv action clear system stats category

	nv action clear system stats category <category-id> Clear statistic category sampled data.
Syntax Description	category-id	Category to be cleared.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action clear system stats category fan`
REST API	POST https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv action generate system stats category
Notes

nv action generate system stats category

	nv action generate system stats category <category-id> Generate statistic report file.
Syntax Description	category-id	Category to be generated CSV file for.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action clear system stats category fan`
REST API	POST https://<ip>/nvue_v1/system/stats/category/<category-id>
Related Commands	nv show system stats files
Notes

nv action generate system stats

	nv action generate system stats Generate tar file with reports from all categories.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action generate system stats`
REST API	POST https://<ip>/nvue_v1/system/stats
Related Commands	nv show system stats files
Notes

nv action clear system stats

	nv action clear system stats Clear statistic sampled data for all categories.
Syntax Description	N/A
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action clear system stats`
REST API	POST https://<ip>/nvue_v1/system/stat
Related Commands	nv action generate system stats
Notes

nv action delete system stats files

	nv action delete system stats files <file-name> Delete available stats report file.
Syntax Description	file-name	Report file to be deleted.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action delete system stats files stats_fan_gorilla-62_20230704_112407.csv`
REST API	POST https://<ip>/nvue_v1/system/stats/files/<file-name>
Related Commands	nv action generate system stats category nv show system stats files
Notes

nv action upload system stats files

	nv action upload system stats files <file-name> <remote-url-upload> Upload available stats report files to remote location.
Syntax Description	file-name	Report file name to be uploaded.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action upload system stats files stats_fan_gorilla-62_20230704_112407.csv scp://user@host/path/to/folder`
REST API	POST https://<ip>/nvue_v1/system/stats/files/<file-name>
Related Commands	nv show system stats files
Notes

© Copyright 2025, NVIDIA. Last updated on Apr 23, 2025.