Consultar logs de contêineres Docker com SQL

Conector de pastas · Logs do contêiner

Transforme os logs do seu contêiner Docker 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á.

Você acaba com uma tabela chamada eventos no conjunto de arquivos esquema, contendo uma linha por linha dos seus logs do Docker. Com o perfil de arquivo JSON do Docker, as colunas são aplicativo (o nome do contêiner), fluxo, nível, lenhador, mensagem, hospedar, serviço e dados, mais imagem, compor_projeto, compor_serviço, id_do_container e hora do eventoVocê pode consultá-lo com SQL a partir do Excel, Planilhas Google, um painel de controle ou qualquer ferramenta que se comunique com Query Streams. Os arquivos de log nunca saem do computador onde o Agente está sendo executado. Este não é o MCP Toolkit do Docker e não executa nem gerencia contêineres; ele apenas lê seus logs.

Linhas aterrissam em eventosou o Nome da tabela Você define. Cada linha carrega _stream_id (um por arquivo de registro, mantido entre as rotações), _linha_no, hora do evento, evento_tempo_bruto, a coluna de identidade aplicativo, as colunas do perfil, _arquivo_fonte e _row_idSempre classificar por hora do evento.

Cada conector de pasta também lhe oferece arquivos, arquivos_eventos, diretórios, snapshots_de_diretório e volumes.

Onde se justifica o seu sustento:

• Contabilize erros por contêiner em um painel de controle sem uma plataforma de logs ou um agente dentro de cada contêiner.
• Extraia as linhas de registro de um serviço para o Excel ou o Google Sheets para criar um relatório de incidente.
• Comparar o volume de stderr entre os serviços do Compose após uma implantação.

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 logs do seu contêiner Docker: o servidor de arquivos ou qualquer computador sempre ligado que consiga acessar o compartilhamento. Leva um minuto e, a partir daí, 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 logs do seu contêiner Docker.

   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 do contêiner 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 agente que pode abrir a pasta de logs do Docker, clique em Adicionar conector, abrir Arquivos e pastas e escolha o Registros do contêiner cartão. Depois de salvo, ele aparece na lista de conectores como Arquivos de registro.

   • Descrição — um nome para o conector.
   • Pastas raiz — as pastas no computador do Agente, uma por linha. No Linux, monte os compartilhamentos em /mnt ou /media.
   • Incluir padrões — comece como **/*-json.log, **/*.registro e **/*.registro.*.
   • Tipo de registro — selecione o perfil para seus arquivos. A lista já está pronta; basta Pasta de registro personalizada Permite definir um formato.
   • Nome da tabela — opcional, o padrão é eventos.
   • Aterro (dias) — 30. Mantenha os eventos por N dias — 30.

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.

   Se a amostra não corresponder ao tipo de registro que você selecionou, o Verificar O título diz "Estes arquivos não são" seguido do tipo. Abrir Relatório completo do agente Para ver o motivo, escolha outro. Tipo de registro e clique em Teste novamenteUma recusa ou arquivo arquivado não o impedem: você ainda pode clicar. Próximo e cria o conector. Ele 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:

   Linhas de erro padrão por contêiner na última hora

   SELECT app, COUNT(*) AS stderr_lines, MAX(event_time) AS last_line FROM fileset.events WHERE stream = 'stderr' AND event_time >= now() - INTERVAL 1 HOUR GROUP BY app ORDER BY stderr_lines DESC LIMIT 100

   Quais contêineres estão escrevendo para stderr neste momento e em que quantidade? O contêiner que falhou primeiro geralmente apresenta a maior parte das mensagens.

   Mensagens de erro mais recentes por contêiner e imagem

   SELECT event_time, app, image, level, message FROM fileset.events WHERE stream = 'stderr' OR message LIKE '%ERROR%' ORDER BY event_time DESC LIMIT 100

   As linhas de erro padrão mais recentes contêm o nome e a imagem do contêiner, portanto, uma implementação de imagem com problemas é exibida em todos os contêineres que a executam.

   Quais arquivos de log foram rotacionados ou arquivados hoje?

   SELECT relative_path, event_type, detail, event_at FROM fileset.files_events WHERE event_type IN ('rotated', 'truncated', 'drift', 'refused') AND event_at >= now() - INTERVAL 1 DAY ORDER BY event_at DESC LIMIT 100

   Histórico diário em nível de arquivo: quais logs de contêiner foram rotacionados e se algum arquivo foi colocado em estado de espera, com a devida justificativa.

   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. Logs de contêiner 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 Contêiner.

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 logs do seu contêiner Docker 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 de aplicativos
• Registros do sistema
• Registros personalizados