Diagnóstico

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.

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).

Errores al iniciar (Windows)

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

1. Clave de API: compruebe que la clave de API esté correctamente indicada en el archivo config.toml o en el registro.
2. 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.

3. 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)

Codificación del archivo de configuración (Windows)

El agente de servidor 3.0 lee config.toml en UTF-8 estricto y no tolera ni marca de orden de bytes (BOM) ni UTF-16. Una edición manual en Windows produce a menudo una codificación incompatible, que impide que el agente arranque. El modo de fallo se lee en los registros:

Métodos fiables (UTF-8 sin BOM):

• Bloc de notas (Windows 10 1903+): Archivo > Guardar como y elegir la codificación «UTF-8» (no «UTF-8 with BOM»).
• PowerShell (todas las versiones), escritura garantizada sin BOM:

$cfg = "C:\ProgramData\Kabeen\Server Agent\config.toml"
$contenido = "api_key = `"SU_CLAVE_API_KABEEN`"`r`n"
[System.IO.File]::WriteAllText($cfg, $contenido, (New-Object System.Text.UTF8Encoding $false))

Para confirmar la ausencia de BOM, los 3 primeros bytes no deben ser EF BB BF:

Format-Hex $cfg | Select-Object -First 1