Configure, update, or remove an agent
Turn an agent's plugins on or off, update it to a new version, generate a new key, or remove it.
On this page
From an agent's page you decide what it collects, keep it up to date, and decommission it.
Before you begin
You need the administrator role.
Go to Settings → Monitoring → Agents and click View on the agent's row.
Configure the plugins
On the agent's page, click Configure plugins.
Turn each section on or off. Depending on the operating system, you'll see:
General: the Heartbeat (seconds), the System metrics (CPU, RAM, disks), Report connections, and Application folders (agent 3.9.0; see Check your application dependencies).
Docker: container crashes, restart loops, and errors; reading errors from their logs, excluded containers, and log rules.
System: journald, with its minimum priority and the units to follow.
Files: paths of log files from which error lines are read.
Security: brute force (warning attempts, critical attempts, and window in minutes), file integrity and watched folders, suspicious processes, new listening ports, and new systemd units.
Windows: services to watch or ignore, a notification if an automatic-start service is stopped, and a notification for new services.
Event Log: the channels that go to the SIEM and the maximum number of events per minute.
Local checks: SNMP and HTTP/TCP from this agent, and UX tests with a local browser.
Privacy (and on Linux, remote reading): extra redaction patterns and the folders ARGUNIS can read on request.
Click Save and send.
Changes reach the agent within seconds if it's connected; if not, it receives them when it reconnects.
Allow own scripts
In the Own scripts section of the page, select Allow own scripts so the server receives the custom plugins approved and signed by your company (Settings → Monitoring → Plugins). The agent verifies the signature, stores them separately, and runs them without privileges and with a time limit. The change is recorded in the audit log.
Update the agent
One agent: on its page, click Update, choose the Version, and click Update. In the list you can also use the update icon on the row.
All outdated agents: in the list, click Update all to the new version.
The agent verifies the signature of the new version and rolls back on its own if it fails.
Generate a new key
Click New key on the page (or the key icon in the list) and confirm with Generate key. The installation window opens with the new key.
If the agent is active, generating a new key revokes its current identity and you'll have to reinstall it on the server. If it hadn't been installed yet, the previous unused keys stop working.
Remove the agent
Click Remove on the page (or the trash icon in the list).
Confirm with Remove.
The agent is deleted along with its server and its metrics, and the installed agent stops. Afterward, uninstall it from the server.