Operar
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.
7 min de leitura
Duas coisas diferentes partilham o nome 'Logs'
As análises de utilização (abaixo) são a página Telemetria/Logs: contagens de chamadas agregadas, latência e utilizadores mais ativos ao longo de uma janela — para perceberes como o teu suplemento é usado. Os logs de processo do agent mais abaixo nesta página são uma cauda ao vivo diferente, da própria saída de debug/info/error do agent — para diagnosticar porque é que uma chamada de função específica acabou de falhar. Se estás à procura de uma função avariada agora mesmo, salta para essa secção.
O que as análises mostram
As páginas Telemetria e Logs cobrem uma janela deslizante (30 dias por omissão, ajustável):
- Utilização diária — chamadas e erros por dia, e o volume de dados movido, para que consigas ver períodos ocupados de relance.
- Funções mais chamadas — as funções mais chamadas, ordenadas por contagem de execução, com contagens de erro.
- Funções mais lentas — ordenadas por latência, para te apontar o que otimizar.
- Utilizadores mais ativos — os utilizadores finais mais ativos, mostrados como
domínio · hash(por exemploacme.com · 7a3f…).
Os emails em bruto nunca chegam ao dashboard
A identidade de um utilizador é reduzida ao seu domínio de email mais um hash SHA-256 de sentido único antes de sair do agent. Consegues distinguir dois utilizadores e ver o seu domínio, mas o dashboard nunca guarda nem mostra um endereço em bruto.
Exportar
Há duas formas de tirar os dados do dashboard.
- Exportação rápida .xlsx — transfere a janela de análise atual como um livro com três folhas: Utilização diária, Funções mais chamadas e Utilizadores mais ativos. Gerada na hora.
- Exportação assíncrona de logs — para uma extração maior, pede uma exportação e o backend constró-la em segundo plano. Aparece na lista de exportações quando está pronta, e transferes o
.xlsxconcluído a partir daí.
As análises são por suplemento
O que vês está filtrado pelos suplementos da tua organização e pela janela que escolhes, por isso uma exportação é um retrato fiel de exatamente o que está no ecrã.
Logs de processo do agent
Este é o outro "Logs" — um painel de diagnóstico ao vivo na página Agent do ambiente, não as análises acima. Onde as análises de utilização te dizem quanto o teu suplemento está a ser usado, este diz-te o que o próprio agent estava a fazer, linha a linha, mesmo antes de algo se avariar.
- Obtido sob pedido, não um histórico persistido. Clicar no painel envia ao agent um comando
get_logspelo seu canal de controlo, e o agent responde com até 500 das suas linhas mais recentes, guardadas num buffer circular em memória — é uma cauda de agora mesmo, não um arquivo pesquisável a recuar semanas. - Filtros de nível — os botões
debug/info/errorreduzem as linhas obtidas do lado do cliente. - Filtrado antes de sair do agent. Os valores sensíveis (segredos, strings de ligação, tokens) são retirados dentro do agent à medida que as linhas entram no buffer circular — o dashboard só alguma vez mostra texto já filtrado, nunca oculta nada à entrada.
- Qual a réplica que respondeu — se o ambiente corre várias réplicas, uma réplica ativa arbitrária responde e uma nota de rodapé indica o seu hostname, para saberes de que processo estás a ver os logs.
- Exige que o agent do ambiente esteja online (a mesma condição de enviar qualquer outro comando), e está limitado a administradores como o resto dos controlos de runtime.
Usa isto quando uma função específica acabou de falhar
As análises de utilização dizem-te que uma função está a dar erro; os logs de processo do agent dizem-te porquê — a exceção real ou o erro de ligação que o agent encontrou ao executá-la. Consulta Resolução de problemas para o resto do guia "como resolvo X".
Versões
Cada ambiente mantém um histórico restaurável de configurações publicadas. Esta página cobre o modelo rascunho vs. ativo, guardar e publicar uma versão, comparar dois snapshots (incluindo o teu rascunho por publicar), restaurar, e promover uma versão entre ambientes.
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.