nginx, Apache, IIS

Transforme Web Server Logs em tabelas consultáveis.

Seu log de acesso já é uma tabela — códigos de status, tempos de resposta, IPs dos clientes, caminhos e agentes de usuário, uma linha por solicitação. Aponte o agente para a pasta de logs e consulte os dados, incluindo arquivos rotacionados e arquivos .gz.

Use os resultados no Excel, no Google Sheets, em ferramentas de IA e em seus aplicativos por meio da Database REST API.

Todos os tipos de conectores estão disponíveis no Free. Comece com 2 fontes de dados e 1 agente.

Registros do servidor webArquivos lidos onde estão armazenados
Dentro da sua redeAgente de rede de fluxos de consulta

Leia, organize e consulte na sua máquina.

Consultas somente leitura · conexão de saída

Os arquivos de origem permanecem no lugar. Suas ferramentas recebem os resultados das consultas.

Origem → agente → resultados permitidos

Query Streams transforma os logs de acesso que nginx, Apache, Caddy e Microsoft IIS já gravam em tabelas SQL em tempo real, acessíveis pelo Microsoft Excel, Google Sheets, assistentes de IA via MCP, REST API e Power BI. Os formatos permanecem estáveis há décadas, então os perfis os definem com precisão: código de status, tempo de resposta, IP do cliente, caminho, referenciador e agente de usuário chegam como colunas tipadas. Arquivos rotacionados e seus arquivos .gz fazem parte da mesma tabela. Sem encaminhador de logs, sem agente na borda e sem nada enviado para fora — somente os resultados das consultas saem da sua rede.

  • nginx, Apache, Caddy e IIS
  • Inclui arquivos rotacionados e .gz
  • Sem encaminhador de logs intermediário

Conecte Web Server Logs com as configurações corretas.

Mantenha a conexão no Network Agent. Estes são os detalhes específicos de Web Server Logs.

Pasta
O diretório de logs do servidor ou uma pasta para onde os logs são coletados — disco local ou compartilhamento de rede no formato \\server\share (nunca uma letra de unidade mapeada; no Linux ou Mac, monte o compartilhamento primeiro); inclui subpastas
Servidores
nginx, Apache HTTP Server, Caddy e Microsoft IIS
Formatar
Definido pelo perfil — combined e common para nginx e Apache, JSON lines para Caddy e a diretiva de cabeçalho #Fields para IIS
Rotação
Dez padrões de rotação nomeados, além de arquivos sem rotação; arquivos compactados são lidos diretamente
Linhas não correspondentes
Mantidas integralmente em events_raw_lines, nunca descartadas
Credenciais
Nenhuma — não há servidor no qual fazer login; o agente lê os arquivos diretamente
dialeto SQL
DuckDB — SQL padrão, sem nada específico da web para aprender

Isto não é um encaminhador de logs. Não há daemon encaminhando linhas para um índice na nuvem nem cobrança de ingestão por gigabyte: o agente lê os arquivos onde já estão, mantém as linhas analisadas em um armazenamento criptografado na mesma máquina e responde às consultas a partir dele. Ao desativar o conector, seus logs permanecem exatamente como estavam.

Desenvolvido para o funcionamento de Web Server Logs.

O que você obtém

  • Uma linha por solicitação, com timestamp, método, caminho, código de status, bytes, referenciador, agente de usuário e IP do cliente em colunas tipadas de verdade, em vez de uma única string longa.
  • Tempo de resposta quando o formato o contém, para que “endpoints mais lentos de ontem” seja uma consulta, e não um exercício de awk.
  • _source_file identifica o arquivo de origem de cada linha, o que permite comparar hosts e hosts virtuais sem custo adicional quando você aponta o conector para uma pasta coletada.
  • Arquivos compactados são lidos diretamente — uma pasta com trinta dias de arquivos .gz oferece trinta dias de histórico consultável, não trinta arquivos para descompactar.
