FSO agent — Unable to enable AppLogs or APM Insight on an installed FSO agent

FSO agent — Unable to enable AppLogs or APM Insight on an installed FSO agent

Covers only an agent that is already onboarded and reporting. If the agent was never installed or is not listed at all, follow the FSO agent installation guide instead.

Symptom

The agent is listed and reporting CPU, memory and disk normally. Enabling AppLogs or APM Insight on that same agent shows an error at the top of the page and the module stays off.

Cause

Server monitoring is built into the agent installer, so it works as soon as the agent is onboarded. AppLogs and APM Insight are not — they load from the FSO agent package extracted on the Applications Manager server. Either module can also be blocked by the product build, the agent version, the Central server, or licensing. The steps below rule out each one in turn.

Fix

  1. Check the build under Support > About. Upgrade if it is lower.
    ModuleMinimum build
    Server monitoringv176300
    AppLogsv179400
    APM Insightv181100
  2. Check the agent version — it must be 22.0.00 or later. Upgrade the agent if it is older.
  3. Extract the FSO agent package on the Applications Manager server. Download ApplicationsManager_FSO_Agent.zip from Settings > FSO Agent > Deploy Agent, copy it into <Applications Manager Home>\working\resources\, and extract it there as admin or root.
    # Windows - PowerShell as Administrator
    cd "<Applications Manager Home>\working\resources"
    Expand-Archive -Path .\ApplicationsManager_FSO_Agent.zip -DestinationPath .

    # Linux
    cd <Applications Manager Home>/working/resources
    sudo unzip ApplicationsManager_FSO_Agent.zip
  4. Confirm the extraction is complete. The zip creates FSO\latest\ with three module folders. If applogs or apminsight is missing, only the server part landed — re-extract the full bundle.
    <Applications Manager Home>\working\resources\
    FSO\latest\
    apminsight\ <-- needed for APM Insight
    applogs\ <-- needed for AppLogs
    server\ <-- server monitoring only
  5. Check port 10099 is open from the agent host to the Applications Manager server, or the custom port set at install time.
  6. On a Central/Probe setup, work from the Probe server. Neither module can be enabled from the Central server.
  7. For AppLogs, confirm the add-on is licensed. AppLogs is a separate add-on. If it is not in the licence, APM Insight can still enable while AppLogs will not.
  8. Enable the module again from Settings > FSO Agent > View Agents and allow a few minutes for data.

If it still fails, collect

  • Server:  Applications Manager SIF, and a folder listing of <Applications Manager Home>\working\resources\
  • Windows host: C:\Program Files (x86)\ManageEngine\AppManagerWinAgent\monitoring\logs; APM Insight: C:\ProgramData\ManageEngine Applications Manager APM Auto Profiler\Logs
  • Linux host: /opt/applicationsmanager/monagent/logs; APM Insight: /opt/applicationsmanager/apminsight/logs and /opt/applicationsmanager/apminsight/agents
  • Screenshot of the full error and of the About page

References