HCA Peer Port Telemetry Commands

nv show system peer-port

	nv show system peer-port Display the settings of HCA peer-port configuration.
Syntax Description	N/A
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show system peer-port operational applied -------- ----------- -------- state disabled disabled interval 5 5`
REST API	GET https://<ip>/nvue_v1/system/peer-port
Related Commands	nv set system peer-port state {enabled\|disabled}
Notes

nv set/unset system peer-port state

	nv set system peer-port state {enabled \| disabled} nv unset system peer-port state Enable/disable HCA peer-port functionality on a switch. The unset form of the command sets peer-port functionality to default.
Syntax Description	enabled	Enable HCA peer-port functionality
	disabled	Disable HCA peer-port functionality
Default	Disabled
History	25.03.1003
Example	`admin@nvos:~$ nv set system peer-port state enabled admin@nvos:~$ nv config apply`
REST API	PATCH https://<ip>/nvue_v1/system/peer-port
Related Commands	nv show system peer-port
Notes

nv set/unset system peer-port interval

	nv set system peer-port interval {integer:1 - 3600} nv unset system peer-port interval Set the HCA peer-port telemetry polling interval in seconds
Syntax Description	interval	The HCA peer-port telemetry polling interval in seconds
Default	5
History	25.03.1003
Example	`admin@nvos:~$ nv set system peer-port interval 10 admin@nvos:~$ nv config apply`
REST API	PATCH https://<ip>/nvue_v1/system/peer-port
Related Commands	nv show system peer-port
Notes

nv show peer-port

	nv show peer-port Display information about all active peer ports in the system.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	admin@nvos:~$ nv show peer-port Peer Port Port GUID Node GUID HCA Node Description HCA Port Index Switch Port ---------- ------------------ ------------------ ------------------------- -------------- ----------- hca50p1 0xc470bd0300a99d88 0xc470bd0300a99d88 fit-nos-vrt-40-045 HCA-1 1 sw50p1 hca50p1pl1 0xc470bd0300a99d88 0xc470bd0300a99d88 fit-nos-vrt-40-045 HCA-1 1 sw50p1pl1 hca50p1pl2 0xc470bd0300a99d88 0xc470bd0300a99d88 fit-nos-vrt-40-045 HCA-1 2 sw50p1pl2 hca50p1pl3 0xc470bd0300a99d88 0xc470bd0300a99d88 fit-nos-vrt-40-045 HCA-1 3 sw50p1pl3 hca50p1pl4 0xc470bd0300a99d88 0xc470bd0300a99d88 fit-nos-vrt-40-045 HCA-1 4 sw50p1pl4
REST API	GET https://<ip>/nvue_v1/peer-port
Related Commands	nv show peer-port id nv show peer-port id counters nv show peer-port id link
Notes

nv show peer-port id

	nv show peer-port <peer-port-id> Display information about a single peer port in the system.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	admin@nvos:~$ nv show peer-port hca50p1 operational ----------------------------------- ------------------------ node-guid 0xc470bd0300a99d88 port-guid 0xc470bd0300a99d88 associated-switch-tray-number 0 associated-switch-asic-in-tray 1 associated-switch-port sw50p1 chassis-sn MT2443X00270 peer-port-name hca50p1 host-name fit-nos-vrt-40-045 hca-node-description fit-nos-vrt-40-045 HCA-1 hca-port-index 1 hca-ib-port 1 counters in-bytes 446.74 MB in-pkts 1626587 in-drops 0 in-errors 0 out-bytes 446.73 MB out-pkts 1626498 out-drops 1 out-errors 0 out-unicast-pkts 1626498 out-multicast-pkts 0 in-unicast-pkts 1626486 in-multicast-pkts 101 buffer-overrun-errors 0 out-wait 0 link carrier-down-count 510 error-recovery 0 port-rcv-remote-physical-errors 0 port-rcv-switch-relay-errors 0 port-rcv-constraint-errors 0 local-integrity-errors 0 ib [errors] icrc-errors [errors] symbol-errors [errors] tx-parity-errors [drops] qp1-drops
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}
Related Commands	nv show peer-port nv show peer-port id counters nv show peer-port id link
Notes

nv show peer-port id counters

	nv show peer-port <peer-port-id> counters Display counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	admin@nvos:~$ nv show peer-port hca50p1 counters operational ------------------------------- ----------- in-bytes 468630004 Bytes in-pkts 1627229 in-drops 0 in-errors 0 out-bytes 468616320 Bytes out-pkts 1627140 out-drops 1 out-errors 0 out-unicast-pkts 1627140 out-multicast-pkts 0 in-unicast-pkts 1627128 in-multicast-pkts 101 buffer-overrun-errors 0 out-wait 0 link carrier-down-count 510 error-recovery 0 port-rcv-remote-physical-errors 0 port-rcv-switch-relay-errors 0 port-rcv-constraint-errors 0 local-integrity-errors 0 Error Counters ================= Counter Receive Transmit ---------------- ------- -------- icrc-errors 0 n/a symbol-errors 0 n/a tx-parity-errors 0 0 Drop Counters ================ Counter Receive Transmit --------- ------- -------- qp1-drops 0 0 Fast Recovery Counters ========================= Trigger Consecutive Normal Windows Warning Events Error Events --------------- -------------------------- -------------- ------------
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/counters
Related Commands	nv show peer-port nv show peer-port id nv show peer-port id link
Notes

nv show peer-port id counters ib

	nv show peer-port <peer-port-id> counters ib Display IB counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 counters ib Drop Counters ================ Counter Receive Transmit --------- ------- -------- qp1-drops 0 0 Error Counters ================= Counter Receive Transmit ---------------- ------- -------- icrc-errors 0 n/a symbol-errors 0 n/a tx-parity-errors 0 0 Fast Recovery Counters ========================= No Data`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/counters/ib
