Loggly
Logs
Receber, buscar e reter os logs de aplicação enviados pelos sistemas das empresas.
Nesta página
O Loggly é a central de logs de aplicação do Hub: cada acesso a uma página, ação de um usuário, requisição e retorno enviados pelos sistemas das suas empresas vira um registro pesquisável aqui dentro. Ele substitui serviços externos de log — em vez de manter uma ferramenta à parte, o sistema do cliente passa a enviar os logs para um endereço do próprio Hub, e a sua equipe consulta tudo por aqui. Cada empresa gera um token, e todo log recebido com ele fica vinculado a essa empresa.
Onde fica
No menu lateral, em Loggly → Logs, abre o consultor de logs — ele já mostra os registros de todas as empresas, e você escolhe uma no seletor para filtrar. A configuração das fontes (os tokens) fica dentro de cada empresa: em Empresas, abra a empresa e vá na aba Loggly. O módulo precisa estar habilitado no plano do cliente.
Criar uma fonte e gerar o token
Uma fonte é um canal de envio (por exemplo, um por ambiente: Produção, Homologação). Na aba Loggly da empresa:
- Em Nova fonte de log, preencha o Nome e, se quiser, o Ambiente (opcional).
- Clique em + Criar fonte. O token e o endereço de envio aparecem na hora, na faixa Endpoint desta fonte — copie agora.
- Copie o endereço ali mesmo — o token só é exibido uma vez.
Se perder o token, use Rotacionar para gerar um novo (o anterior deixa de funcionar). Desativar pausa o recebimento sem apagar; Remover exclui a fonte. Os logs já recebidos permanecem.
Enviar os logs (integração)
O sistema da empresa envia cada log com um POST no endereço da fonte — https://SUA-EMPRESA.vitreumhub.com.br/logs/ingest/SEU_TOKEN — no formato JSON. Quem já usa uma ferramenta externa migra trocando apenas o endereço da chamada de envio (a função Vitreum_Logs_Remoto disponibilizada pela Vitreum já faz isso — basta apontar para a URL da fonte). Um envio bem-sucedido responde {"Code":200,"Message":"Log cadastrado com sucesso"}. Os campos reconhecidos:
- pagina, funcionalidade, plataforma — o que estava sendo feito.
- ip, sessao, pk_empresa, pk_login — de quem/onde partiu (identificadores do sistema do cliente).
- nivel — info (padrão), warn, error ou debug.
- requisicao e retorno — os dados de entrada e saída da operação.
Os nomes dos campos são reconhecidos com ou sem maiúsculas (tantopaginaquantoPaginafuncionam). Qualquer campo extra enviado é preservado junto do registro. O envio é “dispare e siga” — não trava o sistema do cliente.
Consultar os logs
Em Loggly → Logs você vê os logs de todas as empresas — o nome da empresa aparece em cada linha. Ferramentas de consulta no topo:
- Empresa — deixe em Todas as empresas para ver tudo, ou escolha uma para filtrar (o botão Limpar volta para todas).
- Consulta — a barra de busca entende campo:valor. Veja abaixo.
- Período — Últimos 15 min, 1 hora, 4 horas, 24h, 7 dias, 30 dias ou personalizado (com data e hora).
- Filtros — recorte por nível, fonte, plataforma, ambiente, login ou funcionalidade; os filtros ativos viram chips no topo.
O Field Explorer, à esquerda, lista os campos mais úteis; clique num campo para abrir seus valores mais frequentes (com a contagem) e clique num valor para filtrar por ele.
A barra de consulta
Em vez de procurar uma palavra solta no meio de tudo, você diz onde procurar. Escreva login:sa e a lista mostra só o que aquele login fez; escreva login:sa acao:DELETE e mostra só o que ele apagou. O botão ? no canto da barra abre o painel Como consultar, com exemplos prontos — clique num deles para usar — e a lista de campos disponíveis.
Os campos mais usados:
- login: quem executou · acao: a operação (no SQL, DELETE, UPDATE, INSERT) · objeto: a tabela ou página
- statement: o texto do comando · host: a máquina · app: o programa usado na conexão
- nivel: info, warn, error ou debug · fonte: e empresa: de onde veio · duracao: o tempo, como
duracao:>500
Combinando:
campo:"valor com espaço"— use aspas quando o valor tiver espaço.nivel:warn,error— a vírgula significa um ou outro.-plataforma:sqlserver— o traço na frente exclui.- Vários termos na mesma linha se somam: todos precisam bater.
Os chips logo abaixo da barra mostram o que o sistema entendeu de cada termo — confira ali se o resultado vier estranho. Campo que não existe não quebra a consulta: o sistema avisa e procura o texto como busca comum.
A busca casa palavras inteiras, e é isso que a deixa instantânea mesmo com milhões de eventos. Quando o termo está no meio de um nome (como o SE4 de base.dbo.VT_SE4), a busca rápida não encontra — nesse caso a tela oferece o botão Procurar dentro das palavras, que percorre todos os eventos do período e leva alguns segundos. Você também pode pedir isso direto, cercando o termo com asterisco: *SE4*.
Linha do tempo e detalhes
O gráfico de volume no topo mostra quantos logs chegaram ao longo do período. Clique numa barra para filtrar apenas aquele intervalo de tempo — dá para clicar de novo e afunilar mais; use Ampliar para voltar à visão ampla. Cada linha da lista é um resumo de um evento; clique nela para expandir e ver todos os detalhes e o conteúdo completo (requisição e retorno).
Armazenamento e retenção
O quanto de log cada cliente pode guardar e por quantos dias é definido pelo plano (com ajuste por empresa quando necessário). Logs além do período de retenção são removidos automaticamente, e ao atingir o limite de espaço os mais antigos saem primeiro — sem intervenção manual.
Ver os logs exige a permissão Ver os logs de aplicação das empresas; criar ou rotacionar tokens exige a permissão de gerenciar empresas.