Operar
Alertas
Cada agent vigia o seu próprio host e diz ao dashboard quando um recurso fica sobreaquecido ou um agent fica em silêncio. Defines os limiares; o ConnXL levanta, escala e resolve os alertas e pode enviá-los para o Slack, Teams, Discord ou o teu próprio webhook.
6 min de leitura
O que é monitorizado
Cada instância de agent reporta a saúde do seu host — CPU, memória e disco. Cada métrica tem dois limiares:
- Aviso — por omissão
85%. O recurso está a ficar apertado. - Crítico — por omissão
95%. Age agora.
Altera-os por agent a partir do cartão de limiares na página de runtime do agent, ou desativa uma métrica que não te interessa. Os limiares são avaliados no agent com um pouco de histerese, para que um alerta não oscile quando um valor paira mesmo em cima da linha, e uma nova definição aplica-se ao vivo pelo canal de configuração — sem reinício.
O ciclo de vida do alerta
- Levantado — uma métrica cruza o seu limiar de aviso. Aparece no banner de alerta do agent, na coluna de saúde e no sino da barra de topo.
- Escalado — um alerta de nível aviso cruza o crítico.
- Resolvido — a métrica volta a descer abaixo do aviso. O alerta fecha-se por si próprio.
- Agent offline — se um agent parar de enviar batimentos por mais de 10 minutos é marcado como offline; limpa-se automaticamente no momento em que o agent volta a ligar-se.
Canais de notificação
Os alertas vivem no dashboard por omissão. Para os teres enviados para algum lado, adiciona um canal de notificação sob os webhooks da tua organização. São suportados cinco tipos — slack, teams, discord, custom (qualquer endpoint HTTPS) e email — e cada canal subscreve os eventos com que se importa:
- Eventos de alerta — levantado, escalado e resolvido.
- Estado do agent — um agent a ficar offline ou a voltar a ficar online.
- Atualização disponível — um agent está a correr um build mais antigo do que a última versão publicada (uma vez por agent e versão).
- Falhas de função — um lote de chamadas com falha, com a função, uma contagem e um erro de exemplo.
Os webhooks personalizados são assinados e protegidos
Os payloads de um canal custom são assinados com HMAC para que o teu recetor possa verificar que vieram do ConnXL, e o destino é verificado para impedir os webhooks de alcançarem endereços de rede privados. Usa Enviar teste para disparar um evento de exemplo enquanto o configuras.
Os canais de email escrevem no idioma de cada destinatário
Um canal email não tem URL: envia para uma lista de membros da organização que escolhes (se a deixares vazia, vai para todos os administradores). Cada pessoa recebe o alerta no seu próprio idioma, e cada uma pode silenciar os emails de alerta para si em Organização → As minhas preferências. Vê Membros e funções para saber como esse idioma é escolhido.
Logs e exportações
Cada chamada de função que um agent executa é reportada de volta como um evento de utilização — nunca os dados, apenas os metadados. O dashboard agrega esses eventos em análises que podes ler no ecrã ou transferir como folha de cálculo. Esta página também cobre o visualizador de logs de processo do agent, separado, usado para diagnosticar uma função avariada.
Resolução de problemas
Correções orientadas a tarefas para os problemas que vais mesmo encontrar: uma fórmula em branco, um código de erro do Excel, um agent que não volta a ligar-se, e falhas de inscrição — mais onde procurar mais detalhe.