Application Real-Time Monitoring Service:Integrar o Zabbix

Pré-requisitos

Apenas a versão 5.x do Zabbix é compatível.

Etapa 1: Criar uma integração do Zabbix

1. Faça login no console do ARMS. No painel de navegação à esquerda, escolha Alert Management > Integrations.

2. Na aba Alert Integration, clique em Zabbix.

3. No assistente Create Zabbix Integration, insira um nome e uma descrição para a integração, especifique o tempo de recuperação automática e clique em Save.

   Nota

   Tempo de recuperação automática após timeout: se um evento de alerta não for acionado novamente dentro do período especificado, o sistema limpará o evento automaticamente.

4. Na aba Alert Integration, pesquise a integração do Zabbix criada e copie a URL da integração.

Etapa 2: Configurar o Zabbix

1. Faça login no servidor onde o Zabbix está implantado e execute o comando a seguir para localizar o caminho dos scripts do Zabbix:

   cat /etc/zabbix/zabbix_server.conf | grep alert

   Resposta de exemplo:

   [root@localhost ~]# cat /etc/zabbix/zabbix_server.conf | grep alert
   #       Number of pre-forked instances of alerters.
   #       Full path to location of custom alert scripts.
   # AlertScriptsPath=${datadir}/zabbix/alertscripts
   AlertScriptsPath=/usr/lib/zabbix/alertscripts
   [root@localhost ~]#

2. Execute o comando cd para acessar o caminho dos scripts do Zabbix.

3. Execute o comando a seguir para baixar o pacote de instalação do gerenciamento de alertas do ARMS.

   wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz

4. Execute o comando a seguir para descompactar o pacote de instalação.

   tar -xzvf aliyunalertmanager.tgz

5. Acesse o diretório bin do pacote de instalação.

   cd aliyunalertmanager/bin

6. Execute o comando a seguir para instalar o gerenciamento de alertas do ARMS.

   sh install.sh <integration_url>

   Substitua <integration_url> pela URL de integração obtida na Etapa 1.

7. Durante a instalação, insira a URL de gerenciamento do Zabbix, o nome de usuário do administrador e a senha conforme solicitado.

(Opcional) Etapa 3: Editar a integração

O gerenciamento de alertas do ARMS inclui mapeamentos de campos padrão da fonte de alertas do Zabbix para os alertas do ARMS. Também é possível adicionar ou modificar os mapeamentos na página Edit Integration conforme necessário.

Exemplo de fonte de alerta:

{
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Used space in Zabbix server value is 81 GB, triggered an alarm disk usage trigger",
    "hostname":"Zabbix server",
    "ip":"127.0.0.1",
    "severity":"Warning",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Used space",
    "alertname":"disk usage trigger",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}

1. Na aba Alert Integration, localize a integração que deseja gerenciar e clique em Edit na coluna Actions.

2. Na seção Event Mapping, clique em Send Test Data.

3. Na caixa de diálogo Send Test Data, insira o conteúdo do alerta de uma fonte de alerta de terceiros no formato JSON e clique em Send.

   Nota

   • Se a mensagem Uploaded. No events are generated. Configure mappings based on the original data. aparecer, significa que os campos da fonte de alerta não estão mapeados para os campos dos eventos de alerta do ARMS. Os dados enviados são exibidos na caixa à esquerda, permitindo selecionar os campos de origem ao configurar os mapeamentos.

   • Caso a mensagem Uploaded. apareça, o conteúdo do alerta será reportado à página Alert Event History. Para mais informações, consulte Visualizar histórico de eventos de alerta.

4. Na caixa de diálogo Send Test Data, clique em Disable.

5. Na parte esquerda da seção Event Mapping, clique nos registros de dados para os quais deseja configurar mapeamentos e visualize os detalhes.

6. No painel direito da seção Event Mapping, mapeie os campos de origem para os campos de alerta do ARMS.

   1. Opcional:Na seção Select Root Node, especifique se deseja ativar o processamento em lote.

      Se existir um nó de array nos dados de alerta, você poderá especificá-lo como o nó raiz. Os dados pertencentes a esse nó raiz serão processados em lotes.

      Após selecionar Use Batch Processing, selecione o nó de array a ser processado em lote como o nó raiz.

      Nota

      Se houver múltiplos nós de array nos dados de alerta, apenas um deles poderá ser selecionado para processamento em lote.

   2. Na seção Map Source Fields to Target Fields, mapeie os campos da fonte de alerta para os campos de alerta do ARMS.

      Clique no ícone de mapeamento para alterar o método de mapeamento de campos.

      • Direto: o campo especificado da fonte de alerta é mapeado diretamente para o campo de alerta especificado do ARMS.

      • Série: utilize delimitadores para concatenar vários campos da fonte de alerta em um único campo e, em seguida, mapeie esse campo para o campo de alerta especificado do ARMS. Apenas caracteres especiais podem ser usados como delimitadores.

      • Condicional: os campos especificados da fonte de alerta são mapeados para os campos de alerta do ARMS somente quando os valores dos campos atendem às condições definidas.

      • Tabela de mapeamento: a severidade da fonte de alerta é mapeada para a severidade do alerta do ARMS. A tabela de mapeamento contém apenas o campo de severidade.

      A tabela a seguir descreve os campos de alerta do ARMS.

      Campo de alerta	Descrição
      alertname	Nome do alerta personalizado.
      severity	Nível de severidade do alerta. É obrigatório configurar mapeamentos para este campo, e o método deve ser definido como Direto.
      message	Descrição do alerta, utilizada como conteúdo da mensagem. O limite é de 15.000 caracteres.
      value	Valor de amostra de uma métrica.
      imageUrl	URL do gráfico de linhas contendo métricas do Grafana, usada para mapear o gráfico.
      check	Item de verificação do alerta. Exemplos: CPU, JVM, Falha na Aplicação e Implantação.
      source	Origem do alerta.
      class	Tipo de objeto que aciona o evento de alerta, por exemplo, host.
      service	Serviço de origem do alerta. Exemplo: Login Service.
      startat	Timestamp que representa a hora de início do evento.
      endat	Timestamp que representa a hora de término do evento.
      generatorUrl	URL dos detalhes do evento.

