Vitreum Hub

Loggly

Logs

Receber, buscar e reter os logs de aplicação enviados pelos sistemas das empresas.

Atualizado em 22/11/2026

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:

  1. Em Nova fonte de log, preencha o Nome e, se quiser, o Ambiente (opcional).
  2. Clique em + Criar fonte. O token e o endereço de envio aparecem na hora, na faixa Endpoint desta fonte — copie agora.
  3. 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 (tanto pagina quanto Pagina funcionam). 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.