--- name: "devlink-health" section: "8" platform: "linux" package: "iproute2" version: "7.3.0-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/devlink-health" --- # devlink-health(8) devlink health reporting and recovery ## NAME devlink-health - devlink health reporting and recovery ## SYNOPSIS **devlink** \[ *OPTIONS* \] **health** { *COMMAND* \| **help** } *OPTIONS* := { **-V**\[*ersion*\] } **devlink health show** \[ { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* \] **devlink health recover** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* **devlink health diagnose** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* **devlink health dump show** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* **devlink health test** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* **devlink health dump clear** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* **devlink health set** { *DEV* \| *DEV/PORT\_INDEX* } **reporter***REPORTER* \[ **grace\_period** *MSEC* \] \[ **burst\_period** *MSEC* \] \[ **auto\_recover** { **true** \| **false** } \] \[ **auto\_dump** { **true** \| **false** } \] **devlink health help** ## DESCRIPTION ### devlink health show - Show status and configuration on all supported reporters. Displays info about reporters registered on devlink devices and ports. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. ### devlink health recover - Initiate a recovery operation on a reporter. This action performs a recovery and increases the recoveries counter on success. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. ### devlink health diagnose - Retrieve diagnostics data on a reporter. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. ### devlink health test - Trigger a test event on a reporter. *DEV* - specifies the devlink device. *REPORTER* - specifies the reporter's name registered on the devlink device. ### devlink health dump show - Display the last saved dump. devlink health saves a single dump per reporter. If an dump is not already stored by the Devlink, this command will generate a new dump. The dump can be generated either automatically when a reporter reports on an error or manually at the user's request. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. ### devlink health dump clear - Delete the saved dump. Deleting the saved dump enables a generation of a new dump on the next "devlink health dump show" command. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. ### devlink health set - Configure health reporter. Please note that some params are not supported on a reporter which doesn't support a recovery or dump method. *DEV* - specifies the devlink device.\ *DEV/PORT\_INDEX* - specifies the devlink port. *REPORTER* - specifies the reporter's name registered on specified devlink device or port. - **grace\_period** *MSEC* Time interval between consecutive auto recoveries. - **burst\_period** *MSEC* Time window for error recoveries before starting the grace period. Configuring burst\_period is invalid when the grace period is disabled. - **auto\_recover** { **true** \| **false** } Indicates whether the devlink should execute automatic recover on error. - **auto\_dump** { **true** \| **false** } Indicates whether the devlink should execute automatic dump on error. ## EXAMPLES devlink health show List status and configuration of available reporters on devices and ports. devlink health show pci/0000:00:09.0/1 reporter tx List status and configuration of tx reporter registered on port on pci/0000:00:09.0/1 devlink health recover pci/0000:00:09.0 reporter fw\_fatal Initiate recovery on fw\_fatal reporter registered on device on pci/0000:00:09.0. devlink health recover pci/0000:00:09.0/1 reporter tx Initiate recovery on tx reporter registered on port on pci/0000:00:09.0/1. devlink health diagnose pci/0000:00:09.0 reporter fw List diagnostics data on the specified device and reporter. devlink health dump show pci/0000:00:09.0/1 reporter tx Display the last saved dump on the specified port and reporter. devlink health dump clear pci/0000:00:09.0/1 reporter tx Delete saved dump on the specified port and reporter. devlink health set pci/0000:00:09.0 reporter fw\_fatal grace\_period 3500 Set time interval between auto recoveries to minimum of 3500 msec on the specified device and reporter. devlink health set pci/0000:00:09.0/1 reporter tx grace\_period 3500 Set time interval between auto recoveries to minimum of 3500 msec on the specified port and reporter. devlink health set pci/0000:00:09.0 reporter fw\_fatal auto\_recover false Turn off auto recovery on the specified device and reporter. devlink health set pci/0000:00:09.0 reporter tx burst\_period 5000 Set the burst period to 5000 milliseconds on the specified device and reporter, prior to initiating the grace period. devlink health set pci/0000:00:09.0 reporter tx grace\_period 0 Disable grace period on the specified device and reporter. Disabling the grace period also deactivates the burst period. ## SEE ALSO [**devlink**(8)](/devlink/8.md), [**devlink-dev**(8)](/devlink-dev/8.md), [**devlink-port**(8)](/devlink-port/8.md), **devlink-param**(8), [**devlink-region**(8)](/devlink-region/8.md),\ ## AUTHOR Aya Levin \