7. Configure a deduplicação de campos para eventos de alerta.

   Para reduzir dados duplicados, o sistema utiliza campos relevantes como base para a deduplicação. O Gerenciamento de Alertas do ARMS permite visualizar os resultados de agrupamento por deduplicação dos dados históricos de eventos exibidos na seção Event Mapping. É possível alterar os campos a serem deduplicados.

   Nota

   A deduplicação só pode ser configurada para eventos que não foram limpos.

   1. Na seção Event Deduplication da página Integration Details, selecione os campos a serem usados para deduplicação.

      Se vários eventos tiverem o mesmo valor para um campo especificado, eles serão mesclados em uma única notificação de alerta.

   2. Clique em Deduplication Test para visualizar o grupo de alertas após a deduplicação.

      Nota

      O teste de deduplicação aplica-se apenas aos 10 registros de dados mais recentes carregados na parte esquerda da seção Event Mapping.

8. Após concluir as configurações, clique em Save.

Verificar a integração

Siga as etapas abaixo para verificar se o gerenciamento de alertas do ARMS foi instalado com sucesso.

1. Faça login no console do Zabbix.

2. Na barra de menu superior, escolha Manage > Users.

   Na página Users, verifique se o Aliyun Alert User foi criado, se o tipo de usuário é Zabbix Super Admin, se o grupo de usuários é Aliyun Alert Group e se o status é Enabled.

3. Na barra de menu superior, escolha Manage > User groups.

   Na página User groups, verifique se existe um grupo de usuários chamado Aliyun Alert Group, se ele inclui o Aliyun Alert User como membro e se está Enabled.

4. Na barra de menu superior, escolha Manage > Media types.

   Na página Media types, verifique se existe um tipo de mídia chamado Aliyun Alert Media, se seu tipo é Script, se o status é Enabled e se o nome do script é aliyunalertmanager/bin/alert.sh.

5. Na barra de menu superior, escolha Configurations > Action.

   Na página Action, verifique se uma ação chamada Aliyun Alert Action foi criada, se seu status é Enabled e se sua operação envia mensagens ao Aliyun Alert User por meio de todas as mídias.

   Nota

   Você pode personalizar o conteúdo do alerta reportado na ação Aliyun Alert Action conforme suas necessidades.

Visualizar detalhes de um evento de alerta

1. No painel de navegação à esquerda do console do ARMS, escolha Alert Management > Alert Event History.

2. Na página Alert Event History, clique no nome do evento de alerta para visualizar seus detalhes. Para mais informações, consulte Visualizar histórico de eventos de alerta.

Gerenciar integrações

No painel de navegação à esquerda, escolha Alert Management > Integrations. Na aba Alert Integration, é possível realizar as seguintes operações nas integrações criadas:

• Visualizar detalhes de uma integração: localize a integração e clique na linha correspondente. Na página Integration Details, visualize as informações detalhadas.

• Atualizar chave: para atualizar a chave de uma integração, localize-a, escolha More > Update Key na coluna Actions e clique em Confirm na caixa de diálogo exibida.

  Importante

  Após atualizar a chave, reinstale o gerenciamento de alertas do ARMS seguindo as instruções na Etapa 2.

• Modificar uma integração: localize a integração e clique em Edit na coluna Actions. Na página Integration Details, altere as informações desejadas e clique em Save.

• Ativar ou desativar uma integração: localize a integração e clique em Disable ou Enable na coluna Actions.

• Excluir uma integração: localize a integração e clique em Delete na coluna Actions. Na mensagem exibida, clique em OK.

• Adicionar um fluxo de processamento de eventos a uma integração: localize a integração e clique em Add Event Processing Flow na coluna Actions. Para mais informações, consulte Fluxo de processamento de eventos.

• Criar uma política de notificação: localize a integração para a qual deseja criar a política e clique em More na coluna Actions. Na lista exibida, clique em Create Notification Policy. Para mais informações, consulte Políticas de notificação.

Próximos passos

Após criar uma política de notificação, o sistema gera alertas e envia notificações para os eventos reportados com base na política configurada. Para mais informações, consulte Políticas de notificação. Na página Alert Sending History, é possível visualizar os alertas gerados com base na política de notificação configurada. Para mais detalhes, consulte Visualizar histórico de envio de alertas.