Ver categorias

Monitoramento de máquinas CNC com SQL a partir de arquivos de log do controlador

Registros da máquinaPlano gratuitoFluxos de consultaTabelas SQL

Pasta de logs de máquinas → tabelas SQL · com Query Streams

Com Query Streams, os logs do seu CNC, PLC e controlador de robô se tornam tabelas SQL somente leitura: os logs permanecem onde estão, o Agent nesse computador lê as novas linhas à medida que os arquivos crescem e as grava em um cache local criptografado, e nada é enviado nem alterado. Cerca de quinze minutos na primeira vez, e o plano Free cobre isso.

Comece gratuitamente
Pilha isométrica de três folhas de arquivo conectadas por uma linha a um único bloco de tabela
Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

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

Ícone de registros da máquinaVocê acaba com uma tabela chamada eventos no conjunto de arquivos esquema, contendo uma linha para cada evento de log analisado dos seus controladores CNC, PLC e de robô. Cada linha tem hora do evento, a coluna de identidade máquina (robô para perfis de robô) e as colunas do tipo de log que você selecionou. Para tipos de log que os declaram, o Agente também cria alarmes, ciclos, turnos, intervalos_ociosos e oee_entradas, reconstruído a partir de eventos após cada sincronização. Você pode consultar tudo isso 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.

As linhas analisadas chegam 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, máquina, as próprias colunas do perfil, _arquivo_fonte e _row_idSempre classificar por hora do evento.

MesaO que contém
eventosUma linha por evento analisado, com hora do evento, máquina, as colunas de perfil, _arquivo_fonte e _linha_no.
eventos_linhas_brutasLinhas que não foram analisadas, mantidas como linha com um razão: sem correspondência gramatical, indecodificável, bytes nulos ou número máximo de linhas registradas. Nada é descartado.
alarmes, ciclos, turnos, intervalos_ociosos, oee_entradasReconstruído a partir de eventos após cada sincronização, apenas para tipos de log que os declaram.
cursores de log, registros de instantâneos de log, fontes, ativosContabilidade de motoristas. Um arquivo separado é exibido em cursores de log estacionado com o motivo em último_erro.

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

ONDE OS ARQUIVOS ESTÃO ARMAZENADOSum computador ou compartilhamento de arquivos que o Agente possa abrirSua pastade arquivosOs arquivos permanecem onde estão.Agente de fluxos de consultaAnalisa a pasta e cria tabelas.Em um cache local, executa o SQL.Somente SELECT, aplicado aqui.Fluxos de consultaum link de saídaVerifica quem pode ver o quê; registra todas as consultas.ONDE VOCÊ O UTILIZAqualquer computador, qualquer navegadorExcel · Planilhas Google · NovaClaude · API REST · AutomaçõesVeja as linhas, nunca os arquivos.
O agente lê a pasta em seu próprio computador, armazena as linhas em um cache local criptografado e executa todas as consultas nesse cache. Somente as linhas retornadas por uma consulta são transmitidas, por meio de uma única conexão de saída. Sem necessidade de abrir portas, usar VPN ou fazer upload.

Onde se justifica o seu sustento:

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\pastaO Agente é executado como um serviço, portanto, não consegue ver as unidades mapeadas no seu login (Z: e similares). No Windows, ele pode acessar um compartilhamento com um login armazenado por você; no Linux ou Mac, monte o compartilhamento primeiro (no Linux, em `/usr/local/bin`). /mnt ou /mídia, um Mac sob /Volumes).

