Agent Health
This feature is Early Access only and may not be available in your environment. For more information, please contact your Customer Success Manager.
To access the Agent Health page, go to Agents > Agent Management. On the Agent Management page, in the Health column, click on a health indicator: Good, Poor, or Moderate, for the required Agent Endpoint.
The Agent Health page, has two sections:
- Summary: Displays the number of good, moderate, and poor agent capability and platform issues that have been identified for the selected device. The overall status is determined by the lowest status regardless of the number of issues, for example, if the device had 3 good, 3 moderate, and 1 poor issue, the overall health status would be poor.
- Data point insight tiles: Displays each data point that has been used to determine the overall health status. Each data point has a status and provides an indicator for that status which can help with troubleshooting and remediation. Click on the
icon to view remediation steps in the Help.
Data Point Insights
The data point insights provide more information on the health state of the agent endpoint. The table below provides details on the insights and remediation steps for moderate and poor states.
Check-in
| State |
Health Indicator |
Description |
Remedy |
| Good |
Agent is checking-in. |
The agent has checked-in successfully within the last 7 days. |
N/A |
| Moderate |
Information has not been reported. |
Information on whether the agent has successfully checked-in within the last 7 days has not been reported yet. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Moderate |
Agent check-in is overdue. |
The agent has not checked-in for over 7 days. The last check-in date {lastCheckInTime} is displayed. |
Perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Poor |
The agent has never checked-in. |
The agent has never successfully checked-in. |
Reinstall the agent. |
Policy
| State |
Health Indicatator |
Description |
Remedy |
| Good |
The agent has the expected policy {runningPolicyName} at version {runningPolicyVersion}. |
The agent is running the correct version of a specific policy. |
N/A |
| Moderate |
Information has not been reported. |
Information relating to the policy version being used by the Ivanti Neurons Agent has not been reported yet. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Moderate |
The agent has policy {expectedPolicyName} assigned, but this is not yet running on the endpoint. |
The agent installed on the endpoint does not yet have the latest policy downloaded. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Moderate |
The agent has version {runningPolicyVersion} of policy {runningPolicyName}, but version {expectedPolicyVersion} is available. |
The agent installed on the endpoint has an older version of the policy downloaded than is available. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
|
Moderate
|
The agent has policy {runningPolicyName} but is supposed to have policy {expectedPolicyName}.
|
The agent installed on the endpoint has the incorrect policy downloaded.
|
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint.
|
Agent Version
| State |
Health Indicator |
Description |
Remedy |
| Good |
The expected agent version {runningAgentVersion} is installed.
|
The agent currently installed and running on the endpoint is the expected agent version.
|
N/A |
|
Good
|
Agent version {runningAgentVersion} is installed.
|
The agent is currently installed and running on the endpoint.
|
N/A
|
| Good |
Agent version {runningAgentVersion} is installed. The minimum expected version is {expectedAgentVersion}.
|
The agent currently installed and running on the endpoint is version {agent version}. The minimum agent version expected is {expected agent version}. |
N/A |
| Moderate |
Information has not been reported.
|
Information regarding the installed and running agent on the endpoint has not been reported yet. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual check-in by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Moderate |
Agent version {runningAgentVersion} is installed, but version {expectedAgentVersion} is available.
|
The agent currently installed and running on the endpoint is version {agent version}. However, the agent version expected is {expected agent version}. |
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint. |
| Poor |
Agent version {runningAgentVersion} is installed. This version cannot automatically upgrade itself. Redeploy the agent to the endpoint.
|
The current version of the agent installed on the endpoint is old and is not able to auto-update itself. |
Manually download and install the latest version of the agent on the endpoint from the Neurons tenant. Alternatively, utilize the push install capabilities from within your Ivanti Neurons tenant to deploy the latest agent to the target endpoint. |
Package Version
| State |
Health Indicator |
Description |
Remedy |
|
Good
|
All installed packages are at their expected version.
|
All packages installed on the agent are at the latest version.
|
N/A
|
|
Moderate
|
Information has not been reported.
|
Information regarding the installed package versions on the endpoint has not been reported yet.
|
Wait for the Agent on the endpoint to automatically check-in or perform a manual agent check-in, and update binaries, by running STUILauncher.exe from within the %ProgramFiles%\Ivanti\Ivanti Cloud Agent folder on the endpoint.
|
| Moderate |
Version {runningPackageVersion} of {packageKey} is installed, but version {expectedPackageVersion} is available.
|
A running package version is out of date and a newer one is expected. |
It will automatically update. If update fails contact Ivanti Support. |
| Moderate |
{packageKey} is installed, but it is not listed in the manifest of components. |
An installed engine is missing its expected version number. |
It will automatically update. If update fails contact Ivanti Support. |