Application Real-Time Monitoring Service:Integrar o Open-Falcon ao ARMS

Etapa 1: Criar uma integração do Open-Falcon

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 OpenFalcon.

3. Na página New OpenFalcon Integration, insira o nome da integração, a descrição e 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 limpa o evento automaticamente.

4. Na aba Alert Integration, use a caixa de pesquisa para localizar a integração do Open-Falcon criada e copie o endereço de integração.

Etapa 2: Configurar um modelo de alerta do Open-Falcon

1. Instale e abra o Open-Falcon. Baixe e instale o plug-in no site oficial do Open-Falcon.

2. Na barra de navegação superior, clique em Templates.

3. No canto superior direito da página Templates, insira um nome para o novo modelo de alerta e clique no ícone +.

4. Na página Configure Template, crie uma regra de alerta na seção Policies in the Template. Para mais informações, consulte a documentação do Open-Falcon.

5. Na página de configuração do modelo, defina o callback address como o endereço de integração obtido na Etapa 1 e clique em Save.

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

O Alert Management fornece mapeamentos de campos predefinidos entre a source de alerta do Open-Falcon e o ARMS. Adicione ou modifique os mapeamentos de campos na página Edit Integration conforme necessário.

{
    "name":"cpu alert",
    "endpoint":"test-host",
    "metric":"cpu.user",
    "status":"PROBLEM",
    "step":"1",
    "priority":2,
    "time":"2021-09-08 09:25:00",
    "tpl_id":1,
    "exp_id":2,
    "stra_id":1,
    "tags":""
}

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 source 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 source de alerta não estão mapeados para os campos dos eventos de alerta do ARMS. Os dados enviados aparecem na caixa à esquerda, permitindo selecionar os campos de source ao configurar os mapeamentos.

   • Caso a mensagem Uploaded. seja exibida, o conteúdo do alerta foi 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. Na parte direita da seção Event Mapping, mapeie os campos da source de alerta 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, defina esse nó como raiz. O sistema processa os dados pertencentes ao nó raiz em lotes.

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

      Nota

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

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

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

      • Direto: mapeia o campo especificado da source de alerta diretamente para o campo de alerta correspondente no ARMS.

      • Série: utiliza delimitadores para concatenar vários campos da source de alerta em um único campo e mapeá-lo para o campo de alerta especificado no ARMS. Apenas caracteres especiais são aceitos como delimitadores.

      • Condicional: mapeia os campos da source de alerta para os campos do ARMS somente quando os valores atendem às condições definidas.

      • Tabela de mapeamento: converte a severidade da source de alerta para a severidade do alerta no ARMS. Esta tabela contém exclusivamente 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 usando o método 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 com métricas do Grafana, usada para mapear o gráfico.
      check	Item de verificação do alerta. Exemplos: CPU, JVM, Application Crash e Deployment.
      source	Source do alerta.
      class	Tipo de objeto que aciona o evento de alerta, como host.
      service	Serviço de source do alerta. Exemplo: Login Service.
      startat	Timestamp que indica o horário de início do evento.
      endat	Timestamp que indica o horário de término do evento.
      generatorUrl	URL com os 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 deduplicação. O Alert Management do ARMS permite visualizar uma prévia dos resultados de agrupamento por deduplicação dos dados históricos exibidos na seção Event Mapping. Altere os campos a serem deduplicados conforme necessário.

   Nota

   A configuração de deduplicação aplica-se apenas a eventos não resolvidos.

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

      Quando vários eventos compartilham o mesmo valor para um campo especificado, o sistema os mescla 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 afeta apenas os 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.

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 a integração

No painel de navegação à esquerda, escolha Alert Management > Integrations. Na aba Alert Integration, execute as operações abaixo nas integrações criadas:

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

• Atualizar chave: encontre a integração alvo e escolha More > Update Key na coluna Actions. Clique em Confirm na caixa de diálogo de confirmação.

  Importante

  Após atualizar a chave, atualize também o callback address no modelo de alerta, conforme descrito na Etapa 2: Configurar um modelo de alerta do Open-Falcon.

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

• Ativar ou desativar uma integração: encontre 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: encontre 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, visualize os alertas gerados pela política de notificação configurada. Para mais detalhes, consulte Visualizar histórico de envio de alertas.