¿Cómo abrir la supervisión de agentes en Codenica?
La vista se abre desde el menú de la aplicación: Menu -> Monitorización -> Agentes. Está pensada para administradores que quieren comprobar rápidamente si Codenica Insight Agent está instalado correctamente en los ordenadores, si se comunica con el backend y si los datos de supervisión del trabajo se envían regularmente al sistema.
Esta vista no se utiliza principalmente para evaluar la actividad del empleado. Su objetivo principal es el control técnico de los agentes: versión del programa, última sincronización, errores, advertencias, estado de las colas, estado del backend y calidad de los datos. Así es más fácil distinguir una situación en la que el ordenador realmente no envía datos de otra en la que el problema se debe solo a una agregación retrasada o a la configuración del agente.
En la parte superior de la vista hay un panel de acciones relacionadas con el agente. Puede descargar el instalador de Codenica Insight Agent, abrir las instrucciones de instalación y acceder a la configuración de supervisión. Debajo se encuentra el Panel de análisis, que reúne los indicadores más importantes para el periodo seleccionado, y después la lista de agentes en forma de tabla.
En esta vista existe una excepción importante: un registro de la tabla representa un agente u ordenador, no un día de supervisión. Al hacer clic en un registro, la aplicación muestra los detalles del agente seleccionado, incluidos los resúmenes diarios del periodo definido en los filtros.
Lista de agentes en la supervisión de ordenadores
La tabla de la vista Agentes permite encontrar rápidamente puestos que requieren atención técnica. De forma predeterminada, la lista está orientada al control diario del funcionamiento de los agentes, por lo que muestra, entre otros datos, la descripción del ordenador, la versión del agente, la última sincronización, la última dirección IP y el estado general del agente. Estas columnas bastan para detectar ordenadores que llevan tiempo sin comunicarse con el sistema o que han empezado a informar de problemas.
En la configuración de la tabla se pueden activar columnas de diagnóstico adicionales. Son útiles cuando hay que comprobar con más precisión por qué la supervisión no entrega datos o por qué parte de la información llega con retraso.
- Estado del agente muestra la evaluación general del agente, por ejemplo correcto, advertencia, error, sin conexión o bloqueado.
- Versión del agente ayuda a encontrar ordenadores con una versión obsoleta de Codenica Insight Agent.
- Última sincronización y Última comunicación muestran cuándo el agente envió datos o contactó con el backend por última vez.
- Estado del backend informa si la última comunicación fue aceptada por el sistema.
- Errores, Advertencias y Sincronizaciones fallidas permiten separar la actividad técnica normal de los problemas que requieren revisión.
- Cola pendiente, Cola de envío y Cola con errores muestran si en el ordenador crece una cola de datos pendientes de envío.
- Bloqueos y Motivo del bloqueo ayudan a comprobar si el agente fue bloqueado intencionadamente en el sistema.
En la práctica, conviene empezar por los agentes con estado de error, muchas sincronizaciones fallidas, una cola pendiente grande o falta de comunicación reciente. Son las señales más habituales de que la supervisión del ordenador requiere intervención.
Panel de análisis en la supervisión del funcionamiento de agentes
El panel de análisis de la vista Agentes muestra el estado de todo el grupo de agentes en el rango de fechas seleccionado. Puede cambiar el periodo a día, semana, mes o rango personalizado. También están disponibles dos modos de cálculo: Total, es decir, la suma del periodo, y Media diaria, es decir, un valor calculado por día. Esta diferencia es importante, porque el mismo número de errores puede significar algo distinto en un día que en un rango largo con muchos ordenadores.
Los indicadores más importantes del panel describen:
- Agentes - el número de agentes incluidos en el análisis.
- Eventos - el número total de eventos técnicos registrados por los agentes.
- Errores y Advertencias - el número de errores y advertencias que pueden requerir diagnóstico.
- Sincronizaciones fallidas y Sincronizaciones correctas - la eficacia de la comunicación de los agentes con el backend.
- Comandos fallidos - comandos que el agente no ejecutó correctamente, por ejemplo actualización, reinicio o detención.
- Cola pendiente y Cola con errores - el estado de las colas de datos que esperan envío o no se procesaron correctamente.
- Advertencias de estado - advertencias relacionadas con el estado de los agentes.
- Ordenadores - el número de ordenadores vinculados a los agentes analizados.
Conviene leer el panel de izquierda a derecha: primero comprobar la escala de supervisión, luego el número de eventos y después los errores, sincronizaciones y colas. Así es más fácil valorar si el problema afecta a un solo ordenador, a un grupo mayor de puestos o a todo el entorno.
Rankings y categorías en la supervisión de agentes
La pestaña de rankings y categorías ayuda a ver dónde se concentra la mayor cantidad de eventos de supervisión de agentes. Un valor alto no siempre significa una avería. Un agente que se comunica con frecuencia con el sistema y realiza mucho trabajo puede generar más entradas de forma natural. Solo al combinar rankings con errores, sincronización y colas se ve si la actividad es normal o problemática.
En esta parte del panel puede analizar varios grupos de datos:
- Tipos de eventos - tipos de eventos informados por los agentes, por ejemplo sincronización, advertencias de estado o gestión de comandos.
- Niveles de gravedad - niveles de gravedad de eventos, que muestran rápidamente la proporción de información, advertencias y errores.
- Estados del backend - respuestas del backend a la comunicación del agente, especialmente importantes al diagnosticar sincronizaciones fallidas.
- Agentes principales - agentes que generan más eventos en el periodo seleccionado.
- Ordenadores más activos - ordenadores en los que el trabajo del agente es más visible en los datos.
- Empleados más activos - empleados vinculados a ordenadores, si el sistema puede asignar los datos a un usuario.
Los rankings son especialmente útiles después de desplegar agentes, después de actualizar una versión o después de cambiar la configuración de supervisión. Permiten comprobar si los nuevos eventos aparecen de forma equilibrada o solo en determinados ordenadores.
Tendencias y presencia por horas en la supervisión de agentes
Las tendencias muestran cómo cambió el funcionamiento de los agentes en los días del periodo seleccionado. En la vista Agentes, los gráficos más importantes son eventos, errores, sincronizaciones fallidas y colas pendientes. Si después de un periodo tranquilo aumenta de repente el número de errores o sincronizaciones fallidas, conviene comprobar si en ese momento cambiaron la configuración de red, las políticas de seguridad, la versión del agente o la disponibilidad del backend.
Los gráficos de tendencias ayudan a responder preguntas prácticas:
- ¿El problema con los agentes crece gradualmente o apareció de repente en un día?
- ¿Los errores aparecen de forma constante o solo en periodos cortos?
- ¿La cola pendiente disminuye después de recuperar la conexión o sigue creciendo?
- ¿Las sincronizaciones fallidas afectan a días concretos o a todo el rango analizado?
Un elemento aparte es el gráfico Presencia por horas. Muestra en qué horas locales aparecieron resúmenes de registros del agente. No es un contador de tiempo de trabajo, ni un número de eventos, ni la duración de la sincronización. Una hora marcada significa que durante esa hora se observó una entrada del registro del agente para el día supervisado.
Comparaciones de periodos en la supervisión de agentes
Las comparaciones permiten enfrentar el periodo actual con un rango anterior de duración similar. En la supervisión de agentes esto es muy útil, porque un número aislado de errores, sin contexto, puede inducir a error. Solo la comparación muestra si la situación es estable, mejora o empeora.
Preste atención sobre todo a los cambios en métricas técnicas:
- un aumento del número de errores puede indicar un problema con la versión del agente, la configuración o el entorno local de Windows,
- un aumento de sincronizaciones fallidas puede apuntar a un problema de conexión, registro del agente o respuesta del backend,
- un aumento de la cola pendiente sugiere que el agente recopila datos más rápido de lo que puede enviarlos,
- un aumento de la cola con errores significa que parte de los datos no se procesó correctamente y requiere revisión,
- un aumento de comandos fallidos puede significar que el agente no ejecuta correctamente comandos administrativos.
Al interpretar comparaciones hay que tener en cuenta la escala. Si en el periodo actual se añadieron muchos ordenadores nuevos a la supervisión, el aumento del número de eventos es natural. Es más preocupante el aumento de la proporción de errores, sincronizaciones fallidas o colas pendientes en relación con el número de agentes.
Anomalías en la supervisión de agentes
La pestaña de anomalías señala situaciones que se apartan del funcionamiento esperado de los agentes y pueden requerir una acción del administrador. El sistema no muestra aquí eventos informativos ordinarios, sino casos en los que se superan umbrales de errores, sincronización, colas y comandos.
La vista Agentes puede detectar, entre otros casos:
- alta proporción de errores del agente - cuando el agente generó muchos errores en relación con todos los eventos,
- alta proporción de sincronizaciones fallidas - cuando muchos intentos de enviar datos terminan en fallo,
- cola pendiente grande - cuando se acumulan en el ordenador registros pendientes de envío,
- cola con errores - cuando parte de los registros no se procesó correctamente,
- alta proporción de comandos fallidos - cuando el agente no ejecuta correctamente comandos como actualización, reinicio o detención.
Cada anomalía contiene el nombre del ordenador o agente, la fecha, el valor actual, el umbral de referencia y datos de evidencia. Lo mejor es empezar el diagnóstico por anomalías de gravedad alta, especialmente si aparecen al mismo tiempo errores de sincronización y colas pendientes.
Detalles del registro en la supervisión del funcionamiento del agente
Al hacer clic en un registro de la lista, la aplicación abre los detalles del agente seleccionado. En esta parte ya no ve la lista general de instalaciones, sino resúmenes diarios de un ordenador o agente concreto en el periodo elegido. Es una buena forma de comprobar si el problema visible en la tabla se confirma en los datos diarios.
Los detalles pueden incluir tanto información técnica del agente como datos agregados de otras áreas de supervisión:
- fechas de resúmenes, primera y última actividad, y horas activas,
- tiempo activo, tiempo en primer plano, inactividad, teclado y clics del ratón,
- aplicaciones utilizadas, última aplicación y programa más usado,
- dominios web, número de aperturas de páginas y último dominio,
- documentos, operaciones del portapapeles, eventos de archivos y transferencias de datos,
- eventos USB, intentos de impresión y estados de políticas de seguridad,
- aplicaciones bloqueadas, sitios bloqueados e infracciones de políticas,
- estado de auditoría, número de elementos de hardware, programas, dispositivos USB, impresoras y comprobaciones de seguridad,
- último estado del backend, último error, colas e información sobre comandos del agente.
Por eso los detalles del registro son útiles no solo cuando falla un agente, sino también cuando en otras vistas de supervisión faltan datos para un ordenador. Puede comprobar entonces si el agente trabajó realmente, si envió datos y si el backend los aceptó correctamente.
Calidad y frescura de datos en la supervisión de agentes
Las secciones de calidad y frescura de datos ayudan a valorar si los resultados visibles en el panel están completos. Es especialmente importante en la vista Agentes, porque la falta de datos puede deberse a varias causas: el ordenador pudo estar apagado, el agente pudo no enviar datos, la sincronización pudo fallar o el registro del día actual puede estar todavía en agregación.
Conviene prestar atención a la siguiente información:
- Cobertura de detalles - muestra qué parte de los registros tiene detalles completos,
- Registros sin detalles - indica registros sin datos detallados, aunque pueda existir un resumen,
- Datos actuales parciales - significa datos del día actual que quizá todavía no estén cerrados,
- Registros históricos abiertos - señala registros antiguos que aún parecen incompletos,
- Detalles no válidos - informa de un problema con la estructura de los datos detallados,
- Días sin datos - muestra días del rango seleccionado para los que el sistema no tiene registros del agente.
La frescura de los datos informa cuándo se generó la vista, si incluye el día actual, cuál es el registro más reciente y si existe retraso. Si el panel muestra problemas de calidad o frescura, primero revise la última comunicación del agente, el estado del backend, la cola pendiente y el último error en el ordenador concreto.