.. _agents_main_tab: **************** Agentes (Agents) **************** Un agente es un programa o software diseñado para ejecutarse de manera autónoma e independiente en un sistema operativo como Windows, Debian o RedHat. Su propósito es establecer una interacción con el sistema, para extraer información del equipo en el que esté instalado (hardware, software, o procesos que se están ejecutando). Recolectada la información, el agente la enviará a una dirección específica de manera segura y autenticada mediante el uso de **Tokens**, asegurando que solo el receptor autorizado pueda acceder a los datos. Desde esta sección el usuario es capaz de dar de alta, gestionar y vincular **Agentes** y **Tokens**. .. image:: ../images/setup/4_145_configuration_agents_tab_62.png :align: center .. _manage_tab: Manage ====== Listado global de agentes gestionados en **WOCU-Monitoring**. Desde esta sección el usuario puede crear, descargar y eliminar agentes de forma individual o masiva. .. image:: ../images/setup/4_145a_configuration_agents_manage_62.png :align: center Campos del listado Manage ------------------------- Se describen a continuación los campos del listado de agentes creados: .. image:: ../images/setup/4_145b_configuration_agents_manage_table_62.png :align: center **✓ Name** Este campo muestra el nombre formal del agente. **✓ Description** Nombre descriptivo del agente. **✓ Platform** Plataforma sobre la que se va a ejecutar el agente (Windows, Debian o RedHat). **✓ Agent gateway** Dirección o punto de conexión que utiliza el agente para comunicarse con WOCU-Monitoring. **✓ Token** Token asociado al agente. Actions ^^^^^^^ Las posibles acciones aplicables a cada entrada de la tabla son descritas a continuación: .. image:: ../images/setup/4_145c_configuration_agents_manage_actions_62.png :align: center **✓ Download**: facilita la descarga del fichero (.zip) propio del agente. Ejecutando esta acción se iniciará la descarga del fichero al disco duro, para su tratamiento o uso posterior. El contenido de ese fichero es el que un operador deberá hacer llegar a la máquina que desee monitorizar e instalarlo. **✓ Delete**: procede al borrado definitivo de un agente en concreto. Para consolidar la baja, será necesario confirmar la acción en el siguiente cuadro de diálogo. .. image:: ../images/setup/4_145d_configuration_agents_manage_actions_delete_62.png :align: center Información detallada del Agente ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Haciendo clic sobre el nombre de un ítem en concreto, emergerá su correspondiente vista detalle con los valores de configuración de los distintos atributos del agente. .. image:: ../images/setup/4_145e_configuration_agents_manage_actions_info_name_62.png :align: center A continuación se describen los distintos campos/columnas de la tabla: .. image:: ../images/setup/4_145f_configuration_agents_manage_actions_info_view_62.png :align: center **✓ Name**: nombre formal del agente. **✓ Description**: nombre descriptivo del agente. **✓ Platform**: plataforma sobre la que se ejecuta el agente (Windows, Debian o RedHat). **✓ Schema**: indica el protocolo de comunicación que el agente utiliza para enviar la información al gateway. **✓ Agent away**: dirección o punto de conexión que utiliza el agente para comunicarse con WOCU-Monitoring. **✓ Token**: token asociado al agente. **✓ Created at**: indica la fecha y hora exacta en la que se creó o registró el agente en el sistema. **✓ Updated at**: indica la última fecha y hora en la que se realizó alguna actualización o modificación en la configuración o información del agente. **✓ Is active**: muestra si el agente está activo actualmente. El icono ✔️ indica que el agente está funcionando y en operación. El sistema también permite efectuar cambios en la configuración del agente desde la propia modal de información. A través del botón **Edit**, se accede al formulario editable con los parámetros de configuración del agente original, para su libre modificación y actualización. .. image:: ../images/setup/4_145g_configuration_agents_manage_actions_info_edit_62.png :align: center Añadir un nuevo Agente (+ Add Agent) ------------------------------------ El alta de un nuevo agente se iniciará desde el botón **+ Add Agent**. A continuación, se describe dicho proceso junto con los correspondientes campos y parámetros a configurar en el siguiente formulario: .. image:: ../images/setup/4_145h_configuration_agents_manage_add_agent_62.png :align: center **✓ Realm name**: campo que indica el nombre del Reino en donde se creará el nuevo agente. **✓ Name**: nombre formal del agente. **✓ Description**: nombre descriptivo del agente. **✓ Platform**: plataforma sobre la que se ejecuta el agente (Windows, Debian o RedHat). **✓ Schema**: indica el protocolo de comunicación que el agente utilizará para enviar la información al gateway. **✓ Agent away**: dirección o punto de conexión que utiliza el agente para comunicarse con WOCU-Monitoring. **✓ Token**: token asociado al agente. Para más información: :ref:`tokens_tab`. **✓ Created at**: indica la fecha y hora exacta en la que se creó o registró el agente en el sistema. **✓ Updated at**: indica la última fecha y hora en la que se realizó alguna actualización o modificación en la configuración o información del agente. **✓ Is active**: habilitando esta opción el agente iniciará su operación. Una vez obtenida la configuración deseada, es necesario guardar y consolidar los cambios efectuados pulsando el botón **Create**. .. _tokens_tab: Tokens ====== Listado global de tokens gestionados en **WOCU-Monitoring**. Desde esta sección el usuario puede crear, gestionar y eliminar tokens, facilitando su vinculación a agentes según sea requerido. .. sidebar:: Recuerda El token es una clave única que se utiliza para autenticar y autorizar la comunicación entre el agente y WOCU-Monitoring. Funciona como una credencial que asegura que el agente es legítimo y tiene permiso para enviar datos al sistema. .. image:: ../images/setup/4_145i_configuration_agents_token_62.png :align: center Campos del listado Tokens ------------------------- Se describen a continuación los campos del listado de tokens disponibles: .. image:: ../images/setup/4_145j_configuration_agents_token_table_62.png :align: center **✓ Token** Este campo muestra el identificador único del token. **✓ Name** Este campo muestra el nombre formal del token. **✓ Description** Nombre descriptivo del token. **✓ Created** Indica la fecha y hora exacta en la que se creó o registró el token en el sistema. **✓ Total agents** Indica el número de agentes con dicho token vinculado. **✓ Active** Muestra si el token está activo actualmente. El icono ✔️ indica que el elemento está funcionando y en operación. Actions ^^^^^^^ Las posibles acciones aplicables a cada entrada de la tabla son descritas a continuación: .. image:: ../images/setup/4_145k_configuration_agents_token_actions_62.png :align: center **✓ Delete**: procede al borrado definitivo de un token en concreto. Para consolidar la baja, será necesario confirmar la acción en el siguiente cuadro de diálogo. .. image:: ../images/setup/4_145l_configuration_agents_token_actions_delete_62.png :align: center Información detallada del Token ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Haciendo clic sobre el nombre de un ítem en concreto, emergerá su correspondiente vista detalle con los valores de configuración de los distintos atributos del token. .. image:: ../images/setup/4_145m_configuration_agents_tokens_actions_info_name_62.png :align: center A continuación se describen los distintos campos/columnas de la tabla: .. image:: ../images/setup/4_145n_configuration_agents_tokens_actions_info_view_62.png :align: center **✓ Name**: este campo muestra el nombre formal del token. **✓ Description**: nombre descriptivo del token. **✓ Token**: este campo muestra el identificador único del token. **✓ Agents count**: indica la cantidad de agentes vinculados al token especificado. **✓ Agents**: identifica el agente asociado al token especificado. **✓ Created at**: indica la fecha y hora exacta en la que se creó o registró el token en el sistema. **✓ Updated at**: indica la última fecha y hora en la que se realizó alguna actualización o modificación en la configuración o información del token. **✓ Is active**: muestra si el token está activo actualmente. El icono ✔️ indica que el token está funcionando y en operación. El sistema también permite efectuar cambios en la configuración del token desde la propia modal de información. A través del botón **Edit** se accede al formulario editable con los parámetros de configuración del token original, para su libre modificación y actualización. .. image:: ../images/setup/4_145o_configuration_agents_tokens_actions_info_edit_62.png :align: center Añadir nuevo Token (+ Add Token) -------------------------------- El alta de un nuevo agente se iniciará desde el botón **+ Add Token**. A continuación, se describe dicho proceso junto con los correspondientes campos y parámetros a configurar en el siguiente formulario: .. image:: ../images/setup/4_145p_configuration_agents_manage_add_token_62.png :align: center **✓ Realm name**: campo que indica el nombre del Reino en donde se creará el nuevo token. **✓ Name**: nombre formal del token. **✓ Description**: nombre descriptivo del token. **✓ Is active**: habilitando esta opción el token iniciará su operación. Una vez obtenida la configuración deseada, es necesario guardar y consolidar los cambios efectuados pulsando el botón **Create**.