OneAgent health overview
- Latest Dynatrace
- Reference
- 2-min read
- Published Jul 03, 2026
Coming soon
Fleet Management shows the health state of all your deployed OneAgent code modules. Use it to discover:
- Outdated modules that require an update to continue full Dynatrace support
- Connectivity issues between modules and your Dynatrace cluster
- Incompatible modules that require corrective actions
- Processes that require a restart to continue monitoring
- Modules where auto-update is disabled
Health state conditions
The following conditions trigger a specific health state and result in a recommended action.
| Health state | Condition | Recommended action |
|---|---|---|
Critical | Installer version date older than 11 months | Update OneAgent to a newer version to maintain full Dynatrace support. |
Critical | Module heartbeat is 180 seconds overdue | Dynatrace hasn't received data from this module for 180 seconds. There might be communication problems, or your process might have exited unexpectedly. |
Critical | Host ID conflict | Multiple monitored hosts report that they're using the same host identifier. This unexpected situation might be the result of machine cloning. Please contact a Dynatrace product expert via live chat within your environment. |
Critical | Host quota exceeded | Monitoring is currently disabled. Please contact a Dynatrace product expert via live chat within your environment. |
Critical | Installer version marked as faulty by Dynatrace | Update OneAgent to a newer version. Processes might also need to be restarted. |
Critical | Module version marked as faulty by Dynatrace | Update OneAgent to a newer version. A process restart might also be required. |
Warning | Installer version is between 9 and 11 months old | Update to a newer OneAgent version to stay current. |
Warning | Minimum OneAgent version incompatible | Update OneAgent to a newer version. A process restart might also be required, even if you've already updated your module. |
Warning | Maximum OneAgent version incompatible | Only OneAgent versions that are equal to or lower than the Dynatrace cluster version can be connected. Download a compatible OneAgent version from this cluster. |
Info | Process restart needed | Your module version is outdated. Restart your process to update the module to a newer OneAgent version. |
Info | Auto-update suppressed | Enable auto-update to stay current. |
Disconnected | Agent has not reported for more than 5 minutes | Check that the host is running and reachable. |
Limitations
- Newly connected agents will only appear after 10-15 minutes
- Serverless OneAgent modules, such as AWS Lambda, are not shown.