[comment]: # ({1c2455b7-1c2455b7}) # 2 Autorregistro de agente activo [comment]: # ({/1c2455b7-1c2455b7}) [comment]: # ({e6cc9193-81edbbe2}) #### Descripción general Es posible permitir el autoregistro activo del agente Zabbix, después del cual el servidor puede comenzar a ser monitoreado. De esta manera se pueden crear nuevos equipos. agregados para monitoreo sin configurarlos manualmente en el servidor. El registro automático puede ocurrir cuando un agente activo previamente desconocido solicita su comprobación. La función puede resultar muy útil para el seguimiento automático de los nuevos nodos en la nube. Tan pronto como tenga un nuevo nodo en la nube, Zabbix iniciarrá automáticamente la recopilación de datos de rendimiento y disponibilidad del equipo. El registro automático de agente activo también admite el monitoreo de equipos agregados con comprobaciones pasivas. Cuando el agente activo solicita comprobaciones, siempre que tenga los parámetros de configuración 'ListenIP' o 'ListenPort' definidos en el archivo de configuración, estos se envían al servidor. (Si se especifican varias direcciones IP, la primera se envía al servidor.) El servidor, al agregar el nuevo equipo registrado automáticamente, utiliza la dirección IP recibida y el puerto para configurar el agente. Si no hay ningún valor de dirección IP recibido, se utiliza el utilizado para la conexión entrante. Si no hay puerto recibido, se utiliza 10050. Es posible especificar que el equipo debe registrarse automáticamente con un [Nombre DNS](#using_dns_as_default_interface) como interfaz predeterminado del agente. El registro automático se vuelve a ejecutar: - si la información del equipo [metadatos](#using_host_metadata) cambia: - debido a que HostMetadata cambió y el agente se reinició - debido al valor devuelto por HostMetadataItem cambió - para equipos creados manualmente a los que les faltan metadatos - si un equipo se cambia manualmente para ser monitoreado por otro proxy Zabbix - si el registro automático para el mismo equipo proviene de un nuevo proxy Zabbix El latido del registro automático del agente activo para el servidor Zabbix y el proxy Zabbix es de 120 segundos. Entonces, en caso de que se elimine un equipo descubierto, el registro automático se volverá a ejecutar en 120 segundos. [comment]: # ({/e6cc9193-81edbbe2}) [comment]: # ({5d32b87c-5d32b87c}) #### Configuración [comment]: # ({/5d32b87c-5d32b87c}) [comment]: # ({bf3762f0-bf3762f0}) ##### Especificar servidor Asegúrate de tener el Zabbix server identificado en el agente. [configuration file](/manual/appendix/config/zabbix_agentd) - zabbix\_agentd.conf Servidor activo = 10.0.0.1 A menos que defina específicamente un *Nombre de host* en zabbix\_agentd.conf, el nombre de host de la ubicación del agente será utilizado para nombrar el host. El nombre de host del sistema en Linux puede ser obtenido ejecutando el comando 'hostname'. Si *Nombre de host* está definido en la configuración del agente Zabbix como un lista de hosts delimitada por comas, se crearán hosts para todos los nombres de host enumerados. Reinicie el agente después de realizar cambios en el archivo de configuración. [comment]: # ({/bf3762f0-bf3762f0}) [comment]: # ({71baf8de-7b103292}) ##### Acción para el autoregistro de agente activo Cuando el servidor recibe una solicitud de registro automático de un agente, llama a una [acción](/manual/config/notifications/action). Una acción con un origen de evento "Autoregistration" debe configurarse para el registro automático del agente. ::: noteclassic La configuración del [descubrimiento de red](network_discovery) no se requiere para tener agentes activos autoregistrados. ::: En la interfaz de Zabbix, vaya a *Alertas → Acciones*, seleccione *Acciones de autorregistro* y haga clic en *Crear acción*: - En la pestaña Acción, dele un nombre a su acción. - Opcionalmente especifique las [condiciones](/manual/config/notificaciones/action/conditions#autoregistration_actions). Puede hacer una coincidencia de subcadena o de expresión regular en las condiciones para el nombre de equipo/metadatos de equipo. Si vasa utilizar la condición de "metadatos del equipo", consulte la siguiente sección. - En la pestaña Operaciones, agregue operaciones relevantes, como - 'Agregar equipo', 'Agregar al grupo de equipos' (por ejemplo, *Equipos descubiertos*), 'Enlace a plantillas', etc. ::: notetip Si es probable que los equipos que se registren automáticamente sean compatibles solo para monitoreo activo (como equipos que están detrás de un cortafuegos desde su servidor Zabbix), entonces es posible que desee crear una plantilla específica como *Template\_Linux-active* para ser vinculada. ::: Los equipos creados se agregan al grupo *Equipos descubiertos* (de forma predeterminada, configurable en *Administración* → *General* → *[Otro](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si desea que los equipos se agreguen a otro grupo, agregue una operación *Eliminar del grupo de equipos* (especificando "Equipos descubiertos") y también agregue una operación *Agregar a grupo de equipos* (especificando otro grupo de equipos), porque un equipo debe pertenecer a un grupo de equipos. [comment]: # ({/71baf8de-7b103292}) [comment]: # ({b7da9f3a-66cac4ef}) #### Autorregistro seguro Es posible realizar un registro automático de forma segura mediante la configuración de la autenticación de PSK-based con conexiones cifradas. El nivel de cifrado se configura globalmente en *Administración* → *General* → *[Autoregistro](/manual/web_interface/frontend_sections/administration/general#autoregistration)*. Es posible seleccionar sin cifrado, TLS cifrado con autenticación PSK o ambas (para que algunos equipos puedan registrarse sin cifrado y otros mediante cifrado). La autenticación por PSK es verificada por el servidor Zabbix antes de agregar un equipo. Si tiene éxito, se agrega el equipo y las *[conexiones desde/hacia el equipo](/manual/config/hosts/host#encryption)* son configurados en 'PSK' solo con identidad/clave precompartida igual que en la configuración global del registro automático. ::: noteimportant Para garantizar la seguridad del registro automático en instalaciones utilizando proxies, el cifrado entre el Zabbix server y el proxy debe estar habilitado. ::: [comment]: # ({/b7da9f3a-66cac4ef}) [comment]: # ({9c275675-9c275675}) #### Usando DNS como interfaz predeterminada La [configuración de los parámetros](/manual/appendix/config/zabbix_agentd) HostInterface y HostInterfaceItem permite especificar un valor personalizado para la interfaz del equipo durante el registro automático. Más específicamente, son útiles si el equipo debe registrarse automáticamente. con un nombre DNS como interfaz de agente predeterminada en lugar de su DIRECCIÓN IP. En ese caso, el nombre DNS debe especificarse o devolverse como el valor de los parámetros HostInterface o HostInterfaceItem. Tenga en cuenta que si el valor de uno de los dos parámetros cambia, se actualiza la interfaz del equipo registrado automáticamente. Entonces es posible actualizar la interfaz predeterminada a otro nombre DNS o actualízarla a una dirección IP. Sin embargo, para que los cambios surtan efecto, es necesario reiniciar el agente. ::: noteclassic Si los parámetros HostInterface o HostInterfaceItem no están configurados, el parámetro listening\_dns se resuelve a partir de la dirección IP. Si dicha resolución se configura incorrectamente, puede romperse el registro automático debido a un nombre de equipo no válido. ::: [comment]: # ({/9c275675-9c275675}) [comment]: # ({2f13e0b0-af247ed6}) #### Uso de metadatos del equipo Cuando el agente envía una solicitud de registro automático al servidor, envía su nombre de equipo. En algunos casos (por ejemplo, nodos de la nube de Amazon), un nombre de equipo no es suficiente para que el servidor Zabbix diferencie los equipos descubiertos. Los metadatos del equipo se pueden utilizar opcionalmente para enviar otra información desde un agente. al servidor. Los metadatos del equipo se configuran en el [archivo de configuración](/manual/appendix/config/zabbix_agentd) del agente - zabbix\_agentd.conf. Hay dos formas de especificar metadatos del equipo en el archivo de configuración: HostMetadata HostMetadataItem Vea la descripción de las opciones en el enlace de arriba. El parámetro HostMetadataItem puede devolver hasta 65535 puntos de código UTF-8. Un valor más largo se truncará. Tenga en cuenta que en MySQL, la longitud máxima efectiva en caracteres será menor si el valor devuelto contiene caracteres multibyte. Por ejemplo, un valor que contiene caracteres de 3 bytes únicamente se limitará a 21844 caracteres en total, mientras que un valor que contenga los caracteres de 4 bytes estarán limitados a 16383 símbolos. ::: noteimportant Un intento de autoregistro ocurre cada vez que un agente activo envía una solicitud para actualizar los controles activos al servidor. El retraso entre solicitudes se especifica en el parámetro [RefreshActiveChecks](/manual/appendix/config/zabbix_agentd) del agente. La primera solicitud se envía inmediatamente después de que el agente es reiniciado. ::: [comment]: # ({/2f13e0b0-af247ed6}) [comment]: # ({070aaeb4-070aaeb4}) ##### Ejemplo 1 Usar metadatos del equipo para distinguir entre equipos Linux y Windows. Supongamos que desea que el servidor Zabbix registre automáticamente los equipos. Tiene agentes Zabbix activos (consulte la sección "Configuración" más arriba) en su red. Hay equipos de Windows y equipos de Linux en su red y tiene plantillas disponibles para "agentes Linux by Zabbix" y "agentes Windows by Zabbix" en su interfaz Zabbix. Entonces, al registrarse como equipo, desea que se aplique la plantilla adecuada de Linux/Windows en el equipo que se está registrando. De forma predeterminada, sólo se envía el nombre de equipo al servidor en el registro automático, lo que podría no ser suficiente. Para asegúrarse de que se aplique la plantilla adecuada al equipo, debe utilizar los metadatos del equipo. [comment]: # ({/070aaeb4-070aaeb4}) [comment]: # ({b4e3cfcf-9543f562}) **Configuración de la interfaz** Lo primero que debemos hacer es configurar la interfaz. Cree 2 acciones. La primera acción: - Nombre: registro automático de equipo Linux - Condiciones: los metadatos del equipo contienen *Linux* - Operaciones: Vincular a plantillas: Linux ::: noteclassic En este caso, puede omitir la operación "Agregar equipo". Vincular una plantilla a un equipo requiere agregar el equipo primero para que el servidor lo haga automáticamente. ::: La segunda acción: - Nombre: registro automático de equipo de Windows - Condiciones: los metadatos del equipo contienen *Windows* - Operaciones: Vincular a plantillas: Windows [comment]: # ({/b4e3cfcf-9543f562}) [comment]: # ({de29ffee-110dbc2b}) **Configuración del agente** Ahora necesita configurar los agentes. Agregue la siguiente línea al agente Archivos de configuración: HostMetadataItem=system.uname De esta manera se asegura de que los metadatos del equipo contengan "Linux" o "Windows". dependiendo del equipo en el que se esté ejecutando un agente. Un ejemplo de metadatos de equipo en este caso: Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32 No olvide reiniciar el agente después de realizar cualquier cambio en el archivo de configuración. [comment]: # ({/de29ffee-110dbc2b}) [comment]: # ({9b84d838-85f695d6}) ##### Ejemplo 2 ***Paso 1*** Usar metadatos del equipo para permitir cierta protección básica contra equipos no deseados registrándose. [comment]: # ({/9b84d838-85f695d6}) [comment]: # ({c72afba1-c5ffa817}) **Configuración de la interfaz** Cree una acción en la interfaz, utilizando un código secreto difícil de adivinar para rechazar equipos no deseados: - Nombre: Acción de autorregistro Linux - Condiciones: - Tipo de cálculo: AND - Condición (A): Los metadatos del equipo contienen //Linux// - Condición (B): Los metadatos del equipo contienen //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae// - Operaciones: - Enviar mensaje a los usuarios: Administrador a través de todos los medios. - Agregar a grupos de equipos: servidores Linux - Vincular a la plantilla: Linux Tenga en cuenta que este método por sí solo no proporciona una protección sólida porque los datos se transmiten en texto plano. La recarga de la caché de configuración es necesaria para que los cambios tengan un efecto inmediato. [comment]: # ({/c72afba1-c5ffa817}) [comment]: # ({d8213282-9fca761d}) **Configuración del agente** Agregue la siguiente línea al archivo de configuración del agente: HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae donde "Linux" es una plataforma y el resto de la cadena es el Texto secreto difícil de adivinar. No olvide reiniciar el agente después de realizar cualquier cambio en el archivo de configuración. ***Paso 2*** Es posible agregar monitoreo adicional para un equipo ya registrado. [comment]: # ({/d8213282-9fca761d}) [comment]: # ({4e109083-6eb51339}) **Configuración de la interfaz** Actualiza la acción en la interfaz: - Nombre: Acción de autorregistro Linux - Condiciones: - Tipo de cálculo: AND - Condición (A): los metadatos del equipo contienen Linux - Condición (B): los metadatos del equipo contienen 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Operaciones: - Enviar mensaje a los usuarios: Administrador a través de todos los medios. - Vincular a grupos de equipos: servidores Linux - Plantillas de enlaces: Linux - Plantillas de enlaces: MySQL de Zabbix Agent [comment]: # ({/4e109083-6eb51339}) [comment]: # ({03661784-15c86816}) **Configuración del agente** Actualice la siguiente línea en el archivo de configuración del agente: HostMetadata=MySQL en Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae No olvide reiniciar el agente después de realizar cualquier cambio en el archivo de configuración. [comment]: # ({/03661784-15c86816})