Enroll an agent manually
Adding an agent to NXLog Platform and enrolling it is an easy, straightforward process. Follow the steps below to install, configure, and enroll an agent.
Download and install NXLog Agent
Navigate to Agents from the left navigation menu. The wizard under the search bar will walk you through the steps to download, install, and configure the agent.
-
Download the agent installer for your operating system from the link provided.
-
Click Install Agent to proceed to the next step.
-
Install the agent by following the installation instructions for your operating system.
-
When the installation is complete, click Configure Agent to proceed.
-
Copy the configuration provided to the
managed.conf
file on your agent, replacing any existing configuration. -
Click Restart Agent to proceed.
-
Follow the instructions for your operating system to restart the NXLog Agent service. The agent will connect to NXLog Platform at this stage.
-
Follow the instructions to enroll your agent. This step is detailed in the Enroll an agent section below.
-
Click Send Logs.
-
Continue through the wizard and click Go to Templates on the last step to view your existing NXLog Agent configuration templates.
Enroll an agent
Navigate to the Agents page. You should see your agent listed in the agents table with a New deployment state. Click the Actions menu for your agent and choose Enroll.
Once the agent is enrolled, the Status will change to Online, and the Deployment state will change to Configured.
The Deployment state of the NXLog Agent will only change to Configured if you have applied a configuration to it. If you have not applied a configuration to your agent yet, the Deployment state will be Enrolled. You can apply a configuration anytime for a connected agent. |
That’s it; you can now monitor and configure your agent from NXLog Platform.
Unenroll an agent
If, for some reason, you need to remove the agent, you must unenroll it from NXLog Platform. Unenrolling an agent does not delete or uninstall the agent, but NXLog Platform will stop monitoring it.
To unenroll an agent:
-
Navigate to the Agents page.
-
Find the agent in the table and click the Actions menu.
-
Choose Unenroll.
You should only unenroll agents that you no longer wish to monitor. If you manually uninstall or stop the NXLog Agent and unenroll it, it will be removed from the Agents table. However, if you reinstall or start the agent again, it will reconnect to NXLog Platform as a new agent. |