Instalar una sonda de monitoreo
Registra una sonda desde la web y ejecuta en una máquina de tu red el comando de un paso con su token.
En esta página
Registra la sonda en ARGUNIS y luego instálala en una máquina de tu red con el comando y el token que te entrega la pantalla.
Antes de empezar
Necesitas rol administrador.
Tu plan debe tener cupo de sondas de monitoreo. Si está lleno, el botón Registrar sonda queda deshabilitado y la pantalla te dice por qué.
Una máquina en tu red con Docker en Ubuntu 22.04/24.04 o Debian 12, amd64 o arm64, 2 vCPU, 2 GB de RAM y 15 GB libres. Debe alcanzar los equipos que vas a monitorear.
Acceso por SSH a esa máquina.
Paso 1: registrar la sonda
Entra a Configuración → Monitoreo → Sondas de monitoreo.
Presiona Registrar sonda. Se abre Registrar sonda de monitoreo.
Escribe el Nombre, por ejemplo sonda-oficina-central. Admite de 2 a 40 letras, números, espacios, puntos, guiones y guiones bajos.
Si hay más de un servidor de ARGUNIS disponible, elige el Servidor al que se conectará.
Opcional: si reinstalas la sonda en una máquina que ya tuvo una, elige su servidor inactivo en Continúa el servidor: la sonda nueva sigue su historia. Con Ninguno (servidor nuevo) se crea uno nuevo. El campo aparece solo si hay servidores inactivos.
Presiona Registrar y generar clave.
Se abre una ventana con las instrucciones de instalación.
Copia el token en ese momento: se muestra una sola vez, vence en 24 horas y sirve para una sola sonda. Si lo pierdes, genera otro con Reenrolar.
Paso 2: instalar en la máquina
Conéctate por SSH a la máquina de la sonda.
En Paso 1 · en la máquina de la sonda (por SSH), pega el comando, copia con Copiar el Comando de instalación (un solo paso) y pégalo en la máquina.
En Paso 2 · pega el token cuando el instalador lo pida, copia el Token de instalación (un solo uso) y pégalo cuando el instalador lo pida. Al pegarlo no se ve nada en pantalla: es normal. Presiona Enter.
El token ya dice a qué servidor de ARGUNIS conectarse: el instalador no pregunta nada más.
Si prefieres Portainer o docker compose, el token también sirve como variable de un stack. La pantalla lo indica en Instalar una sonda.
Qué hace el instalador
Instala Docker y Portainer si faltan, descarga y verifica la imagen firmada de la sonda, y crea el stack argunis-sonda-monitoreo en Portainer. Desde Portainer puedes ver la sonda y sus registros.
Qué pasa después
Al terminar, la sonda aparece conectada en la lista de Sondas de monitoreo.
Su servidor aparece en Infraestructura con la etiqueta Sonda de monitoreo.
Ya puedes elegirla en Revisar desde al Agregar un equipo, en los Descubrir equipos en tu red y en las pruebas de monitoreo.
Estados en la lista
Estado | Qué significa |
|---|---|
pendiente · esperando instalación | Registrada, aún no se instala. |
activa · conectada | Instalada y en línea. |
activa · sin conexión | Instalada, pero no reporta. Revisa la máquina. |
revocada | Ya no puede conectarse. |
La lista también muestra la versión y arquitectura, el servidor propio y cuántas instrucciones tiene y cuántas fallan.