⌘K
AgentesInstalar Agente

Instalar Agente

1. Servidor a monitorear

Selecciona uno existente o crea uno nuevo. Cada servidor tiene su propio token.

…o crear uno nuevo
Origen:
Estado del agente
—
Sin servidor seleccionado

2. Instalar en el servidor

Ejecuta el comando correspondiente al sistema operativo del servidor.

Probar conexión (linux)
DNS y host
Sin ejecutar
Endpoint de ingesta
Sin ejecutar
Script de instalación (linux)
Sin ejecutar

Verifica que monitor.torobyte.com resuelva, que la ingesta responda y que el script no sea HTML antes de copiar el comando.

Instalación (una sola línea — muestra el progreso paso a paso)
curl -fsSL "https://monitor.torobyte.com/api/public/agents/install.sh" | sudo env TOKEN="<TOKEN>" URL="https://monitor.torobyte.com/api/public/ingest/metrics" sh -s linux
ℹ️ El agente reporta cada 60s. En cuanto envíe la primera métrica, el estado del servidor pasará a en línea y verás los datos en tiempo real.
🗑 Desinstalar el agente del host

Detiene el servicio, elimina binarios, configuración y logs. No borra el servidor de la plataforma.

curl -fsSL "https://monitor.torobyte.com/api/public/agents/install.sh" | sudo sh -s linux uninstall
VolverVer servidor →

Logs de instalación / últimas métricas

Últimos 20 reportes que recibió la plataforma para este servidor. Si la lista está vacía, el agente aún no logró enviar nada.

Selecciona un servidor.

Solución de problemas

❌ syntax error near unexpected token '<' / aparece HTML al ejecutar el comando
La URL desde la que estás descargando devolvió una página HTML (típicamente porque copiaste el comando apuntando a un preview de Lovable que pide login). Asegúrate de que la URL del script empiece con https://monitor.torobyte.com. Usa el botón Probar conexión arriba para validarlo.
🔑 401 Unauthorized / token inválido al enviar métricas
El token del servidor cambió o no se exportó como variable de entorno. Vuelve a copiar el token desde esta pantalla, o haz clic en Rotar token y re-ejecuta el instalador. En macOS / Linux verifica que el comando use sudo env TOKEN='…' URL='…' sh "$tmp" install.
🍎 macOS Apple Silicon (M1/M2/M3): la instalación se queda colgada o falla en el paso 5
  • Reinstala con la última versión (ya optimizada para Apple Silicon — lsof -iUDP deshabilitado, top rápido).
  • Si aparece "Operation not permitted": ve a Ajustes del Sistema → Privacidad y seguridad → Acceso completo al disco y agrega /bin/sh o Terminal.
  • Verifica permisos del LaunchDaemon: sudo launchctl print system/com.torobyte.agent.
  • Logs del agente: sudo tail -f /var/log/torobyte-agent.log.
🪟 Windows: 'iex' no descarga o falla TLS
Ejecuta PowerShell como Administrador. Si tu Windows es antiguo (7 / 2008 R2) el comando ya fuerza TLS 1.2. Verifica que iwr https://monitor.torobyte.com/api/public/agents/windows.ps1 responda con texto que empiece con # Torobyte.
🔥 Timeouts / no llegan métricas
  • El firewall de salida debe permitir HTTPS (443) hacia monitor.torobyte.com.
  • Prueba manualmente desde el host: curl -v https://monitor.torobyte.com/api/public/ingest/metrics.
  • Revisa los logs del servicio: Linux journalctl -u torobyte-agent -f · macOS tail -f /var/log/torobyte-agent.log · Windows Visor de eventos → Task Scheduler.
🔐 Permission denied al instalar
El instalador requiere root/Administrator porque registra un servicio del sistema. En Linux/macOS antepón sudo; en Windows abre PowerShell con clic derecho → Ejecutar como administrador.