All Products
Search
Document Center

Cloud Monitor:Troubleshoot an abnormal stop of the CloudMonitor agent

Last Updated:Jun 04, 2026

When the CloudMonitor agent on a host enters the Stopped state, CloudMonitor stops monitoring that host. Identify the cause and restart the agent.

Issue

The CloudMonitor agent sends a heartbeat to the CloudMonitor server every 3 minutes. If no heartbeat is received for 15 minutes, the agent is considered stopped. Possible causes:

If the agent still does not send heartbeats, try the following solutions.

Reinstall or upgrade the CloudMonitor agent

If the agent ran normally before it stopped, reinstall and restart it. If you use the Go or Java agent, upgrade to the latest CloudMonitor agent for C++:

Note

The CloudMonitor agents for Go and Java are no longer maintained.

View CloudMonitor agent status and logs

Important

You can only manage the Cloud Monitor agent by using an administrator account (the root user for Linux or the Administrator user for Windows). However, using an administrator account may introduce certain risks, such as system stability or data security issues. Proceed with caution.

Check the agent status and logs to determine the cause of the stop. If the agent process exited due to a bug, submit a ticket and wait for Alibaba Cloud engineers to contact you before troubleshooting.

  • View agent logs

    • Windows

      1. Log on to the host as an administrator.

      2. Go to the C:\Program Files\Alibaba\cloudmonitor\local_data\logs directory.

      3. Open argusagent.log or argusagentd.log.

        • argusagentd.log: daemon process logs, including monitoring process startup and shutdown events.

        • argusagent.log: operational logs of the CloudMonitor agent.

    • Linux

      1. Log on to the host as the root user.

      2. Run the following commands to view agent logs:

        cd /usr/local/cloudmonitor/local_data/logs

        cat argusagent.log

        cat argusagentd.log

        • argusagentd.log: daemon process logs, including monitoring process startup and shutdown events.

        • argusagent.log: operational logs of the CloudMonitor agent.

  • View agent status

    • Windows

      1. Log on to the host as an administrator.

      2. Open the Services window.

        Press Win+R. In the Run dialog box, enter services.msc and click OK.

      3. Check the status of the argusagent service.

    • Linux

      1. Log on to the host as the root user.

      2. Run the following command to check agent status:

        ps aux | grep argusagent | grep -v grep

References