Diagnóstico | Docs

Este artículo reúne los elementos de diagnóstico de los dos agentes de Kabeen: el agente de usuario, desplegado en los puestos, y el agente de servidor, desplegado en la infraestructura.

Agente de usuario

El agente de usuario registra su actividad en archivos de log locales. Estos archivos son el principal recurso de diagnóstico cuando se produce un comportamiento inesperado.

Modificar el nivel de registro

El agente de usuario funciona por defecto con un nivel de registro INFO. Este parámetro puede ajustarse mediante el registro de Windows.

Ruta: HKEY_CURRENT_USER\Software\Policies\Kabeen\Configuration
Nombre de la clave: LogLevel
Valores aceptados: Error, Info, Debug

Después de modificar el registro, reinicie el agente Kabeen para que el nuevo nivel surta efecto.

Ubicación de los archivos de log

Los archivos de log se almacenan en ubicaciones específicas según el sistema operativo. Los logs se guardan de forma individual para cada usuario.

Plataforma	Ubicación
Windows	`%AppData%\Kabeen\logs`
macOS	`~/Library/Logs/Kabeen/logs`

Agente de servidor

El agente de servidor es el agente de infraestructura de Kabeen para Windows, Linux e IBM i. Recopila las métricas y la información de inventario de forma autónoma a través de un canal HTTPS autenticado mediante una clave de API vinculada al tenant. El agente de servidor funciona como servicio y no recibe órdenes descendentes desde la plataforma.

Arquitectura y componentes

El agente está formado por varios módulos:

Un componente principal de recopilación y coordinación
Un módulo dedicado a la recopilación de métricas del sistema
Servicios de configuración y autenticación
Un sistema de registro centralizado

Configuración e inicialización

La configuración del agente de servidor cubre los siguientes elementos:

La clave de API utilizada para autenticarse ante la plataforma
Los parámetros de pertenencia a una estructura y a un equipo
Los parámetros de conexión saliente (proxy, etc.)

En Windows, ciertos parámetros como el nivel de registro se definen mediante claves del registro.

Registro

Los logs del agente de servidor se almacenan localmente en el servidor. Son la primera fuente de información durante un diagnóstico.

La ubicación de los logs depende de la versión del agente. La versión 3.0 (Kabeen Server Agent) escribe en nuevas ubicaciones, junto a las del agente antiguo (Kapsul).

Plataforma	Archivo / comando de logs
Windows (3.0)	`C:\ProgramData\Kabeen\Server Agent\`
Windows (antiguo)	`C:\Program Files (x86)\Kapsul\logs\kapsul.log`
Linux (3.0)	`journalctl -u kabeen-server-agent.service`
Linux (antiguo)	`/var/log/kapsul.log`

Errores al iniciar (Windows)

Si el agente de servidor no se inicia en Windows, realice las siguientes comprobaciones:

Clave de API: compruebe que la clave de API esté correctamente indicada en el archivo config.toml o en el registro.
Estado del servicio: verifique que el servicio esté presente e iniciado.

sc query kapsul
Get-Service KabeenServerAgent

Utilice sc query kapsul para el agente antiguo o Get-Service KabeenServerAgent para la versión 3.0.

Conectividad saliente: asegúrese de que el servidor pueda alcanzar los servicios de Kabeen mediante HTTPS saliente:
- api.kabeen.io:443 (control / REST)
- intake.kabeen.io:443 (ingesta / gRPC)