Onde o trabalho é realizado? No computador que executa o Agente. Ele examina a pasta, copia as linhas para um cache local criptografado (um esquema, chamado conjunto de arquivose executa todas as consultas nesse cache. Seus arquivos são lidos, nunca modificados, movidos ou carregados.

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 CNC, PLC e controlador de robô: o servidor de arquivos ou qualquer computador sempre ligado que consiga acessar o compartilhamento. Leva apenas 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 registros do seu controlador CNC, PLC e robô.

    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 máquinas 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
    Um caminho por linha, conforme visto pelo computador do Agente. Cada pasta exibe um status (acessível, negado, ausente, inacessível, credenciais inválidas ou não montada) assim que é adicionada. Em um Agente Windows, um compartilhamento que requer login obtém um da pasta. Credencial coluna, armazenada uma única vez por servidor; no Linux ou Mac, monte o compartilhamento primeiro.
    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, clique em Adicionar conector, abrir Arquivos e pastas e escolha o Registros de máquinas 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. Digite um compartilhamento como \\servidor\compartilhamento\pasta, não uma letra de unidade mapeada.
    • Incluir padrões — comece como **/*.registro e **/*.TXTAltere-os se o seu controlador escrever outras extensões.
    • Tipo de registro — Selecione o controlador ou protocolo. A lista é predefinida e não pode ser editada neste cartão; somente Pasta de registro personalizada Permite definir um formato.
    • Nome da tabela — opcional, o padrão é eventos.
    • Aterro (dias) — 30 por padrã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.

    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:

    Eventos por máquina nas últimas 24 horas
    SELECT machine, COUNT(*) AS event_count, MAX(event_time) AS last_event FROM fileset.events WHERE event_time >= now() - INTERVAL 24 HOUR GROUP BY machine ORDER BY event_count DESC LIMIT 100

    Uma linha por máquina, indicando quantos eventos ela registrou e quando o último ocorreu. Uma máquina sem nenhuma linha indica que ela ficou inativa.

    Linhas de alarme para controladores compatíveis
    SELECT * FROM fileset.alarms LIMIT 100

    A tabela de alarmes existe apenas para tipos de log que a declaram, como MTConnect SHDR e syslog do controlador CNC. Comece com SELECT * para ver as colunas que seu perfil fornece.

    Linhas que não foram analisadas, por motivo
    SELECT reason, COUNT(*) AS line_count, MIN(line) AS example_line FROM fileset.events_raw_lines GROUP BY reason ORDER BY line_count DESC LIMIT 100

    Contabiliza as linhas não analisadas por motivo, com um exemplo para cada. Uma contagem alta de linhas sem correspondência gramatical geralmente significa que o tipo de Log escolhido está incorreto.

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

    MesaO que contém
    arquivosTodos 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_eventosO 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, volumesContagem e tamanho das pastas, como elas cresceram e os discos ou compartilhamentos onde as raízes estão localizadas.
    _arquivo_fonte, _row_idDuas 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.

É isso. Coloque um novo arquivo na pasta e, após a próxima verificação, ele estará na tabela. Os arquivos nunca saíram do computador em que estavam.

Acessando um arquivo em um compartilhamento de rede

O Agente abre arquivos como um serviço em segundo plano, não como você, portanto, um arquivo em outro computador requer uma etapa adicional. Qual etapa depende do computador em que o Agente está sendo executado.

Janelas

Digite o caminho da rede, como por exemplo: \\servidor\compartilhamento\pasta, nunca uma letra de unidade mapeada como S:, que o Agente não pode ver. Se o compartilhamento permitir apenas pessoas nomeadas, clique Identidade de serviço (o chip sob o caminho, ou o de uma pasta) Credencial coluna) e armazenar um login para esse servidor: uma conta de domínio da empresa ou uma conta criada no próprio servidor com Domínio deixado em branco. O Agente então se conecta a esse servidor e lê o arquivo lá, e cada conector nesse Agente que lê o mesmo servidor deve usar o mesmo login. Sem um login, ele lê como sua própria conta de serviço, que um domínio corporativo vê como o próprio computador. Passo a passo no Windows

Linux

Os logins de compartilhamento armazenados no Portal não são usados no Linux: primeiro, um administrador monta o compartilhamento no computador do Agente, em uma pasta em /mnt ou /mídia, porque o serviço do Agente não consegue ver /lar ou /executar/usuárioNo conector, mantenha o \\servidor\compartilhamento caminho, que o Agente mapeia para a montagem, ou digite o caminho da montagem, como por exemplo /mnt/fileserver-shared/Contas. Como montar um compartilhamento no Linux

