# phpman > man > devlink-health(8)

[DEVLINK-HEALTH(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-HEALTH/8/markdown)                               Linux                              [DEVLINK-HEALTH(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-HEALTH/8/markdown)



## 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_ ] [
               **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.


       **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.


## SEE ALSO
       [**devlink**(8)](https://www.chedong.com/phpMan.php/man/devlink/8/markdown), [**devlink-dev**(8)](https://www.chedong.com/phpMan.php/man/devlink-dev/8/markdown), [**devlink-port**(8)](https://www.chedong.com/phpMan.php/man/devlink-port/8/markdown), [**devlink-param**(8)](https://www.chedong.com/phpMan.php/man/devlink-param/8/markdown), [**devlink-region**(8)](https://www.chedong.com/phpMan.php/man/devlink-region/8/markdown),


## AUTHOR
       Aya Levin <<ayal@mellanox.com>>



iproute2                                     20 Feb 2019                           [DEVLINK-HEALTH(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-HEALTH/8/markdown)