-- Caminhos mais lentos no último dia, começando pelos erros 5xx
SELECT   path, status, COUNT(*) AS hits, AVG(request_time) AS avg_s
FROM     fileset.events
WHERE    status >= 500
GROUP BY path, status
ORDER BY hits DESC

Logs de acesso e logs de erro são arquivos diferentes

O log de acesso registra as solicitações; o log de erro registra as reclamações do servidor, em um formato completamente diferente. Ambos são compatíveis e se tornam tabelas, mas são perfis separados, em vez de um único conector tentando adivinhar qual arquivo é qual — aponte o conector para a pasta e escolha o que está lendo.

Os formatos e o comportamento, em detalhes.

Abra a referência necessária para Web Server Logs.

Uma pasta de registros se transforma em uma tabela que você pode agrupar e combinar.
A grande ideia

Uma pasta de registros se transforma em uma tabela que você pode agrupar e combinar.

Query Streams lê os arquivos que seu servidor web já grava, define o formato e fornece colunas tipadas. Sem agente no servidor, sem pipeline de envio, sem índice para manter — e uma linha que o analisador não consegue ler é mantida como uma linha com o motivo, em vez de ser descartada silenciosamente.

Pasta de registrono host
acesso.logCaddy
access.log.2.gznginx
u_ex260909.logIIS

Rotações, arquivos compactados e arquivos lidos novamente — tudo tratado

erros-lentos.sqlSQL
SELECIONAR caminho,
       contar(*) AS sucessos,
       redondo(média(duração_em_segundos) * 1000) AS EM
DE   conjunto de arquivos.eventos
ONDE  status >= 500
GRUPO POR caminho
ORDER BY sucessos DESC
Resultado5xx por caminho
caminhosucessosEM
/api/export4128,140
/api/relatório963,502
/Confira311,208
/procurar7944

Integre-o ao banco de dados do seu aplicativo na mesma consulta.

Os arquivos que seu servidor já grava, agora você tem uma tabela para gerar relatórios.

Quatro servidores, quatro formatos, nenhuma configuração.
Servidores

Quatro servidores, quatro formatos, nenhuma configuração.

Cada cartão informa os arquivos exatos que Query Streams lê nesse servidor e onde estão. Você não precisa alterar a configuração de logs para isso funcionar — o formato padrão é compatível.

Registros de servidor web suportados

4 formatos · 4 servidores
Logotipo do nginx - O Query Streams lê arquivos de log de acesso e erro do nginx nginxAcesso e erro
  • acesso.log o formato combinado padrão
  • erro.log nível, pid, conexão e mensagem
  • Geralmente /var/log/nginx
  • Apêndices; rotações numeradas a seguir
Logotipo do servidor HTTP Apache - O Query Streams lê arquivos de log de acesso e de erro do Apache. Servidor HTTP ApacheAcesso
  • registro de acesso formatos combinados e comuns
  • Um analisador cobre Apache e nginx — o formato de acesso é o mesmo
  • /var/log/apache2, ou httpd no RHEL
  • Apêndices; rotações numeradas a seguir
Logotipo do Caddy - O Query Streams lê arquivos de log de acesso JSON do Caddy 2 CaddyCaddy 2 JSON
  • acesso.log um objeto JSON por solicitação
  • Nome do servidor TLS, versão e retomada de sessão incluídos
  • Duração da resposta em microssegundos
  • Rolls para acesso-<carimbo de data/hora>.log.gz; cada membro leu uma vez
Logotipo do Microsoft IIS - O Query Streams lê arquivos de log estendidos W3C do IIS Microsoft IISW3C estendido
  • u_ex*.log Formato estendido W3C
  • O #Campos: O cabeçalho define as colunas, portanto, sua seleção de campos será seguida.
  • C:\inetpub\logs\LogFiles\W3SVC<site>
  • Um novo arquivo datado por dia, nunca renomeado.
Mais informaçõesEsses são o começo, não o teto.

Novos formatos de log de servidor web e proxy são adicionados a cada nova versão do Agente. Como os Agentes se mantêm atualizados automaticamente, um formato adicionado posteriormente aparecerá no seu conector sem que ninguém precise acessar o servidor.

