Codenica Insight Agent es un pequeño programa instalado en el ordenador que debe incluirse en la monitorización. Su tarea es enviar a Codenica los datos necesarios para analizar el trabajo del puesto, la actividad del ordenador, las aplicaciones utilizadas, los eventos del sistema y otras áreas activadas en la configuración de monitorización. Después de una instalación correcta, el agente funciona en segundo plano y no requiere acciones diarias por parte del usuario del ordenador.
La descarga del instalador se encuentra en la parte superior de las vistas de monitorización. En el panel está disponible el botón Descargar instalador del agente y una ayuda desplegable Cómo instalar el agente de monitorización. Lo más importante es que el paquete de instalación se prepara para una empresa concreta. Esto significa que la configuración de conexión con su entorno Codenica ya está incluida con el instalador.
En la práctica, la instalación es muy sencilla:
- Abra cualquier vista de monitorización en Codenica.
- Haga clic en Descargar instalador del agente.
- Extraiga el paquete ZIP descargado en el ordenador que desea monitorizar.
- Ejecute install-agent.bat como administrador.
- Espere a que finalice la instalación.
El ordenador debe tener instalado Microsoft .NET Desktop Runtime 10.0.8 o posterior. Si el runtime aún no está disponible en el ordenador, descárguelo desde Microsoft: descargar .NET 10. El panel de monitorización también incluye un botón que abre directamente el instalador de .NET 10.0.8.
¿Qué contiene el paquete de instalación del agente de monitorización?
El archivo descargado es un paquete ZIP preparado para su empresa. No es un instalador genérico cualquiera. El sistema añade un archivo de configuración con la información necesaria para conectar el agente con el entorno Codenica correcto. Gracias a ello, la persona que instala el agente no tiene que introducir manualmente el identificador de la empresa, la dirección del servidor ni otros parámetros técnicos.
Después de extraer la carpeta, encontrará, entre otros archivos:
- codenica-insight-agent-installer.exe - el instalador real del programa Codenica Insight Agent.
- codenica-insight-agent.config.json - la configuración preparada para una empresa y un entorno Codenica concretos.
- install-agent.bat - el archivo de inicio más sencillo para instalar en un único ordenador.
- install-agent.ps1 - el script de PowerShell utilizado por el archivo BAT, útil también para instalaciones remotas o automatizadas.
- Archivos de instrucciones en varios idiomas que describen el contenido del paquete y el método básico de instalación.
La regla principal es sencilla: para una instalación estándar, utilice install-agent.bat. Este archivo inicia el proceso en el orden correcto y utiliza la configuración incluida en el paquete.
Instalación de Codenica Insight Agent paso a paso
La instalación estándar del agente de monitorización no requiere copiar manualmente archivos en carpetas del sistema. El paquete contiene un script que realiza automáticamente las acciones necesarias. El usuario solo tiene que iniciar la instalación con los permisos adecuados.
- Descargue el paquete de instalación desde el panel de monitorización en Codenica.
- Mueva el paquete al ordenador que debe ser monitorizado.
- Extraiga toda la carpeta ZIP. No ejecute los archivos directamente desde la vista previa del archivo comprimido.
- Compruebe que en la carpeta extraída se encuentren juntos los archivos install-agent.bat, install-agent.ps1, codenica-insight-agent-installer.exe y codenica-insight-agent.config.json.
- Haga clic con el botón derecho en install-agent.bat.
- Seleccione Ejecutar como administrador.
- Espere a que el script termine y muestre el mensaje final.
Los permisos de administrador son necesarios porque el agente instala un servicio de Windows, guarda archivos del programa en Program Files y crea la configuración en ProgramData. Si el archivo BAT se inicia sin estos permisos, la instalación se detendrá y pedirá que se ejecute de nuevo como administrador.
Se requiere .NET 10.0.8 o posterior
Codenica Insight Agent requiere Microsoft .NET Desktop Runtime 10.0.8 o posterior. Es un componente gratuito de Microsoft que permite ejecutar aplicaciones de escritorio basadas en .NET. No es necesario instalar el entorno completo de desarrollo ni el SDK si el ordenador solo necesita ejecutar el agente.
Si no está seguro de si el runtime ya está instalado, lo más sencillo es tratarlo como el primer paso de preparación del ordenador. Descargue el runtime actual desde el sitio oficial de Microsoft: .NET 10.0 - downloads. En Codenica, las instrucciones de instalación también incluyen el botón Descargar .NET 10.0.8, que abre el instalador directo para Windows x64.
- Versión mínima requerida: .NET Desktop Runtime 10.0.8.
- Puede instalar una versión más reciente de la misma línea si Microsoft ofrece un paquete más actualizado.
- En un ordenador Windows x64 típico, elija Windows Desktop Runtime x64.
- Después de instalar el runtime, vuelva a la carpeta del agente y ejecute install-agent.bat.
¿Qué ocurre después de ejecutar el archivo BAT?
El archivo install-agent.bat inicia un script de PowerShell que realiza la instalación real. Primero comprueba si se está ejecutando con permisos de administrador. Después prepara el directorio de configuración del agente, copia codenica-insight-agent.config.json en la ubicación utilizada por el programa y lo guarda como agentsettings.json. Solo entonces inicia el instalador EXE.
Durante la instalación se crea un servicio de Windows llamado CodenicaInsightAgent. El servicio se inicia automáticamente y es responsable de que el agente funcione en segundo plano. Después de la instalación, el agente debería empezar a trabajar por sí solo, y los nuevos datos comenzarán a llegar al sistema según la configuración de monitorización y el calendario de sincronización.
Ubicaciones más importantes después de la instalación:
- C:\Program Files\Codenica Insight Agent - carpeta predeterminada del programa.
- C:\ProgramData\Codenica\InsightAgent - carpeta de datos, configuración y registros.
- C:\ProgramData\Codenica\InsightAgent\Config\agentsettings.json - archivo de configuración real utilizado después de la instalación.
- C:\ProgramData\Codenica\InsightAgent\Logs - carpeta de registros técnicos.
¿Qué conviene recordar al instalar el agente de monitorización?
La instalación es sencilla, pero algunas reglas ayudan a evitar problemas habituales. La más importante se refiere al orden de ejecución de los archivos: no empiece solo con el instalador EXE, porque la configuración de la empresa se encuentra en un archivo JSON separado. El archivo BAT se encarga de copiar esa configuración en la ubicación correcta antes de instalar el programa.
- No ejecute codenica-insight-agent-installer.exe como primer archivo.
- No elimine codenica-insight-agent.config.json de la carpeta extraída.
- No modifique manualmente la configuración si no sabe exactamente qué resultado quiere conseguir.
- Ejecute install-agent.bat como administrador.
- Antes de la instalación, asegúrese de que el ordenador tenga el .NET Desktop Runtime 10.0.8 o posterior requerido.
- Para una instalación remota, puede utilizar install-agent.ps1, pero debe ejecutarse desde una carpeta que contenga el instalador EXE y el archivo de configuración.
Después de una instalación correcta, las próximas versiones de Codenica Insight Agent se actualizarán automáticamente. Gracias a ello, ni el usuario del ordenador ni el administrador tienen que descargar manualmente un nuevo instalador cada vez que aparezca una actualización del agente.