Application Real-Time Monitoring Service:Integrar alertas do Simple Log Service

Contexto

O Gerenciamento de Alertas integra-se ao Simple Log Service por meio de webhooks, permitindo o gerenciamento centralizado de alertas.

Crie uma integração do Simple Log Service

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

2. Na página Integrations, clique em na aba Alert Integration e, em seguida, clique em Log Service.

3. Na caixa de diálogo, insira um nome e uma descrição para a integração e especifique o tempo limite de recuperação automática dos eventos de alerta.

   Nota

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

4. Na seção Projects Enabling Alert Events, em All Projects, são exibidos todos os seus projetos do Simple Log Service. Selecione os projetos cujos alertas deseja integrar, clique em no ícone e clique em Save.

   Nota

   Esse recurso itera automaticamente por todas as regras de alerta configuradas nos projetos selecionados e adiciona a URL de solicitação de alertas como https://alerts.aliyuncs.com/api/v1/events/{{token}}. A variável {{token}} é uma chave gerada automaticamente durante a criação da integração.

   Após concluir a configuração, visualize a integração do Simple Log Service criada na aba Alert Integration. Um registro chamado Simple Log Service Integration aparece na lista de integrações com status Enabled e atividade Ready. Clique em Copy ao lado do endereço da integração para copiar o endereço da chave de integração. A coluna Actions permite operações como Edit, Delete e Disable.

Integrar regras de alerta específicas do Simple Log Service

1. Na página Integrations, na aba Alert Integration, copie a URL da integração alvo do Simple Log Service.

2. Faça login no console do Simple Log Service.

3. Na área Project, clique em no projeto alvo. No painel de navegação à esquerda, clique em no ícone de alerta .

4. Na página Alert Center, escolha Notification Objects > Webhook Integration. Na página Webhook Integration, clique em Create .

5. Na caixa de diálogo exibida, adicione o webhook geral para o Gerenciamento de Alertas do ARMS definindo o nome como ARMS Alert Management, selecionando General Webhook como tipo e configurando os demais parâmetros conforme solicitado na interface.

6. Na página Alert Center, escolha Notification Policies > Content Template. Na coluna Actions do modelo alvo, clique em Modify. Na caixa de diálogo exibida, clique em na aba WebHook-Custom, configure o conteúdo da mensagem e clique em Confirm.

   {
   "uid": "{{ alert.aliuid }}",
   "project": "{{ alert.project }}(https://sls.console.alibabacloud.com/#/project/{{ alert.project }}/categoryList)",
   "trigger": "{{ alert.alert_name }}",
   "condition": "{{ alert.condition }}",
   "context": {{ alert.results[0].raw_results | to_json | quote }},
   "message": " [Uid] {{ alert.aliuid }}\n\n> [Project] [{{ alert.project }}](https://sls.console.alibabacloud.com/#/project/{{alert.project }}/categoryList)\n\n> [Trigger] {{ alert.alert_name }}\n\n> [Condition] {{ alert.alert_name }}\n\n> [Message] Notification content\n\n> [Context] {{ alert.results[0].raw_results | to_json | quote | removeprefix('"') | removesuffix('"') }}\n\n> [View details]({{ alert.query_url }})"
   }

7. Na página Alert Center, clique em na aba Alert rules. Na coluna Actions da regra alvo, clique em Edit. Na caixa de diálogo exibida, expanda Advanced Settings. Na seção Output Target, selecione SLS Notification. Na seção Alert Policy, selecione Simple Mode. Configure o canal de notificação para o webhook universal conforme solicitado e clique em OK.

Edite uma integração

O Gerenciamento de Alertas fornece mapeamentos de campos predefinidos entre a source de alerta do Simple Log Service e o Gerenciamento de Alertas. Também é possível adicionar ou modificar os mapeamentos de campos na página Edit Integration conforme necessário.

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 de 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 origem ao configurar os mapeamentos.

   • Se a mensagem Uploaded. aparecer, o conteúdo do alerta será reportado à página Histórico de Eventos de Alerta. 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 em nos registros de dados para os quais deseja configurar mapeamentos e visualize os detalhes.

6. Na parte direita da seção Event Mapping, configure os mapeamentos de campos entre a source de alerta e o 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 nó raiz. Os dados pertencentes ao nó raiz serão processados em lotes.

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

      Nota

      Se existirem vários nós de array nos dados de alerta, selecione apenas um deles para processamento em lote.

   2. Opcional:Selecione Configure Alert Recovery Events e configure as condições de campo para limpar alertas.

      Ao receber eventos, o ARMS busca alertas que contenham valores de campo especificados e os limpa. O campo especificado para limpar alertas deve ser equivalente à severidade do alerta no evento. Não é possível usar o campo $.severity para essa finalidade. Por exemplo, se o campo especificado for {$.eventType ="resolved"}, o sistema limpará automaticamente todos os alertas cujo valor de eventType seja resolved na integração.

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

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

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

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

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

      • Tabela de mapeamento: a severidade da source de alerta é mapeada para a severidade do alerta do ARMS. A tabela 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. O método de mapeamento deve ser definido como Direto.
      message	Descrição do alerta. Utilizada como conteúdo da mensagem de alerta. Não pode exceder 15.000 caracteres.
      value	Valor de amostra de uma métrica.
      imageUrl	URL do gráfico de linhas que contém métricas do Grafana. Usada para mapear o gráfico de linhas.
      check	Item de verificação do alerta. Exemplos: CPU, JVM, Falha de Aplicativo 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 deduplicação. O Gerenciamento de Alertas do ARMS permite visualizar os resultados de agrupamento por deduplicação de 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 não limpos.

   1. Na seção Event Deduplication da página Integration Details, selecione os campos 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 definir as configurações, clique em Save.

Visualize 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 em no nome do evento de alerta para visualizar seus detalhes. Para mais informações, consulte Visualizar histórico de eventos de alerta.

Adicionar projetos à integração

Para adicionar alertas de novos projetos a uma integração existente do Simple Log Service, siga estas etapas:

1. Na página Integrations, localize a integração alvo do Simple Log Service e escolha More > Select Service na coluna Actions.

2. Na caixa de diálogo exibida, selecione os projetos dos quais deseja receber alertas, clique em no ícone e clique em Save.

Gerencie integrações

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

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

• Atualize chave: para modificar a chave de uma integração, selecione More > Update Key na coluna Actions da integração alvo e clique em Confirm na caixa de diálogo exibida.

  Importante

  Após atualizar a chave, adicione novamente o alerta de projeto do Simple Log Service. Para mais informações, consulte Adicionar um produto.

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

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

• Exclua 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.

• Crie uma política de notificação: localize a integração para a qual deseja criar uma política de notificação 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 eventos de alerta 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 com base na política de notificação configurada. Para mais informações, consulte Visualizar histórico de envio de alertas.