Documentation
Table of Contents
2 Autorregistro do agente ativo
Vis?o geral
? poss¨ªvel permitir que um agente ativo do Áú»¢¶Ä²© se auto registre, ap¨®s isso o servidor inicia automaticamente a sua monitora??o. Desta forma os novos hosts poder?o ser adicionados para monitorar sem precisar de configura??o manual no servidor.
O processo de autorregistro pode ocorrer quando um agente at¨¦ ent?o desconhecido requisita a lista de monitora??o a executar.
Esta funcionalidade ¨¦ muito ¨²til para monitorar automaticamente novos n¨®s na nuvem. Assim que um novo n¨® e criado na nuvem o Áú»¢¶Ä²© passa a monitorar automaticamente os dados de performance e disponibilidade do novo host.
O autorregistro de um agente ativo tamb¨¦m suporta a adi??o de hosts monitorados da forma passiva. Quando o agente ativo requisita a lista de verifica??es a executar ele fornece o seu 'ListenIP' e 'ListenPort', conforme estiverem definidos em seu arquivo de configura??o, estes dados s?o enviados ao servidor. (Se existirem v¨¢rios IPs o primeiro ser¨¢ enviado ao servidor.)
No lado do servidor, quando adicionar o novo host autorregistrado, utiliza o IP recebido e porta para configurar o agente. Se n?o for fornecido um endere?o IP ser¨¢ utilizado o ip de origem da conex?o. Se n?o for fornecida uma porta, ser¨¢ utilizada a porta 10050.
Comfigura??o
Definir o servidor
Certifique-se que voc¨º tem o Áú»¢¶Ä²© Server identificado no arquivo de configura??o do agente - zabbix_agentd.conf
Se voc¨º n?o tiver especificado o par?metro Hostname no zabbix_agentd.conf, o nome de sistema do agente ser¨¢ utilizado pelo servidor para nomear o host. O nome do sistema no linux pode ser obtido atrav¨¦s do comando 'hostname'.
Reinicie o agente ap¨®s modificar o seu arquivo de configura??o.
A??o para um registro de agente ativo
Quando um servidor recebe uma requisi??o de autorregistro ele chamar¨¢ uma a??o. Uma a??o com origem de evento em "autorregistro" precisa ser configurada para permitir o autorregistro.
Configurar uma regra de descoberta de rede n?o ¨¦ obrigat¨®ria para ter o autorregistro de agentes ativos.
Na interface web, acesse Configura??o ¡ú A??es, selecione Autorregistro como origem do evento e clique no bot?o Criar a??o:
- Na aba A??o, informe um nome para a a??o
- Na aba Condi??es defina quais condi??es ser?o necess¨¢rias para o autorregistro (opcional). Se voc¨º utilizar uma condi??o baseada nos metadados do host, consulte a se??o a seguir.
- Na aba Opera??es adicione as opera??es necess¨¢rias (por exemplo, 'Adicionar host', 'Adicionar host a grupo' (por exemplo, Discovered hosts), 'associar com templates', etc.
Se os hosts se registraram automaticamente, ent?o provavelmente eles suportam a monitora??o ativa (muito ¨²til para hosts que est?o em subredes protegidas - DMZs) e pode ser necess¨¢rio o uso de um template espec¨ªfico para monitora??o ativa como o Template_Linux-active.
Usando o metadado do host
Quando um agente envia um pedido de autorregistro ao servidor ele envia junto o seu 'hostname'. Em alguns casos (por exemplos n¨®s na nuvem da Amazon) apenas o 'hostname' n?o ser¨¢ suficiente para o Áú»¢¶Ä²© Server diferenciar os hosts descoebrtos. O metadado do hotst poder¨¢ conter opcionalmente outras informa??es para identificar o agente junto ao servidor.
O metadado do host ¨¦ configurado do lado do agente no seu arquivo de configura??o - zabbix_agentd.conf. Existem dois par?metros que podem ser utilizados para definir o metadado do host:
Veja a descri??o de ambos no link abaixo.
<note:important>Uma tentativa de autorregistro ir¨¢ ocorrer toda vez que um agente ativo enviar uma solicita??o de atualiza??o da lista de itens a monitorar. O intervalo entre as requisi??es da lista de itens a monitorar ¨¦ definida pelo par?metro RefreshActiveChecks no arquivo de configura??o do agente. A primeira requisi??o ¨¦ feita imediatamente ap¨®s o agente ser carregado. :::
Exemplo 1
Usando o metadado para dinstinguir hosts Linux e Windows.
Digamos que voc¨º queira que os hosts se autorregistrem no Áú»¢¶Ä²© Server. Voc¨º tem agentes ativos (consulte a se??o de "Configura??o" acima) na sua rede. Existem servidores com sistema operacional Windows e Linux e voc¨º possui um template para monitorar cada um deles ( "Template OS Linux" e "Template OS Windows"). Logo o registro de um host dever¨¢ ser compat¨ªvel com o template de monitora??o a ser utilizado. Por padr?o apenas o nome do host ser¨¢ enviado para o Áú»¢¶Ä²© Server durante o processo de autorregistro, mas para que seja poss¨ªvel a configura??o do tempalte correto ser¨¢ necess¨¢rio tamb¨¦m que o metadado seja enviado.
Configura??o do agente
A primeira coisa a fazer ¨¦ configurar os agentes, adicione a linha a seguir em seus arquivos de configura??o:
Desta forma voc¨º ter¨¢ certeza que o metadado do host contenha "Linux" ou "Windows", dependendo de seu sistema operacional. Um exemplo de metadado de host neste 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-32N?o esque?a de reiniciar o agente ap¨®s alterar sua configura??o e antes de testar os valores.
Configura??o na interface web
Agora ser¨¢ necess¨¢rio configurar a interface web. Crie duas a??es, a primeira::
- Nome: Linux host autoregistration
- Condi??es: Metadado do host como Linux
- Opera??es: Associar aos templates: Template OS Linux
Voc¨º pode ignorar a opera??o de "Adicionar host" neste caso pois a tarefa de "Associar host a template" ir¨¢ fazer isso automaticamente.
A segunda a??o:
- Nome: Windows host autoregistration
- Condi??es: Metadado do host como Windows
- Opera??es: Associar aos templates: Template OS Windows
Exemplo 2
Utilizando o metadado do host para evitar que hosts indesejados sejam registrados.
Configura??o do agente
Adicione a linha a seguir no arquivo de configura??o do agente:
Com esta descri??o queremos indicar que o sistema operacional ¨¦ o "Linux" e o resto do texto ¨¦ uma chave secreta.
N?o esque?a de reiniciar o agente ap¨®s alterar seu arquivo de configura??o.
Configura??o na interface web
Crie uma a??o na interface web, usando uma condi??o que verifique se a chave secreta est¨¢ presente no metadado do host:
- Name: Auto registration action Linux
- Condi??es:
* Tipo do c¨¢lculo: E
* Condi??o (A): Metadado do host como //Linux//
* Condi??o (B): Metadado do host como //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae//
* Opera??es:
* Enviar mensagem para os usu¨¢rios: Admin atrav¨¦s de todas as m¨ªdias
* Adicionar hosts aos grupos: Linux servers
* Associar com templates: Template OS LinuxObserve que este m¨¦todo sozinho n?o prov¨º forte prote??o pois os dados s?o transmitidos em texto plano.
Frontend configuration
Create an action in the frontend, using some hard-to-guess secret code to disallow unwanted hosts:
- Name: Autoregistration action Linux
- Conditions:
* Type of calculation: AND
* Condition (A): Host metadata contains //Linux//
* Condition (B): Host metadata contains //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae//
* Operations:
* Send message to users: Admin via all media
* Add to host groups: Linux servers
* Link to templates: Template OS LinuxPlease note that this method alone does not provide strong protection because data is transmitted in plain text. Configuration cache reload is required for changes to have an immediate effect.
Agent configuration
Add the next line to the agent configuration file:
where "Linux" is a platform, and the rest of the string is the hard-to-guess secret text.
Do not forget to restart the agent after making any changes to the configuration file.
Step 2
It is possible to add additional monitoring for an already registered host.
Frontend configuration
Update the action in the frontend:
- Name: Autoregistration action Linux
- Conditions:
* Type of calculation: AND
* Condition (A): Host metadata contains Linux
* Condition (B): Host metadata contains 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
* Operations:
* Send message to users: Admin via all media
* Add to host groups: Linux servers
* Link to templates: Template OS Linux
* Link to templates: Template DB MySQLAgent configuration
Update the next line in the agent configuration file:
Do not forget to restart the agent after making any changes to the configuration file.