Related Commands	nv show peer-port id counters
Notes

nv show peer-port id counters ib drops

	nv show peer-port <peer-port-id> counters ib drops Display IB drop counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 counters ib drops Counter Receive Transmit --------- ------- -------- qp1-drops 0 0`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/counters/ib/drops
Related Commands	nv show peer-port id counters nv show peer-port id counters ib
Notes

nv show peer-port id counters ib errors

	nv show peer-port <peer-port-id> counters ib errors Display IB errors counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 counters ib errors Counter Receive Transmit ---------------- ------- -------- icrc-errors 0 n/a symbol-errors 0 n/a tx-parity-errors 0 0`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/counters/ib/errors
Related Commands	nv show peer-port id counters nv show peer-port id counters ib
Notes

nv show peer-port id counters link

	nv show peer-port <peer-port-id> counters link Display link counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 counters link operational ------------------------------- ----------- carrier-down-count 0 error-recovery 0 port-rcv-remote-physical-errors 0 port-rcv-switch-relay-errors 0 port-rcv-constraint-errors 0 local-integrity-errors 0`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/counters/link
Related Commands	nv show peer-port id counters
Notes

nv show peer-port id link

	nv show peer-port <peer-port-id> link Display link PHY counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	admin@nvos:~$ nv show peer-port hca50p1 link operational ------------------------------- ----------------- physical-state LinkUp logical-state Active speed 800G width 4X phy health [lane] 0 [lane] 1 [lane] 2 [lane] 3 [lane] 4 [lane] 5 [lane] 6 [lane] 7 histogram [rs-fec-corrected-errors] 0 [rs-fec-corrected-errors] 1 [rs-fec-corrected-errors] 2 [rs-fec-corrected-errors] 3 [rs-fec-corrected-errors] 4 [rs-fec-corrected-errors] 5 [rs-fec-corrected-errors] 6 [rs-fec-corrected-errors] 7 [rs-fec-corrected-errors] 8 [rs-fec-corrected-errors] 9 [rs-fec-corrected-errors] 10 [rs-fec-corrected-errors] 11 [rs-fec-corrected-errors] 12 [rs-fec-corrected-errors] 13 [rs-fec-corrected-errors] 14 [rs-fec-corrected-errors] 15 time-since-last-clear-min 221.756 symbol-errors 0 symbol-ber 1.5e-254 raw-ber 1e-07 phy-received-bits 11309877886954920 effective-errors 0 effective-ber 1.5e-254 detail profile-fec-in-use Int_KP4_FEC phy-manager-state Active_or_Linkup sync-header-error-counter 0 plr-rcv-codes 0 plr-rcv-codes-err 0 plr-rcv-uncorrectable-code 0 plr-xmit-codes 0 plr-xmit-retry-codes 0 plr-xmit-retry-events 0 plr-sync-events 0 plr-codes-loss 0 plr-bw-loss-percent 0.0 rq-general-error 0
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/link
Related Commands	nv show peer-port nv show peer-port id
Notes

nv show peer-port id link phy

	nv show peer-port <peer-port-id> link phy Display PHY counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	admin@nvos:~$ nv show peer-port hca50p1 link phy operational ----------------------------- ----------------- health [lane] 0 [lane] 1 [lane] 2 [lane] 3 [lane] 4 [lane] 5 [lane] 6 [lane] 7 histogram [rs-fec-corrected-errors] 0 [rs-fec-corrected-errors] 1 [rs-fec-corrected-errors] 2 [rs-fec-corrected-errors] 3 [rs-fec-corrected-errors] 4 [rs-fec-corrected-errors] 5 [rs-fec-corrected-errors] 6 [rs-fec-corrected-errors] 7 [rs-fec-corrected-errors] 8 [rs-fec-corrected-errors] 9 [rs-fec-corrected-errors] 10 [rs-fec-corrected-errors] 11 [rs-fec-corrected-errors] 12 [rs-fec-corrected-errors] 13 [rs-fec-corrected-errors] 14 [rs-fec-corrected-errors] 15 time-since-last-clear-min 222.172 symbol-errors 0 symbol-ber 1.5e-254 raw-ber 1e-07 phy-received-bits 11331129161166360 effective-errors 0 effective-ber 1.5e-254 detail profile-fec-in-use Int_KP4_FEC phy-manager-state Active_or_Linkup sync-header-error-counter 0 plr-rcv-codes 0 plr-rcv-codes-err 0 plr-rcv-uncorrectable-code 0 plr-xmit-codes 0 plr-xmit-retry-codes 0 plr-xmit-retry-events 0 plr-sync-events 0 plr-codes-loss 0 plr-bw-loss-percent 0.0 rq-general-error 0
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/link/phy
Related Commands	nv show peer-port id link
Notes

nv show peer-port id link phy health

	nv show peer-port <peer-port-id> link phy health Display PHY health counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 link phy health operational ------------------------- ----------------- time-since-last-clear-min 222.588 symbol-errors 0 symbol-ber 1.5e-254 raw-ber 1e-07 phy-received-bits 11352381187907760 effective-errors 0 effective-ber 1.5e-254 Lane Stats ============= Lane raw-ber phy-raw-errors ---- ------- -------------- 0 0 0 1 0 0 2 0 0 3 0 0 4 None None 5 None None 6 None None 7 None None`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/link/phy/health
