Uso da pilha de monitoramento

Monitore o Automation Suite usando o Prometheus, Grafana e Alert Manager no EKS/AKS.

A pilha de monitoramento dos clusters do Automation Suite inclui o Prometheus, Grafana e AlertManager, que são instalados automaticamente, a menos que você escolha trazer sua própria pilha de monitoramento.

Esta página descreve uma série de cenários de monitoramento otimizados para funcionar com a ferramenta de monitoramento, que é agrupada com o cluster do Automation Suite . Se você optar por trazer sua própria pilha de monitoramento, certifique-se de seguir a documentação oficial de suas ferramentas para monitorar a integridade do cluster.

Importante:

Ao usar coletores para exportar métricas para ferramentas de terceiros, habilitar o monitoramento de aplicativos pode interromper a funcionalidade do Automation Suite.

Acessando as ferramentas de monitoramento

Visão geral

A pilha de monitoramento dos clusters do Automation Suite inclui o Prometheus, Grafana e Alert Manager.

Você pode acessar as ferramentas de monitoramento do Automation Suite individualmente usando os seguintes URLs:

Aplicativo	Ferramenta	URL	Exemplo
Métricas	Prometheus	https://monitoring.fqdn/metrics	https://monitoring.automationsuite.mycompany.com/metrics
Painel	Grafana	https://monitoring.fqdn/grafana	https://monitoring.automationsuite.mycompany.com/grafana
Gerenciamento de alertas	AlertManager	https://monitoring.fqdn/alertmanager	https://monitoring.automationsuite.mycompany.com/alertmanager

Autenticação da ferramenta de monitoramento

Para acessar as ferramentas de monitoramento pela primeira vez, siga as instruções em Acesso ao Automation Suite.

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.

  A imagem a seguir mostra a guia Alertas do Prometheus com alertas acionados no momento.

  

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.

Configurando os alertas

Observação:

Before starting configuring the alerts, make sure to enable kubectl.

Adicionando uma nova configuração de e-mail

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 \
  --ASEA

A tabela a seguir descreve os sinalizadores disponíveis para o comando add-email .

Bandeira	Description	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
ASEA	Sinalizador booleano para indicar que você instalou o Automation Suite no EKS ou AKS.	N/A

Removendo uma configuração de e-mail

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

Atualizando uma configuração de e-mail

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 --ASEA [additional_flags]

Acesso ao painel do Grafana

Para acessar os painéis do Grafana, você deve recuperar suas credenciais e usá-las para fazer login:

• Nome de usuário:

  kubectl -n monitoring get secrets/grafana-creds -o "jsonpath={.data.admin-user}" | base64 -d; echo
  

• Senha:

  kubectl -n monitoring get secrets/grafana-creds -o "jsonpath={.data.admin-password}" | base64 -d; echo
  

Monitoramento de volumes persistentes

Você pode monitorar volumes persistentes por meio do painel do Kubernetes/Volumes persistentes. Você pode rastrear o espaço livre e utilizado para cada volume.

A imagem a seguir mostra o painel Volumes persistentes do Kubernetes.

Você também pode verificar o status de cada volume selecionando o item Volumes persistentes dentro do menu Armazenamento do Cluster Explorer.

Monitoramento da utilização de hardware

Para verificar a utilização do hardware por nó, você pode usar o painel Nó/exportador/nó . Os dados sobre a CPU, memória, disco e rede estão disponíveis.

Você pode monitorar a utilização do hardware para cargas de trabalho específicas usando o painel do Kubernetes/Compute Resources/Namespace (Workloads). Selecione o namespace uipath para obter os dados necessários.

Criação de um instantâneo visual compartilhável de um gráfico do Grafana

1. Selecione o botão de menu ao lado do título do gráfico e, em seguida, selecione Compartilhar.
2. Selecione a guia Instantâneo e defina o Nome do instantâneo e Expiração.
3. Selecione Publicar para snapshot.raintank.io.

Para obter detalhes, consulte a documentação do Grafana sobre painéis de compartilhamento.

Observação:

Esse instantâneo é visualizável na internet pública por qualquer pessoa com o link.

Criação de painéis persistentes personalizados do Grafana

Observação:

Os painéis criados diretamente na interface gráfica do Grafana não são persistidos em reinicializações de pods ou nós. Painéis pré-criados não são afetados porque são armazenados como ConfigMaps no monitoring .

Para criar um painel personalizado persistente, siga as seguintes etapas:

1. Crie seu painel no Grafana. Para obter instruções, consulte a documentação do Grafana.
2. Exporte o painel como um arquivo JSON.
3. Salve a seguinte configuração do ConfigMap como um arquivo YAML, substituindo <dashboard-name> por um nome exclusivo e <dashboard-json> pelo conteúdo do seu arquivo JSON exportado:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <dashboard-name>
     namespace: monitoring
     labels:
       grafana_dashboard: "1"
   data:
     dashboard.json: |
       <dashboard-json>
   

4. Aplique o ConfigMap:

   kubectl apply -f <file_name.yaml>
   

O Grafana importa o painel automaticamente após você aplicar o ConfigMap.

Monitoramento Temporal como um Serviço (TaaS)

Os pods do servidor TaaS expõem as métricas do Prometheus. Se o Prometheus estiver habilitado em seu cluster, as métricas serão extraídas automaticamente dos pods taas-temporal-* .

A tabela a seguir lista as principais métricas para monitorar a integridade e o desempenho do TaaS.

Métrica	Description
temporal_activity_schedule_to_start_latency_bucket	Tempo entre uma atividade que está sendo agendada e um funcionário selecionando-a. Valores altos indicam que os trabalhadores não podem processar tarefas com rapidez suficiente.
temporal_workflow_task_schedule_to_start_latency_bucket	Tempo entre uma tarefa de fluxo de trabalho ser agendada e um trabalhador iniciá-la. Valores altos indicam lista de pendências de filas.
temporal_workflow_completed	Contagem de execuções de fluxo de trabalho concluídas com sucesso.
temporal_workflow_failed	Contagem de execuções de fluxos de trabalho com falha.
temporal_num_pollers	Número de pesquisadors de trabalho ativos atualmente, divididos por tipo de pesquisador.
temporal_request_latency_bucket	Latência de solicitações gRPC do cliente para o front-end do TaaS.

Acessando a IU Temporal

A UI da Web Temporal não está exposta fora do cluster por padrão. Para acessá-la para fins de diagnóstico, encaminhe a porta para a implantação:

kubectl port-forward -n uipath deployment/taas-temporal-web 8008:8008

Abra http://localhost:8008 em um navegador. Não é necessário fazer login ao acessar via encaminhamento de porta.

A Interface Gráfica Temporal permite inspecionar execuções de fluxos de trabalho individuais, visualizar o histórico de execuções e identificar atividades com falha ou expiradas.

Métricas disponíveis

Você pode pesquisar as métricas disponíveis na interface do Prometheus.

A documentação sobre as métricas disponíveis está aqui:

• https://github.com/prometheus/node_exporter#enabled-by-default - Conecte-se para visualizar
• https://github.com/kubernetes/kube-state-metrics/tree/master/docs#exposed-metrics - Conecte-se para visualizar
• Consulta de métricas do Prometheus (Istio)