Customize Device Health Statuses

Topic

This article explains how to customize the health statuses that identify what actions occur on devices.

Environment

NinjaOne Endpoint Management

Description

NinjaOne gives you the ability to customize the health statuses for a number of device events. Customizing health statuses affects how devices with these events appear on your dashboards.

Select a category to learn more about each topic:

• Health Status Options
• Customize Health Statuses
• Default Statuses
• Additional Resources

Health Status Options

The Device health summary widget on the system and organization dashboard shows the number of devices affected by a certain health indicator when you move your cursor over the color bar.

Figure 1: System dashboard device health summary (click to enlarge)

In NinjaOne, there are four options for health status indicators. The health status indicator has different meanings depending on whether it's reporting on a mobile device (MDM) or all other devices (laptops, virtual machines, or servers).

By default, the definition for each indicator is as follows:

Color	Definition for MDM Devices	Definition for all Other Devices
Red	Device data: Offline or has not reported back to MDM after 3 days. Apps and Books certificate: At least one asset with zero licenses is available for use. The Apps and Books content token is expiring in 7 days or less. The Apps and Books content token has expired. ABM Automated Device Enrollment (ADE) profile: The ADE token is about to expire or has expired. If expired, devices will fail to sync from ABM/ASM, and devices will be unable to enroll through ADE.	Offline or Unhealthy
Yellow	Device data: Needs Attention. Apps and Books certificate: There are assets with less than 10% of total licenses available for use. The Apps and Books content token is expiring in 30 days or less. ABM ADE profile: The ADE token will expire in less than 90 days. Once expired, devices will fail to sync from ABM/ASM, and devices will be unable to enroll through ADE.	Needs Attention
Gray	Device data: Erased.	Unknown
Green	Device data: Managed. Apps and Books certificate: All assets have more than 10% of total licenses available for use. ABM ADE profile: The ADE token is in good standing and has more than 90 days until it expires.	Healthy

Customize Health Statuses

System administrators and technicians with System → Device Administration access permission can change the health status displayed for each health alert.

You can adjust your devices' vulnerability CVSS severity level to indicate if the device health should be impacted.

1. Navigate to Administration → Devices → Health Status.
2. Move your cursor over the event whose status you would like to customize, and then click Edit.

Figure 2: Edit a device health status in NinjaOne (click to enlarge)

3. Choose the new status from the drop-down menu and then click Save.
   NinjaOne will list any event with a non-default health status as Overridden.

Figure 3: Example of an overridden health status in NinjaOne (click to enlarge)

Default Statuses

The default health statuses for the customizable events are as follows.

To return all statuses to their default setting, click Restore Defaults in the Device Health configuration page.

Figure 4: Revert overridden health statuses in NinjaOne (click to enlarge)

Additional Resources

For a list of frequently asked questions about health statuses, refer to Health Statuses: FAQ.

System/Organization Dashboard V2 Navigation