Todos os quatro parsers foram compilados e testados com arquivos de log reais capturados, incluindo rotações e arquivos compactados — o perfil do Caddy foi testado com logs obtidos diretamente do nosso próprio host de produção.
Logs de acesso de todas as bordas, lidos onde são gravados
Todas as regiões

Acesse os registros de cada borda, leia onde eles aterrissam

Uma solicitação nem sempre passa duas vezes pelo mesmo continente. Sua borda fica em uma região, sua origem em outra, e algo ainda mais antigo continua funcionando no escritório. Cada local executa um Network Agent que lê os arquivos de log onde são gravados e inicia uma conexão com Query Streams. Para o seu firewall, isso é uma conexão de saída comum — nada para abrir, nenhuma VPN para configurar e nenhum encaminhador de logs para manter ativo.

eu-oeste Caddy na borda, registros de acesso JSON rotativos por carimbo de data/hora. disca
leste dos EUA origem nginx por trás disso, logrotate e .gz arquivos disca
Sede Um servidor IIS ainda servindo um aplicativo interno. disca

Três conexões de saída, um só lugar para consultá-las — sem porta de entrada, sem VPN, sem alterações no firewall

Um agente por local

Um Agent abrange um local inteiro, em vez de um único arquivo de log; e, dentro de um local, uma árvore de pastas com vários hosts constitui um único conector — cada linha contém seu site. O plano Free executa um único Agent, e os planos pagos executam mais.

1 região = 1 agente = muitos hosts

Nada para abrir

O Agent estabelece uma única conexão de saída criptografada, e tanto a solicitação de saída quanto as linhas de retorno trafegam por ela. Não é preciso abrir uma porta de entrada, configurar uma VPN nem pedir alterações no firewall — e nada encaminha seus logs a terceiros nesse processo.

uma conexão, em ambas as direções

Uma consulta que abrange várias regiões.

Cada fonte em um consulta federada O sistema nomeia seu próprio agente, permitindo que uma única instrução coloque a aresta em uma região ao lado da origem em outra, ou integre qualquer uma delas ao banco de dados do seu aplicativo. Incluído nas versões Business e Enterprise.

2 regiões → 1 conjunto de resultados

Eles se mantêm atualizados

Os agentes se atualizam automaticamente, portanto, um formato de log adicionado em uma versão posterior chega a todas as regiões sem a necessidade de implantação adicional. É isso que faz com que a lista acima seja um ponto de partida, e não uma lista fixa.

Novos formatos chegam com o Agente.

A rotação é o motivo pelo qual isso não é apenas uma importação de CSV.
A parte difícil

A rotação é o motivo pelo qual isso não é apenas uma importação de CSV.

Os logs da Web não ficam parados. Eles são rotacionados, renomeados, compactados e recriados por baixo dos seus olhos. Fazer isso corretamente — sem lacunas e sem contar uma linha duas vezes — é a maior parte do trabalho.

Rotações numeradas

A clássica dança do logrotate: o arquivo de hoje mantém o nome e o de ontem desce uma posição. Query Streams acompanha o conteúdo, não o nome.

access.log → access.log.1 → access.log.2.gz

Nomes de arquivos datados

O IIS nunca renomeia arquivos — ele abre um novo arquivo a cada dia, com a data no nome. Os arquivos antigos permanecem exatamente como estavam, então são lidos uma vez e deixados intactos.

u_ex260909.log · u_ex260910.log

Arquivos compactados

Um log rotacionado geralmente acaba compactado com gzip. Leituras de fluxos de consulta .gz membros no local — você não precisa descompactar nada nem movê-lo para outro lugar antes.

acesso-2026-09-08T03-00-00.000.log.gz

Nada contava duas vezes.

Cada arquivo é identificado pelos seus primeiros 4 KB, de modo que um arquivo renomeado seja reconhecido como o mesmo arquivo. Uma janela deslizante de duplicatas captura a sobreposição quando um gravador reproduz a cauda do arquivo.

