Instalación manual del agente de servidor

El agente de servidor de Kabeen es el componente encargado de recopilar información sobre la infraestructura del sistema de información: configuración del host, métricas del sistema, programas instalados y procesos en ejecución.

Es un servicio de sistema autónomo que debe instalarse en cada servidor que desee analizar en Kabeen. Los datos se transmiten al backend de Kabeen mediante gRPC sobre TLS, utilizando únicamente el puerto saliente 443/TCP.

Novedad en 3.0. El agente de servidor ahora se distribuye como un instalador MSI firmado en Windows (en sustitución del .exe) y su configuración utiliza un archivo TOML (config.toml) en lugar de application.conf. Si ya hay un agente anterior instalado en la máquina, su configuración se migra automáticamente en el primer inicio (consulte Migración desde el agente anterior).

Requisitos previos

• Conexión saliente permitida hacia intake.kabeen.io en el puerto 443/TCP. No se requiere ninguna conexión entrante.
• Privilegios de administrador (root en Linux, miembro de Administradores locales en Windows).
• En Linux, se requiere systemd como gestor de init.

Descarga del paquete

Descargue el paquete correspondiente a su sistema operativo desde su consola Kabeen (Infraestructura > Agregar un servidor > Instalación automática).

Instalación en Windows

1. Haga doble clic en el archivo MSI y acepte la elevación de UAC.
2. Lea y acepte el Acuerdo de licencia de usuario final (CLUF).
3. En la pantalla Kabeen API key, pegue la clave API obtenida de su cuenta Kabeen. También puede dejar el campo vacío e indicar la clave más tarde en config.toml.
4. Haga clic en Install.

El instalador copia el binario en C:\Program Files\Kabeen\Server Agent\, escribe la configuración en C:\ProgramData\Kabeen\Server Agent\config.toml, registra el servicio de Windows KabeenServerAgent (inicio automático) y lo arranca.

Instalación silenciosa. Para un equipo aislado, en PowerShell como administrador:

msiexec /i "kabeen-server-agent-x86_64.msi" /qn /norestart APIKEY="SU_CLAVE_API_KABEEN"

Para un despliegue masivo (GPO, Intune, SCCM), consulte las guías dedicadas de la sección Agente de infraestructura.

Instalación en Linux (Debian / Ubuntu)

Instale el paquete .deb descargado (apt-get install resuelve las dependencias automáticamente):

sudo apt-get install ./kabeen-server-agent_amd64.deb

La instalación crea el archivo de configuración, activa la unidad kabeen-server-agent.service y la arranca. A continuación, indique la clave API (consulte Configuración de la clave API).

Instalación en Linux (Red Hat y derivados)

Instale el paquete .rpm descargado:

sudo dnf install ./kabeen-server-agent.x86_64.rpm
# o, en distribuciones sin dnf:
sudo yum install ./kabeen-server-agent.x86_64.rpm

Al igual que en Debian, el servicio se activa y arranca automáticamente. Solo queda indicar la clave API.

Configuración de la clave API

En Linux, la clave API debe indicarse en el archivo /etc/kabeen-server-agent/config.toml:

api_key = "SU_CLAVE_API_KABEEN"

sudo install -m 600 -o root -g root /dev/stdin /etc/kabeen-server-agent/config.toml <<'EOF'
api_key = "SU_CLAVE_API_KABEEN"
EOF

En Windows, el archivo se encuentra en C:\ProgramData\Kabeen\Server Agent\config.toml.

No es necesario reiniciar el servicio. El agente vuelve a leer config.toml automáticamente cada 10 segundos: la nueva clave se tiene en cuenta en el siguiente ciclo. Como el archivo contiene una clave en texto plano, mantenga permisos restrictivos (0600 / root en Linux).

Codificación. En Windows, guarde config.toml en UTF-8 sin BOM (no UTF-16): una codificación incorrecta impide que el agente arranque. Métodos fiables y diagnóstico en Diagnóstico › Codificación del archivo de configuración.

Despliegue automatizado en Linux

En un parque de servidores, la instalación puede automatizarse por completo e integrarse en una herramienta de orquestación (Ansible, Puppet, Chef, script de aprovisionamiento…). El principio es el mismo que en la instalación manual: descargar el paquete correspondiente a la distribución, instalarlo y luego escribir la clave API en config.toml.

El script siguiente detecta automáticamente la familia de la distribución y realiza la instalación de principio a fin. Espera la clave API como argumento:

#!/bin/bash
set -euo pipefail
 
API_KEY="${1:-}"
BASE_URL="https://app.kabeen.io/download/packages/server/latest"
 
if [ -z "$API_KEY" ]; then
    echo "Uso: $0 <CLAVE_API_KABEEN>"
    exit 1
fi
 
# Detección de la familia de distribución
if [ -f /etc/debian_version ]; then
    wget -q "$BASE_URL/kabeen-server-agent-1_amd64.deb" -O /tmp/kabeen-server-agent.deb
    apt-get install -y /tmp/kabeen-server-agent.deb
elif [ -f /etc/redhat-release ]; then
    wget -q "$BASE_URL/kabeen-server-agent.x86_64.rpm" -O /tmp/kabeen-server-agent.rpm
    dnf install -y /tmp/kabeen-server-agent.rpm || yum install -y /tmp/kabeen-server-agent.rpm
else
    echo "Distribución no soportada"
    exit 1
fi
 
# Escribir la clave API con permisos restrictivos
install -m 600 -o root -g root /dev/stdin /etc/kabeen-server-agent/config.toml <<EOF
api_key = "$API_KEY"
EOF
 
echo "Instalación completada. Verificando el servicio..."
systemctl status kabeen-server-agent.service --no-pager

El paquete ya activa e inicia kabeen-server-agent.service. Como el agente vuelve a leer config.toml cada 10 segundos, no es necesario reiniciar tras escribir la clave: se tiene en cuenta en el siguiente ciclo.

Migración desde el agente anterior

Si ya hay un agente anterior instalado, el agente de servidor de Kabeen importa automáticamente su configuración en el primer inicio:

La reutilización del agentUUID garantiza que la máquina conserve la misma identidad en la consola Kabeen — no aparece como un nuevo host.

La migración se realiza una sola vez y nunca sobrescribe una configuración ya indicada. Procedimiento recomendado: instale el agente de servidor, verifique en la consola Kabeen que la máquina aparece con el mismo identificador y luego desinstale el agente anterior.

Verificación del funcionamiento

Linux:

sudo systemctl status kabeen-server-agent.service
sudo journalctl -u kabeen-server-agent.service -f

Windows (PowerShell como administrador):

Get-Service -Name KabeenServerAgent

Una vez indicada una clave API válida, los registros deben mostrar All tasks running. Agent is operational., y la máquina debe aparecer en su consola Kabeen con un heartbeat reciente (menos de 2 minutos).

Solución de problemas

El servicio no inicia

1. Consulte los registros: journalctl -u kabeen-server-agent.service -n 50
2. Verifique la configuración: cat /etc/kabeen-server-agent/config.toml
3. En Windows, verifique la codificación del archivo (UTF-8 sin BOM): consulte la nota Codificación de la sección Configuración de la clave API.

Error de conexión

1. Pruebe la conectividad saliente hacia el intake: nc -zv intake.kabeen.io 443 (o curl -sv https://intake.kabeen.io).
2. Verifique la configuración del proxy si corresponde.
3. Verifique el firewall: solo se requiere el puerto 443/TCP saliente hacia intake.kabeen.io.