Consultar logs de aplicativos com SQL (JSON e texto)

Conector de pastas · Registros de aplicativos

Transforme os arquivos de log do seu aplicativo em Tabelas SQL Você pode consultar em qualquer lugar.

Aponte o Agente de Fluxos de Consulta para a pasta. Ele lê os arquivos de log em seu próprio computador, cria as tabelas em um cache local e as mantém atualizadas conforme os arquivos chegam, são alterados ou desaparecem. Você pode consultá-las a partir do Excel, Planilhas Google, Nova, Claude ou da API REST. Nada é carregado, convertido ou editado.

Cerca de 15 minutos Não é necessário programar Os arquivos permanecem na sua rede. O plano gratuito cobre isso.

O resultado final será o que você obterá.

O Application Logs lê os arquivos de log JSON e de texto que seus aplicativos gravam e transforma cada evento em uma linha em uma tabela chamada eventosCada linha contém o evento. nível, lenhador e mensagemE um rastreamento de pilha de várias linhas permanece associado ao evento que o gerou, em vez de se tornar linhas separadas. Você consulta a tabela com SQL a partir do Excel, Planilhas Google ou um painel de controle, enquanto os arquivos permanecem no computador que executa o Agente.

Os eventos analisados chegam em conjunto de arquivos.eventos, ou no Nome da tabela Você escolheu. O Agente copia as linhas para um cache local no computador do Agente e as disponibiliza como SQL. As colunas abaixo são do tipo de log padrão.

Cada conector de pasta também lhe oferece arquivos, arquivos_eventos, diretórios, snapshots_de_diretório e volumese adicionar conectores de log cursores de log com a posição de leitura de cada arquivo. Sempre ORDENAR POR event_time.

Onde se justifica o seu sustento:

• Contabilize erros por aplicativo e registrador em uma planilha sem abrir um visualizador de logs.
• Visualização gráfica do volume de erros por hora em um painel de controle alimentado pela tabela de eventos.
• Alerta quando um evento fatal aparece nos registros de um serviço específico.

O que você vai precisar

Uma conta do Query Streams

Os conectores de pastas estão disponíveis em todos os planos, inclusive no plano gratuito. O plano gratuito é permanente, não um período de teste com prazo de validade. Não há limite para a quantidade de arquivos que uma pasta pode conter.

O Agente, versão 2.6.0 ou posterior

Instalado em um computador que possa abrir a pasta: o próprio servidor de arquivos, um computador do escritório ou a máquina onde os arquivos são armazenados. Um Agente mais antigo exibe os cartões de pasta acinzentados com um Agente 2.6.0+ Distintivo. Windows, Mac ou Linux.

O caminho da pasta, conforme visto pelo Agente.

Um caminho local ou um compartilhamento de rede escrito como \\servidor\compartilhamento\pasta. The Agent runs as a service, so it cannot see drives you mapped at your login (Z: and friends). On Windows it can sign in to a share with a login you store; on Linux or a Mac, mount the share first (Linux under /mnt ou /mídia, a Mac under /Volumes).

Configure em cinco etapas

1. Instale o Agente em um computador que possa abrir a pasta.

   Faça login e abra DownloadInstale o Agente para o seu sistema no computador que consegue abrir os arquivos de log do aplicativo: o servidor de arquivos ou qualquer computador sempre ligado que consiga acessar o compartilhamento. A instalação leva um minuto e, a partir daí, o Agente inicia automaticamente. Você precisa da versão 2.6.0 ou posterior; a página de Downloads sempre tem a versão mais recente.

   Por que um programa pequeno em vez de um driver? O Agente é instalado em um único programa para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux). Ele abre uma conexão criptografada de saída para o Query Streams, sendo esse o único caminho de rede necessário: não é preciso abrir nenhuma porta de entrada, nem usar VPN. Ele lê a pasta onde está instalado, portanto os arquivos permanecem no mesmo local e apenas as linhas retornadas por uma consulta trafegam pela internet até o complemento, navegador ou cliente de IA do seu lado.

   A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no computador do Agente; todo o resto acontece no seu navegador.

   Guias completos, se você quiser: Janelas, Mac, Linux.