Hash de prefixo de 4 KB · janela de 20.000 registros

As colunas que você realmente obtém
O esquema

As colunas que você realmente obtém

Não se trata de um bloco de texto com um registro de data e hora ao lado. Cada formato é analisado e dividido em colunas tipadas que você pode filtrar, agrupar e agregar diretamente.

Logotipos do nginx e do Apache
registro de acesso combinadonginx · Apache
endereço_do_clienteautorizaçãométodocaminhoversão_httpestadobytesreferenciadoragente
logotipo do nginx
Registro de errosnginx
nívelpidmaréconexãomensagem
Logotipo Caddy
registro de acesso JSONCaddy 2
endereço_do_clienteIP remotoporta_remotamétodocaminhoversão_httpestadobytesbytes_readduração_segundosnome_do_servidor_tlsversão tlstls_retomadoID do usuárionívellenhadormensagemdados
Logotipo do Microsoft IIS
Registro estendido do W3CMicrosoft IIS
s_ipc_ipesportecs_métodocs_uri_stemconsulta_uri_cscs_usernameagente_de_usuário_csstatus_scsc_substatussc_win32_statustempo_decorrido

Cada linha também carrega hora do evento e siteAssim, uma única consulta pode abranger vários hosts e a origem do arquivo nunca é questionada.

O que deliberadamente não lemos

O que deliberadamente não lemos

Um log de acesso de produção contém mais informações do que você talvez queira em uma tabela de relatórios. O formato JSON do Caddy registra mapas completos de cabeçalhos de solicitação e resposta, que normalmente contêm cookies de sessão e tokens bearer. O perfil do Caddy exclui cabeçalhos da solicitação e resp_headers por declaração — não por um filtro que você precisa lembrar de ativar, nem depois do fato. Esses campos nunca são analisados e, portanto, nunca chegam a uma tabela, exportação ou planilha.

O restante do projeto segue o mesmo princípio. O Agente se conecta à rede externa e lê arquivos; nada é instalado no servidor web, nada é gravado nele e o acesso é somente leitura.

Da conexão a resultados úteis.

  1. Instale o Network Agent onde ele possa acessar a pasta de logs — no próprio servidor Web ou em um compartilhamento para onde os logs são coletados.
  2. Aponte o conector para essa pasta e escolha o perfil: nginx ou Apache combined e common, linhas JSON do Caddy ou formato W3C do IIS.
  3. O perfil define o layout, então as colunas recebem nomes e tipos na primeira sincronização — não há nada para descrever nem para amostrar.
  4. A rotação é reconhecida. O access.log.1 de ontem e o arquivo .gz da semana passada fazem parte da mesma tabela que o arquivo ativo de hoje, e somente os bytes novos são lidos novamente.
  5. Faça consultas. Caminhos mais lentos, erros 5xx por hora, principais clientes, tráfego de bots — SQL comum em todos os servidores que você indicar.

Coloque os resultados de Web Server Logs para trabalhar.

Uma conexão atende às suas planilhas, aplicativos e ferramentas de IA. Compartilhe a permissão para executar uma consulta salva; os destinatários veem os resultados permitidos, sem acesso ao SQL nem ao login da origem.

Para sua equipe, fornecedores e parceiros.

Traga os resultados atualizados de Web Server Logs diretamente para uma planilha e atualize-os quando quiser — no Excel para desktop, no Excel Online ou no Microsoft 365.

Conheça o Excel

Compartilhe um resultado atualizado de Web Server Logs com qualquer pessoa — colega, fornecedor ou parceiro — como uma grade que pode ser adicionada aos favoritos e que executa uma nova consulta ao ser aberta, em um celular, tablet ou computador. A pessoa vê os resultados, nunca o SQL nem os arquivos.

Como funciona o Visualizador de Dados

Para aplicativos e sistemas

Publique uma consulta de Web Server Logs como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

Explore a REST API

Cole o código M do Power Query gerado no Editor Avançado do Power BI e o relatório lerá os resultados atualizados de Web Server Logs por HTTPS — sem driver ODBC e sem abrir portas de banco de dados.

