Áú»¢¶Ä²©

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

ServerActive=10.0.0.1

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:

HostMetadata
       HostMetadataItem

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:

HostMetadataItem=system.uname

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-32

N?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:

HostMetadata: Linux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae

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 Linux

Observe que este m¨¦todo sozinho n?o prov¨º forte prote??o pois os dados s?o transmitidos em texto plano.