Alertas

Configure receptores de alertas no Automation Suite para evitar tempo de inatividade usando uipathctl.

Você deve configurar receptores de alertas para evitar problemas que possam levar a tempo de inatividade.

Configuração de alertas

Observação:

Você pode encontrar uipathctl na pasta de instalação do Automation Suite: .../UiPathAutomationSuite/UiPath_Installer/bin.

Antes de começar a configurar alertas, certifique-se de habilitar o kubectl.

Como adicionar um receptor de email

Para adicionar uma nova configuração de e-mail após uma instalação, execute o seguinte comando:

./uipathctl config alerts add-email \
  --name test \
  --to "[e-mail]" \
  --from "[e-mail]" \
  --smtp server.mycompany.com \
  --username admin \
  --password somesecret \
  --require-tls \
  --ca-file <path_to_ca_file> \
  --cert-file <path_to_cert_file> \
  --key-file <path_to_key_file> \
  --send-resolved

Para enviar notificações por email para vários destinatários, você pode criar múltiplos destinatários de email. A tabela a seguir descreve os sinalizadores, seus valores esperados e exemplos para configurar um receptor de email.

Bandeira	Valor	Exemplo
name	O nome da configuração de e-mail	testconfig
to	O endereço de e-mail do destinatário	[e-mail]
from	O endereço de e-mail do usuário	[e-mail]
SMTP	URL do servidor SMTP ou endereço IP e número da porta	server.mycompany.com:567
username	Nome de usuário de autenticação	admin
password	Senha de autenticação	securepassword
require-tls	Sinalizador booleano que indica que o TLS está habilitado no servidor SMTP.	N/A
ca-file	Caminho do arquivo contendo o Certificado CA do servidor SMTP. Isso é opcional se a CA for privada.	./ca-file.crt
cert-file	Caminho do arquivo contendo o certificado do servidor SMTP. Isso é opcional se o certificado for privado.	./cert-file.crt
key-file	Caminho do arquivo contendo a chave privada do certificado do servidor SMTP. Isso é necessário se o certificado for privado.	./key-file.crt
send-resolved	Sinalizador booleano para enviar um e-mail assim que o alerta for resolvido.	N/A

Como remover um receptor de email

Para remover uma configuração de e-mail, você deve executar o seguinte comando. Certifique-se de inserir o nome da configuração de e-mail que deseja remover.

./uipathctl config alerts remove-email --name test

Atualização de um receptor de email

Para atualizar uma configuração de e-mail, você deve executar o seguinte comando. Certifique-se de inserir o nome da configuração de e-mail que deseja atualizar e os parâmetros opcionais adicionais a serem editados. Esses parâmetros são os mesmos para adicionar uma nova configuração de e-mail. Você pode inserir um ou mais sinalizadores ao mesmo tempo.

./uipathctl config alerts update-email --name test [additional_flags]

Adição de webhooks para enviar alertas para ferramentas externas

As configurações do Alert Manager são armazenadas em um segredo no formato codificado Base64. Para atualizar o segredo, siga as seguintes etapas:

1. Obtenha a configuração existente do Alert Manager em um arquivo chamado am_config.yaml.

   kubectl get secret alertmanager-config -n monitoring -o jsonpath="{.data.alertmanager\.yaml}" | base64 --decode > am_config.yaml
   

2. Configure webhooks. Para obter detalhes, consulte Configuração do webhook do Alert Manager.

3. Codifique a configuração para o formato Base64.

   openssl base64 -in am_config.yaml -out am_config_base64.yaml
   

4. Atualize o atributo alertmanager.yaml no segredo. Substitua a string codificada de Base64 existente por aquela em am_config_base64.yaml.

5. Verifique se as configurações estão atualizadas na seção de status no Alert Manager.

Para solucionar problemas, consulte os logs dos pods do Alert Manager e do Prometheus.

Teste de alertas

Para testar os alertas, siga as seguintes etapas:

1. Faça login no Alert Manager acessando https://monitoring.fqdn/alertmanager.

2. Copie o cookie _oauth2_proxy=<value>.

3. Crie um alerta de teste por meio do Postman, conforme mostrado no exemplo a seguir:

   Method: Post
   URL: https://monitoring.fqdn/alertmanager/api/v2/alerts
   Headers: 
   - Content-Type: application/json
   - Cookie: _oauth2_proxy=<value>
   Body: [{"labels":{"alertname":"Acme Alert", "severity":"warning"}}]
   

4. Você agora deve ver o alerta no Alert Manager.

Verificando alertas atualmente sendo disparados

Para visualizar os alertas, navegue até o Prometheus usando https://monitoring.fqdn/metrics e selecione a guia Alertas. Aqui é possível ver todos os alertas configurados no Automation Suite.

• Para exibir os alertas ativos, filtre o status do alerta usando a caixa de seleção Disparando.

• Para obter mais detalhes sobre determinados alertas, expanda os alertas que deseja visualizar.

  

Silenciamento dos alertas

Se os alertas forem muito ruidosos, você poderá silenciá-los. Para isso, siga as seguintes etapas:

1. Acesse o Alert Manager usando https://monitoring.fqdn/alertmanager.
2. Encontre o alerta em questão e selecione Silenciar.
3. Preencha os detalhes de Criador e Comentário e selecione Criar. O alerta não deve mais ser mostrado no Painel de monitoramento ou ser relatado para qualquer um dos receptores configurados.

Alertas de solução de problemas

Se você tiver problemas com a configuração do receptor do alerta, verifique os logs executando o seguinte comando:

kubectl logs -n monitoring -l app.kubernetes.io/name=kube-prometheus-stack-prometheus-operator --tail=-1