Explore o Power BI

Para ferramentas de IA

Entregue às pessoas

Combine Web Server Logs com o restante dos seus dados.

Reúna bancos de dados, APIs empresariais, arquivos e logs em uma única consulta somente leitura. Todos os conectores são compatíveis com Consultas Federadas.

Indique as conexões e tabelas. O Query Streams gerencia as consultas às origens e combina os resultados.

Explore as Consultas Federadas
Exemplo ilustrativo de consulta entre fontes
-- nada copiado, nada mesclado, nada agendado
SELECIONAR   c.região, COUNT(*) AS pedidos, SUM(i.valor_devido) AS faturado
DE     weblogs.fileset.orders1  f
JUNTAR     pg_crm.clientes.públicos2 c LIGADO c.id = f.id_do_cliente
JUNTAR     cobrança.stripe.faturas3 i LIGADO i.cliente = c.stripe_id
GRUPO POR c.região
ORDER BY faturado DESC;

Use os nomes das suas próprias conexões, esquemas, tabelas e colunas.

Compartilhado por toda a família de conectores.

Cada conector de logs também oferece

  • events — uma linha por linha analisada, com o registro de data e hora, os campos definidos pela gramática e _source_file, que indica o arquivo de origem.
  • events_raw_lines — linhas que não correspondem à gramática, preservadas literalmente em vez de descartadas, para que você ainda possa responder a perguntas sobre um formato que não previu.
  • files_current e files_events — o inventário atual e a trilha de auditoria: o que apareceu, o que foi rotacionado, o que desapareceu e o que foi retido, com o nome do arquivo e o motivo.
  • A rotação é compreendida, não contornada — dez padrões de rotação nomeados, além de arquivos sem rotação, para que o log de ontem e seu arquivo compactado sejam a mesma tabela que o de hoje.

Bom saber

  • Somente leitura, garantido — uma instrução por vez, apenas SELECT e similares. Nunca gravamos, movemos, rotacionamos ou truncamos seus logs.
  • Nada é enviado — as linhas são analisadas e armazenadas em cache, criptografadas, na sua própria máquina, ao lado do agente. Somente o resultado de uma consulta sai da sua rede.
  • Somente os bytes novos são lidos — o agente retoma de onde parou em cada arquivo, em vez de lê-lo novamente, para que um log movimentado não custe mais a cada dia.
  • O dialeto SQL é DuckDB — o mesmo SQL que você escreveria para qualquer outro conector.

Dúvidas sobre Web Server Logs

Onde posso usar os resultados de consultas de logs de servidor web?

Use os resultados de logs de servidor web no Excel, Google Sheets, Data Viewer, nos seus aplicativos por meio da Database REST API e em ferramentas de IA por meio do MCP ou Nova. Os resultados salvos também alimentam destinos de Automation compatíveis, relatórios e alertas. A disponibilidade dos destinos e os limites dependem do seu plano.

Preciso abrir uma porta de entrada para os logs de servidor web?

Não. Instale o Network Agent em uma máquina que possa acessar os logs de servidor web. O agente se conecta de saída a Query Streams; não é necessária nenhuma porta de entrada nem VPN. Ainda assim, sua fonte precisa permitir que a máquina do agente se conecte de acordo com as próprias regras de acesso.

Meus arquivos de logs de servidor web são enviados?

O Network Agent lê os arquivos onde eles estão e mantém o cache na máquina do agente. Os arquivos de origem não são enviados, movidos nem reescritos. Somente os resultados de consultas solicitados saem da sua rede pela conexão criptografada de saída.

Do que preciso para conectar os logs de servidor web?

Pasta: O diretório de logs do servidor ou uma pasta para onde os logs são coletados — disco local ou compartilhamento de rede informado como \\server\share (nunca uma letra de unidade mapeada; no Linux ou Mac, monte primeiro); inclui subpastas. Servidores: nginx, Apache HTTP Server, Caddy e Microsoft IIS. Formato: Definido pelo perfil — combined e common para nginx e Apache, linhas JSON para Caddy, diretiva de cabeçalho #Fields para IIS. Rotação: Dez padrões de rotação nomeados, além de arquivos sem rotação; arquivos compactados são lidos no local.

