Install a monitoring probe
Register a probe from the web and run the one-step command with its token on a machine on your network.
On this page
Register the probe in ARGUNIS and then install it on a machine on your network with the command and the token the screen gives you.
Before you start
You need the administrator role.
Your plan must have monitoring probe quota. If it is full, the Register probe button is disabled and the screen tells you why.
A machine on your network with Docker on Ubuntu 22.04/24.04 or Debian 12, amd64 or arm64, 2 vCPU, 2 GB of RAM and 15 GB free. It must reach the hosts you are going to monitor.
SSH access to that machine.
Step 1: register the probe
Go to Settings → Monitoring → Monitoring probes.
Click Register probe. Register monitoring probe opens.
Enter the Name, for example probe-head-office. It accepts 2 to 40 letters, numbers, spaces, periods, hyphens and underscores.
If more than one ARGUNIS server is available, choose the Server it will connect to.
Optional: if you are reinstalling the probe on a machine that already had one, choose its inactive server in Continues the server: the new probe continues its history. With None (new server) a new one is created. The field appears only if there are inactive servers.
Click Register and generate key.
A window opens with the installation instructions.
Copy the token right then: it is shown only once, expires in 24 hours and works for a single probe. If you lose it, generate another one with Re-enroll.
Step 2: install on the machine
Connect over SSH to the probe machine.
In Step 1 · on the probe machine (over SSH), paste the command, copy the Installation command (single step) with Copy and paste it on the machine.
In Step 2 · paste the token when the installer asks for it, copy the Installation token (single use) and paste it when the installer asks for it. Nothing shows on screen when you paste it: this is normal. Press Enter.
The token already tells it which ARGUNIS server to connect to: the installer asks nothing else.
If you prefer Portainer or docker compose, the token also works as a stack variable. The screen explains this in Install a probe.
What the installer does
It installs Docker and Portainer if they are missing, downloads and verifies the probe's signed image, and creates the argunis-sonda-monitoreo stack in Portainer. From Portainer you can see the probe and its logs.
What happens next
When it finishes, the probe appears as connected in the Monitoring probes list.
Its server appears in Infrastructure with the Monitoring probe tag.
You can now choose it in Check from when you Add a host, in Discover hosts on your network and in monitoring tests.
Statuses in the list
Status | What it means |
|---|---|
pending · waiting for installation | Registered, not installed yet. |
active · connected | Installed and online. |
active · offline | Installed, but not reporting. Check the machine. |
revoked | It can no longer connect. |
The list also shows the version and architecture, its own server, and how many instructions it has and how many are failing.