2. Aponte para os arquivos de log do seu aplicativo.

   Volte ao seu navegador e abra Dados → Agentes de DadosLocalize o agente que você acabou de instalar e clique nele. Adicionar conector botão. Abra o Arquivos e pastas pílula e escolha a Registros de aplicativos Cartão. Não tem certeza de qual cartão serve? Escolha Arquivos em uma pasta Em vez disso: o Agente examina a pasta, indica o que ela contém em uma página "O que encontramos" e abre o cartão correto para você, já preenchido.

   O mago corre Pastas → Verificar → Configurações → Domínio → Revisar. Sobre Pastas:

   Pastas raiz

   One path per line, as the Agent’s computer sees it. Each folder shows a status (reachable, denied, missing, unreachable, credentials invalid or not mounted) as soon as you add it. On a Windows Agent a share that needs a login gets one from the folder’s Credential column, stored once per server; on Linux or a Mac, mount the share first.

   Digitalizar subpastas, Profundidade máxima

   Ligado, e 8 níveis, por padrão.

   Incluir padrões, Excluir padrões

   Quais arquivos são contabilizados. O padrão de inclusão começa com o padrão glob correto para este cartão. Um conector lê um tipo de arquivo: uma pasta com arquivos CSV. e Os arquivos Parquet consistem em dois conectores na mesma pasta, um para cada tipo.

   Siga links simbólicos e junções

   Desativado por padrão. O Agente não segue atalhos ou marcadores na nuvem, a menos que você ative essa opção.

   No Portal, abra o Agente que pode ver a pasta e clique em Adicionar conector. Sob Arquivos e pastas escolha Registros de aplicativosUma vez criado, ele aparece na lista de conectores como Arquivos de registro.

   • Adicione a pasta onde seus aplicativos gravam em Pastas raizDigite um compartilhamento de rede como \\servidor\compartilhamento\pasta, não como uma letra de unidade mapeada.
   • Incluir padrões já estão preenchidos para você. Os valores padrão do driver de log são **/*.registro e **/*.TXTReduza a seleção se a pasta contiver outros arquivos de texto.
   • Escolha um Tipo de registroOs Logs de Aplicativos estão limitados aos seus tipos predefinidos. Se o seu tipo de log não estiver listado, a seguinte mensagem será exibida: “Precisa de um tipo de log que não está listado? Abra uma solicitação de suporte e nós o adicionaremos em alguns dias.”
   • Nome da tabela é opcional e o valor padrão é eventos.
   • Aterro (dias) é 30. Mantenha os eventos por N dias Mantém tudo configurado, a menos que você defina outra configuração.

3. Verifique o que ele irá construir.

   Sobre Verificar O agente lê uma amostra de até 64 arquivos e mostra o que irá construir. Nada foi criado ainda. O botão exibe a mensagem: Teste de conexão até que haja um veredicto, então Próximo; Teste novamente Executa novamente a amostra depois que você fizer alguma alteração. Você verá um dos quatro títulos a seguir:

   Pronto para criar

   Cada arquivo amostrado se encaixa. Os chips abaixo indicam quantas pastas eram acessíveis, quantos arquivos e linhas havia e quais tabelas existirão.

   Pronto, com anotações.

   Alguns arquivos serão deixados de lado ou a verificação de layout será recusada. Um aviso em âmbar indica exatamente quais: “{n} de {m} arquivo(s) serão deixados de lado” com um Mostre quais arquivos e por quê. lista, e “Você pode criá-la mesmo assim — o conector continuará verificando e relatará o motivo em sua guia Manifesto.”

   Esses arquivos não são desse tipo de log.

   A amostra não foi interpretada corretamente devido ao formato de registro deste cartão. Verifique se você selecionou o cartão correto ou use o formato adequado. Pasta de registro personalizada O cartão e a descrição do formato.

   Arquivos recusados ou arquivados nunca te impedem de acessar: clique PróximoConclua o assistente e corrija os arquivos problemáticos mais tarde. Somente um agente offline ou uma pasta ausente interrompem o assistente.

   Sobre VerificarO agente lê uma amostra e mostra o que irá construir. Nada foi criado ainda. Se a amostra não for do tipo de log que você selecionou, o título exibirá a mensagem: Esses arquivos não são seguido por esse tipo, e um banner âmbar diz “A detecção de esquema foi recusada:” com o motivo. Abrir Mostre quais arquivos e por quê. para visualizar a grade de arquivos e motivos. A solução usual é uma abordagem diferente. Tipo de registroou mais apertado Incluir padrões então arquivos perdidos são deixados de fora, então Teste novamenteVocê também pode criá-lo de qualquer maneira. O conector continua verificando e relata o motivo em seu Manifesto aba.