Mac

Os logins de compartilhamento armazenados no Portal não são usados em um Mac: monte o compartilhamento primeiro a partir do Terminal com sudo, em uma pasta sob /Volumes, para que o serviço em segundo plano do Agente possa vê-lo. No conector, mantenha o \\servidor\compartilhamento caminho, que o Agente mapeia para a montagem, ou digite o caminho da montagem, como por exemplo /Volumes/servidor-de-arquivos-compartilhado/Contas. Como montar uma pasta compartilhada no Mac

Se o teste não conseguir acessar a pasta compartilhada, procure por estas palavras no resultado: inalcançável Significa que o computador do agente não recebeu resposta do servidor. No Linux ou no Mac, não montado Significa que o compartilhamento ainda precisa ser montado, e essa mensagem inclui o comando de montagem exato para o seu servidor.

Pastas em uma rede compartilhada? No Windows, um único login abrange todas as pastas adicionadas a partir do mesmo servidor. Acompanhe as alterações na pasta. Funciona também com base no princípio do melhor esforço; a verificação agendada é o que garante que todas as alterações sejam detectadas.

Quando uma pasta não está acessível

Cada pasta no Pastas A etapa exibe um status assim que você a adiciona. Passe o cursor sobre o status para ler a mensagem do agente; as primeiras palavras indicam o caso.

Status ou mensagemO que significaO que fazer
negadoO compartilhamento não permitiu o acesso do Agente. Sem nenhum login armazenado, um Agente do Windows é interpretado como sua conta de serviço, que um domínio corporativo vê como o próprio computador.Windows: clique Identidade de serviço na pasta Credencial coluna e armazene um login que possa ler o compartilhamento ou peça a quem administra o servidor para conceder acesso de leitura ao login armazenado. Linux ou Mac: o compartilhamento está montado, mas suas permissões impedem o acesso do Agente; verifique como ele está montado (Linux, Mac).
credenciais inválidas, ou As credenciais armazenadas para \\server foram recusadasO servidor rejeitou o login armazenado: erro de digitação, domínio incorreto ou senha alterada. O agente aguarda um minuto antes de tentar o login novamente, para que a conta não seja bloqueada.Clique no nome da conta em Credencial coluna e digite o login novamente. Para uma conta criada no próprio servidor, deixe Domínio em branco.
ausenteNão existe pasta nesse caminho. No Windows, um nome de servidor que não pode ser encontrado ou um compartilhamento que o servidor não possui também aparece como ausente.Confira os nomes ou selecione a pasta com Adicionar pasta a partir do agente em vez de digitá-lo.
inalcançável, ou \\o servidor não respondeuSem resposta do servidor: está desligado, o nome está incorreto ou um firewall está bloqueando o compartilhamento de arquivos.Abra o mesmo \\servidor\compartilhamento O caminho no computador do agente. Se isso também falhar, trata-se de um problema de rede.
não montado (Linux ou Mac)O compartilhamento não está montado no computador do Agente. Passe o cursor sobre o status ou sobre o Não montado chip no Credencial coluna, para o comando de montagem exato.Monte a ação (Linux, Mac), depois teste a pasta novamente.
Outro conector neste agente já se conecta ao servidor como…O Windows permite uma conta por servidor de arquivos em cada computador, e outro conector neste Agente usa uma conta diferente.Use o mesmo login desse conector ou altere-o em todos os conectores que leem este servidor.
O Windows já possui um login estabelecido para \\servidor para …Outro dispositivo no computador do Agente está conectado a esse servidor com outra conta, e o Agente nunca fecha uma sessão que não tenha feito.Siga a mensagem: ela indica a conta do Windows sob a qual o Agente é executado e informa se... Use a identidade do serviço leria o compartilhamento através do login existente.
Esta versão do agente não consegue iniciar sessão em \\servidor com as credenciais armazenadas.Um agente antigo que não consegue usar um login de compartilhamento armazenado.Atualize o agente e teste novamente.

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 máquina 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 Máquina.

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 registros do seu controlador CNC, PLC e robô em comparação com um banco de dados no mesmo agente.

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