Related Commands	nv show peer-port id link nv show peer-port id link phy
Notes

nv show peer-port id link phy health histogram

	nv show peer-port <peer-port-id> link phy health histogram Display PHY health histogram counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 link phy health histogram rs-fec-corrected-errors ========================== Bin count --- ------------ 0 0 1 0 2 0 3 0 4 0 5 0 6 0 7 0 8 0 9 0 10 0 11 0 12 0 13 0 14 0 15 0`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/link/phy/health/histogram
Related Commands	nv show peer-port id link nv show peer-port id link phy nv show peer-port id link phy health
Notes

nv show peer-port id link phy detail

	nv show peer-port <peer-port-id> link phy detail Display PHY detail counters of a peer port.
Syntax Description	peer-port-id	The name of the peer HCA port (e.g., hcaA2p1, hcaA2p2)
Default	N/A
History	25.03.1003
Example	`admin@nvos:~$ nv show peer-port hca50p1 link phy detail operational -------------------------- ---------------- profile-fec-in-use Int_KP4_FEC phy-manager-state Active_or_Linkup sync-header-error-counter 0 plr-rcv-codes 0 plr-rcv-codes-err 0 plr-rcv-uncorrectable-code 0 plr-xmit-codes 0 plr-xmit-retry-codes 0 plr-xmit-retry-events 0 plr-sync-events 0 plr-codes-loss 0 plr-bw-loss-percent 0.0 rq-general-error 0`
REST API	GET https://<ip>/nvue_v1/peer-port/{peer-port-id}/link/phy/detail
Related Commands	nv show peer-port id link nv show peer-port id link phy
Notes

Last updated: September 02, 2026