4. Escolha a frequência com que a função verifica e, em seguida, crie-a.

   Os padrões em Configurações Adequado para uma pasta que recebe poucos arquivos por dia. Quatro opções que você talvez queira alterar:

   Intervalo de varredura

   A cada hora Por padrão, escolha entre a cada 5 minutos ou diariamente. Cada verificação compara o tamanho e a data de modificação para encontrar arquivos novos, alterados e que desapareceram.

   Acompanhe as alterações na pasta (quase em tempo real)

   Desativado por padrão. Quando ativado, o Agente reage em segundos em discos locais; em compartilhamentos de rede, ele age da melhor forma possível e a verificação agendada continua sendo a garantia. Período de silêncio (15 segundos) aguarda a conclusão da gravação de um arquivo.

   Atualize a página antes de responder à pergunta.

   Desativado por padrão. Ativado, uma consulta realiza uma nova verificação quando a última verificação é mais antiga que o Janela de obsolescência (60 segundos), aguardando no máximo o Limite de espera da consulta (5 segundos). Aplica-se a pessoas e complementos, não à pesquisa de alertas.

   Quando um arquivo desaparece

   Solte suas fileiras por padrão, ou Manter linhas, marcar como excluído (lápide). O Proporção de guarda de desaparecimento (0.5) rejeita uma verificação que perde mais da metade dos arquivos de uma só vez e mantém o inventário anterior, que é como um compartilhamento offline se parece.

   Em seguida, escolha o Domínio de dados As linhas contam em relação a, verifique Análise e clique em Criar conectorA primeira varredura começa imediatamente. O conector Manifesto A aba mostra o que foi compilado e quaisquer arquivos que foram separados.

5. Observe suas tabelas.

   Abra o conector: o Manifesto A aba lista as tabelas que foram criadas e as Arquivos A caixa de diálogo lista todos os arquivos de log com seus respectivos estados. Construtor de consultas as mesmas mesas ficam embaixo do conjunto de arquivos Esquema. Três consultas que funcionam desde o primeiro dia:

   Erros na última hora, por logger

   SELECT logger, COUNT(*) AS errors FROM fileset.events WHERE lower(level) IN ('error', 'fatal') AND event_time >= now() - INTERVAL 1 HOUR GROUP BY logger ORDER BY errors DESC LIMIT 100

   Contabiliza erros e eventos fatais por registrador durante a última hora de hora do eventoAjuste o nível Valores que correspondam ao que seus aplicativos gravam.

   Últimos eventos com seus respectivos aplicativos, níveis e mensagens.

   SELECT event_time, app, level, logger, message FROM fileset.events ORDER BY event_time DESC LIMIT 100

   Os 100 eventos mais recentes em todos os arquivos. Um rastreamento de pilha faz parte de mensagem na mesma linha.

   Arquivos rotacionados, truncados ou arquivados recentemente

   SELECT relative_path, event_type, detected_by, detail, event_at FROM fileset.files_events WHERE event_type IN ('rotated', 'truncated', 'rewritten', 'drift', 'refused') ORDER BY event_at DESC LIMIT 20

   Lê o histórico do arquivo em arquivos_eventos. Um deriva A linha indica o nome de um arquivo que foi separado e o motivo.

   Cada conector de pasta também serve para as mesmas tabelas de contabilidade, todas no mesmo lugar. conjunto de arquivos esquema:

   Mesa	O que contém
   arquivos	Todos os arquivos atualmente na pasta: caminho, nome, extensão, tamanho, data de criação e modificação, primeira e última visualização. Uma visão geral. arquivos_atual, que também guarda arquivos que desapareceram.
   arquivos_eventos	O histórico de alterações: uma linha por arquivo que apareceu, era modificado, desapareceu, foi deixado de lado (deriva) ou era recusado, com o tempo em evento_em, como isso foi notado em detectado_por e a razão em detalhe.
   diretórios, snapshots_de_diretório, volumes	Contagem e tamanho das pastas, como elas cresceram e os discos ou compartilhamentos onde as raízes estão localizadas.
   _arquivo_fonte, _row_id	Duas colunas em cada linha de dados: o arquivo de origem da linha e um ID de linha fixo dentro desse arquivo. Agrupar por _arquivo_fonte para comparar arquivos.