Arquivos novos e alterados

Em todos os Intervalo de varredura (ou em segundos com Pasta de monitoramento Um novo arquivo que se encaixa no layout tem suas linhas adicionadas e recebe um apareceu evento. Um arquivo modificado é relido em uma transação: suas linhas antigas são removidas, suas novas linhas são inseridas e ele recebe um modificado evento. Os arquivos de log são monitorados à medida que crescem; um arquivo rotacionado mantém seu ID de fluxo.

Arquivos excluídos

Um arquivo que desaparece descarta suas linhas por padrão, ou as mantém marcadas como excluídas se você escolheu a opção de exclusão permanente, e recebe um desapareceu evento. Se mais da metade dos arquivos desaparecerem de uma vez, a verificação é recusada e o inventário anterior é mantido: um compartilhamento offline se parece exatamente com isso.

Arquivos reservados

Um arquivo que não se encaixa no layout, não pode ser aberto ou excede o limite é descartado por completo: nenhuma de suas linhas é carregada e arquivos_eventos recebe um deriva Insira o nome do arquivo na linha e o nome da coluna. Corrija o arquivo e salve-o; a próxima verificação tentará novamente.

Quão fresco é o que eu vejo?

Respostas às consultas da última verificação. Não há botão "Verificar novamente" ou "Sincronizar agora"; o intervalo de verificação, o monitor de pastas e Atualize a página antes de responder à pergunta. São os três controles. MÁXIMO(última_vista_utc) a partir de arquivos_atual Indica quando o agente verificou pela última vez.

O Agente acompanha cada arquivo à medida que ele cresce. Cada arquivo mantém um cursor de byte e de linha, de forma que apenas as novas linhas são lidas em cada varredura, e a última linha parcialmente escrita aguarda a próxima. Um arquivo rotacionado é reconhecido pelos seus primeiros 4 KB e mantém a mesma estrutura. _stream_id, portanto nada é contado duas vezes. Cada .gz O membro é lido uma vez; .zip, .táxi e .jornal Os arquivos são ignorados. A primeira leitura retrocede 30 dias por padrão, com no máximo 64 MiB por arquivo. O recurso "Logs da Máquina" mantém todos os eventos, a menos que você configure para isso. Mantenha os eventos por N diasPara visualizar cada arquivo de log, seu estado e o motivo pelo qual algum deles foi arquivado ou está ilegível, abra o conector. Arquivos diálogo.

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:

ContextoPadrãoO que faz
Profundidade máxima8Quantos níveis de pastas abaixo de cada raiz são verificados (1–64).
Número máximo de arquivos por digitalização100,000Arquivos analisados de uma só vez.
Tamanho máximo do arquivo para gerar o hash32 MiBSó importa com Conteúdo do arquivo hash sobre.
Retenção do registro de eventos30 diasQuanto tempo arquivos_eventos As fileiras são mantidas.
Paralelismo de varredura por raiz2As pastas são lidas de uma só vez por raiz.

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

Quais formatos e perfis de log de máquina são suportados?

O Tipo de registro A lista no cartão de Registros da Máquina abrange registros de controladores CNC, PLC e robôs, incluindo MTConnect SHDR, telemetria chave=valor do PLC e syslog do controlador CNC. Cada perfil possui suas próprias colunas ao lado. máquinaPortanto, verifique a lista no assistente para o seu controlador. Abaixo da lista, você encontrará a seguinte mensagem: “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.”

Recebo tabelas de alarmes, ciclos e OEE para cada máquina?

Não. Apenas os perfis que os declaram constroem. alarmes, ciclos, turnos, intervalos_ociosos e oee_entradasO SHDR e o syslog CNC geram todos os cinco logs. Haas, Okuma, Mitsubishi e vários outros geram apenas alarmes. A telemetria chave-valor não gera nenhum log.

Posso adicionar meu próprio formato?

Não neste cartão. Os perfis da máquina estão bloqueados. Use o Pasta de registro personalizada Em vez disso, você pode descrever o formato no cartão ou clicar em Deixe que Nova sugira um formato.Para um controlador que você acha que deveria estar integrado, abra uma solicitação de suporte.

Com que frequência novas linhas de log aparecem?

Na próxima verificação, a cada hora por padrão em Intervalo de varredura. Ligar Acompanhe as alterações na pasta (quase em tempo real) Para reagir em segundos em um disco local. Uma última linha parcialmente escrita aguarda até ser concluída.

Claude também pode consultar essas tabelas?

Sim. O mesmo conector serve Claude via MCP, somente leitura. Veja Como conectar os registros da máquina CNC ao Claude via MCP.

Meus arquivos foram enviados para algum lugar?

Não. O Agente lê os arquivos em seu próprio computador e armazena as linhas em um cache local criptografado. Uma consulta é executada nesse cache e somente as linhas retornadas saem da máquina, por meio de uma única conexão de saída. Os arquivos nunca são modificados, movidos ou convertidos.

Preciso abrir uma porta ou usar uma VPN?

Não. O agente faz uma conexão de saída na porta 443 e tanto as requisições quanto as linhas trafegam por ela. Se o HTTPS de saída funcionar, isso funciona.

A pasta pode estar em um compartilhamento de rede, no OneDrive ou no Dropbox?

Sim. Digite uma ação como \\servidor\compartilhamento\pastaIsso ocorre porque o Agente é executado como um serviço e não consegue visualizar as unidades mapeadas no seu login. No Windows, armazene um login para o servidor se o compartilhamento permitir acesso apenas a pessoas nomeadas; sem um login, o Agente o reconhecerá como sua própria conta de serviço. No Linux ou Mac, monte o compartilhamento primeiro. Uma pasta sincronizada do OneDrive ou Dropbox funciona quando seus arquivos estão armazenados no computador: defina a pasta para Mantenha sempre este dispositivo ligado.O agente não baixa arquivos exclusivos da nuvem.

A pasta contém mais de um tipo de arquivo. Um conector ou dois?

Um conector lê um tipo de arquivo. Uma pasta com arquivos CSV e Parquet requer dois conectores na mesma raiz, um para cada tipo. Arquivos que não correspondem ao padrão de inclusão são ignorados, não armazenados separadamente.

Existe um botão "Reescanear"?

Não. O agente realiza a varredura no Intervalo de varredura, reage às mudanças quando Pasta de monitoramento Está ativado e pode realizar uma nova verificação antes de responder a uma consulta quando você o habilita. Edite o conector para alterar qualquer uma das três opções.

O plano gratuito realmente cobre isso?

Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Os conectores de pastas não possuem limite de arquivos próprio; as linhas são contabilizadas no seu Data Realm como qualquer outro conector. Veja o que cada plano inclui na página de detalhes do plano. página de preços.

Outras pastas que o Query Streams transforma em tabelasComo consultar uma pasta de arquivos com SQLTodos os guias do FileSet
Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.

Todos os guias para Machine Logs

Não é bem a sua configuração?

  • O formato do seu log não é um dos tipos de log predefinidos? A Pasta de Log Personalizada permite que você descreva o formato você mesmo → Custom Logs
  • São listas de peças e padrões de corte do CutRite, em vez de dados de saída da máquina? O arquivo CSV com vários registros os lê → Multi-record

Problemas com a configuração?

  • O agente diz que o arquivo ou pasta não existe ou que o acesso foi negado? Unidades mapeadas, compartilhamentos de rede, OneDrive e pastas pessoais do Linux precisam de uma correção → De onde o Agente pode ler arquivos
  • O agente está offline ou as opções Testar conexão e Navegar estão desativadas? Verifique se o agente está online → O agente está online?
Atualizado em novembro 9, 2026

Desenvolvido por BetterDocs