Collect device health data and set the sample interval

You can enable or disable the collection of device health data to upload to Digi Remote Manager, and configure the interval between health sample uploads. By default, device health data upload is enabled, and the health sample interval is set to 60 minutes. Each time a device connects to Digi Remote Manager after the device boots (or re-boots), the device immediately uploads all health metrics.

To avoid a situation where several devices are uploading health metrics information to Remote Manager at the same time, the EX15 device includes a preconfigured randomization of two minutes for uploading metrics. For example, if Health sample interval is set to five minutes, the metrics will be uploaded to Remote Manager at a random time between five and seven minutes.

To disable the collection of device health data or enable it if it has been disabled, or to change the health sample interval:

 Web

Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
Access the device configuration:
Remote Manager:
1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
2. Click the Device ID.
3. Click Settings.
4. Click to expand Config.
Local Web UI:
1. On the menu, click System. Under Configuration, click Device Configuration.
  The Configuration window is displayed.
Click Monitoring > Device Health.
(Optional) Click to expand Data point tuning.
Data point tuning options allow to you configure what data are uploaded to the Digi Remote Manager. All options are enabled by default.
Only report changed values to Digi Remote Manager is enabled by default.
When enabled:
- The device only reports device health metrics that have changed health metrics were last uploaded. This is useful to reduce the bandwidth used to report health metrics.
- All metrics are uploaded once every hour.
When disabled, all metrics are uploaded every Health sample interval.
Device health data upload is enabled by default. To disable, toggle off Enable Device Health samples upload.
For Health sample interval, select the interval between health sample uploads.
Click Apply to save the configuration and apply the change.

 Command line

Select the device in Remote Manager and click Actions > Open Console, or log into the EX15 local command line as a user with full Admin access rights.
Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.
At the command line, type config to enter configuration mode:
```
> config
(config)>
```

Device health data upload is enabled by default. To enable or disable:

To enable:

(config)> monitoring devicehealth enable true
(config)>

To disable:

(config)> monitoring devicehealth enable false
(config)>

The interval between health sample uploads is set to 60 minutes by default. To change:
```
(config)> monitoring devicehealth interval value
(config)> 
```
where value is one of 1, 5, 15, 30, or 60, and represents the number of minutes between uploads of health sample data.
By default, the device will only report health metrics values to Digi Remote Manager that have changed health metrics were last uploaded. This is useful to reduce the bandwidth used to report health metrics. This is useful to reduce the bandwidth used to report health metrics. Even if enabled, all metrics are uploaded once every hour.
To disable:
```
(config)> monitoring devicehealth only_send_deltas false
(config)> 
```
When disabled, all metrics are uploaded every Health sample interval.

(Optional) Tuning parameters allow to you configure what data are uploaded to the Digi Remote Manager. By default, all tuning parameters are enabled.

To view a list of all available tuning parameters, use the show command:

(config)> show monitoring devicehealth tuning
all
	cellular
		rx
			bytes
				enable true
		tx
			bytes
				enable true
	eth
		rx
			bytes
				enable true
		tx
			bytes
				enable true
	serial
		rx
			bytes
				enable true
		tx
			bytes
				enable true
cellular
	1
		rx
			bytes
				enable true
			packets
				enable true
...
						(config)>

To disable a tuning parameter, set its value to false. For example, to turn off all reporting for the serial port:

(config)> monitoring devicehealth tuning all serial rx bytes enabled false
(config)> monitoring devicehealth tuning all serial tx bytes enabled false
(config)>

Save the configuration and apply the change.
```
(config)> save
Configuration saved.
>
```
Type exit to exit the Admin CLI.
Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.