Reaching a file on a network share

The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.

If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.

When a folder is not reachable

Every folder on the Pastas step shows a status as soon as you add it. Hover the status to read the Agent’s own message; its first words say which case it is.

Use-o em todos os lugares

O conector é uma fonte de dados como qualquer outra no Query Streams. Salve uma consulta uma única vez no Construtor de consultas (o dialeto é DuckDB) e use-o a partir de:

Excel

O suplemento Transmita uma consulta Insere as linhas em uma planilha e executa novamente com um clique. Executando SQL no Excel.

Planilhas Google

O Fluxo de consulta O complemento preenche uma aba que você escolher. Power Query para Google Sheets.

Claude, Cursor e outros clientes de IA

Por meio do servidor Query Streams MCP, Claude conhece o modelo de pastas, incluindo _arquivo_fonte e arquivos_eventos. Registros de aplicativos com Claude via MCP.

API REST

Em todos os planos, qualquer consulta salva se torna um endpoint somente leitura com sua própria chave. API REST de Logs de Aplicativos.

Nova

Faça perguntas em linguagem simples sobre o plano Business; a Nova conhece cada tabela, coluna e pasta por meio de suas descrições integradas.

Automações

Sincronize as linhas com o Airtable, Smartsheet, Baserow, SeaTable ou uma planilha de acordo com um cronograma. Guias de automação.

As tabelas de pastas também se conectam aos seus outros conectores: uma consulta federada pode corresponder. _arquivo_fonte nomes ou IDs de pedidos nos arquivos de log do seu aplicativo em relação a um banco de dados no mesmo agente.

Como os arquivos novos, alterados e excluídos são exibidos

Arquivos que são separados

Três palavras aparecem na etapa Verificar e na guia Manifesto. Elas têm significados diferentes:

Estacionado (de lado)

O arquivo não corresponde ao layout fixado, ou está ilegível, rasgado, bloqueado ou sobre uma borda. É tudo ou nada por arquivo: um arquivo estacionado contribui com zero linhas. arquivos_eventos registra um deriva fila cuja detalhe O arquivo é nomeado e a coluna é identificada. O arquivo é ignorado enquanto seu tamanho e data de modificação permanecerem os mesmos, e a execução é repetida assim que houver alteração.

Ilegível

O agente não conseguiu abrir ou analisar o arquivo devido ao seu tipo: não é uma planilha válida, está bloqueado por outro programa, é um marcador na nuvem ou contém bytes indecodificados. Ele é interrompido automaticamente e o restante da pasta continua sendo processado. Somente uma pasta com zero arquivos legíveis rejeita todo o conjunto.

Recusado

O agente não conseguiu fixar nenhum layout, por exemplo, porque os arquivos divergem quanto ao tipo de coluna. Ainda não existe nenhuma tabela de dados. arquivos_eventos recebe um recusado linha com o motivo em detalheE o Agente tenta novamente a cada verificação até que um layout seja fixado. Corrija ou exclua o arquivo mencionado e a mensagem desaparecerá.

Onde procurar: a bandeira âmbar em Verificar (Mostre quais arquivos e por quê.), o conector Manifesto aba posteriormente, e para conectores de log o Arquivos diálogo, que lista os arquivos estacionados com o motivo em último_erroEm SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.

Limites que vale a pena conhecer

Não há limite de pastas ou de arquivos no plano. As linhas são contabilizadas no seu Data Realm, como em qualquer outro conector. Você pode aumentar ou diminuir os valores padrão no conector:

Limites de conteúdo, que armazenam um arquivo em vez de truncá-lo: 2.000.000 linhas ou 512 MiB por arquivo, 10.000.000 linhas ou 2 GiB por verificação. Uma pasta pode conter no máximo 25 layouts distintos. Uma mesa por layout modo.

Perguntas que as pessoas fazem

• Sistema de arquivos
• Pasta CSV
• Pasta Parquet
• Pasta do Excel
• Pasta SQLite
• Pasta JSONL
• CSV com vários registros
• Registros de máquinas
• Registros do servidor web
• Registros do contêiner
• Registros do sistema
• Registros personalizados