Posso combinar logs de servidor web com outras fontes conectadas?

Sim. As Consultas Federadas são compatíveis com todos os tipos de conectores, incluindo bancos de dados, APIs empresariais, arquivos e logs. Indique as conexões e tabelas em uma única consulta somente leitura. O Query Streams traduz as partes referentes às origens conforme necessário e combina os resultados. Veja como funcionam as Consultas Federadas.

Preciso alterar minha configuração de registro de logs?

Não. Cada formato suportado é o padrão para aquele servidor: o log de acesso combinado para nginx e Apache, o log de acesso JSON para Caddy 2 e o formato estendido W3C para IIS. Se você nunca alterou o formato do seu log, você já está usando um formato suportado.

O IIS é o caso flexível, e é tratado corretamente — o #Campos: A diretiva no topo de um arquivo W3C nomeia suas colunas; portanto, os campos selecionados no Gerenciador do IIS serão as colunas exibidas.

Isso é em tempo real?

É sob demanda, não em fluxo contínuo. Query Streams lê os arquivos como estão no disco quando você executa a consulta, então as novas solicitações aparecem à medida que o servidor as grava e o arquivo é capturado — não em um agendamento noturno fixo, mas também não como um acompanhamento em tempo real.

Se você precisa de alertas em menos de um segundo sobre uma solicitação no momento em que ela ocorre, um pipeline de logs é a ferramenta certa. Se você quer fazer uma pergunta sobre o tráfego das últimas semanas e obter a resposta em uma planilha, isso requer uma estrutura consideravelmente mais simples.

O que acontece com os registros rotacionados e comprimidos?

Eles são lidos. Query Streams entende os três estilos de rotação usados por esses servidores — a rotação numerada do logrotate, o arquivo novo com data por dia do IIS e a rotação com marcação de data e hora do Caddy — e lê .gz Os arquivos permanecem no local sem que você precise descompactá-los.

Os arquivos são identificados por um hash dos seus primeiros 4 KB, em vez de pelo nome, portanto, um arquivo rotacionado é reconhecido como aquele já visualizado. É isso que impede que uma rotação perca um dia ou conte um dia duas vezes.

Meus registros estão em vários servidores. Posso consultá-los em conjunto?

Sim. Cada fileira carrega um site coluna, para que uma consulta possa abranger vários hosts e agrupar por qualquer critério desejado. Você pode implantar um Agente por ambiente ou por região, e todos eles apresentarão suas pastas na mesma lista.

Como é SQL comum, você pode ir além e juntar logs de solicitações a um banco de dados real — comparando um pico de erros 500 com uma tabela de implantações ou solicitações lentas de checkout com os pedidos correspondentes.

Ele lê cookies ou cabeçalhos de autorização?

Não. O formato JSON do Caddy é o único dos quatro que registra mapas de cabeçalhos, e o perfil exclui cabeçalhos da solicitação e resp_headers Por declaração, elas nunca são analisadas e transformadas em uma coluna. Os formatos combinado, de erro e W3C não contêm cabeçalhos inicialmente.

Os endereços IP dos clientes e os agentes de usuário são analisados, pois são o propósito de um log de acesso — trate a tabela resultante com o mesmo cuidado que o arquivo de log de onde ela veio.

E quanto a uma linha que o analisador sintático não consegue ler?

Ela é mantida, não descartada. Uma linha que não corresponde ao formato definido é retida como uma linha bruta com uma justificativa anexada, de modo que uma entrada malformada ou uma alteração inesperada no formato apareça como algo que você pode ver e consultar, em vez de como uma lacuna silenciosa em seus números.

Coloque Web Server Logs onde o trabalho acontece.

Comece com o Free: todos os tipos de conectores, 2 fontes de dados e 1 Network Agent. Amplie as permissões do plano conforme suas necessidades crescerem.