Analyse personnalisée des journaux avec SQL : analyser n’importe quel journal texte

Connecteur de dossiers · Journaux personnalisés

Transformez n'importe quel journal de texte que vous décrivez en Tables SQL vous pouvez interroger n'importe où

Configurez l'agent Query Streams pour qu'il pointe vers le dossier. Il lit les fichiers journaux sur son ordinateur, crée les tables dans un cache local et les maintient à jour en fonction des fichiers ajoutés, modifiés ou supprimés. Vous pouvez ensuite les interroger depuis Excel, Google Sheets, Nova, Claude ou l'API REST. Aucun fichier n'est téléchargé, converti ou modifié.

Environ 15 minutes Aucun codage nécessaire Les fichiers restent sur votre réseau Le forfait gratuit le couvre

Ce que vous obtiendrez

Le dossier de journalisation personnalisé sert à enregistrer tout journal texte que les cartes intégrées ne reconnaissent pas. Vous décrivez le format une seule fois, ou laissez Nova en suggérer un, et chaque ligne devient une ligne dans un tableau nommé événementsTant que vous n'avez pas défini de colonnes, chaque ligne correspond à la ligne. message étiqueté avec le nom de fichier Les lignes dont le format ne correspond pas sont conservées dans un tableau de lignes brutes avec la raison de cette conservation, évitant ainsi toute perte de données. Vous pouvez interroger ces lignes avec SQL depuis Excel, Google Sheets ou un tableau de bord, tandis que les fichiers restent sur l'ordinateur exécutant l'agent.

Les lignes analysées atterrissent dans ensembles de fichiers.événements, ou dans le Nom de la table Vous avez fait votre choix. L'agent copie les lignes dans un cache local sur son ordinateur et les sert au format SQL.

Chaque connecteur de dossier vous offre également fichiers, fichiers_événements, annuaires, instantanés_de_répertoire et volumeset les connecteurs de journalisation ajoutent curseurs de journalisation avec la position de lecture de chaque fichier. Toujours TRIER PAR heure_événement.

Là où elle gagne sa vie :

• Interroger le journal d'une application interne dans une feuille de calcul sans écrire d'analyseur syntaxique.
• Visualisez les erreurs des traitements par lots nocturnes sur un tableau de bord à partir d'un journal en texte brut.
• Conservez les journaux de texte d'un appareil ancien consultables avec SQL, au même titre que vos autres données.

Ce dont vous aurez besoin

Un compte Query Streams

Les connecteurs de dossiers sont inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit est permanent, et non une période d'essai. Le nombre de fichiers qu'un dossier peut contenir est illimité.

L'Agent, version 2.6.0 ou ultérieure

Installé sur un ordinateur capable d'ouvrir le dossier : le serveur de fichiers lui-même, un ordinateur de bureau ou la machine sur laquelle les fichiers sont stockés. Une version plus ancienne d'Agent affiche les fiches de dossier grisées avec un Agent 2.6.0+ badge. Windows, Mac ou Linux.

Le chemin du dossier, tel que l'agent le voit

Un chemin local, ou un partage réseau écrit comme \\serveur\partage\dossier. 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édias, a Mac under /Volumes).

Configurez-le en cinq étapes

1. Installez l'agent sur un ordinateur capable d'ouvrir le dossier.

   Connectez-vous, ouvrez TéléchargerInstallez ensuite l'agent sur l'ordinateur capable d'ouvrir les journaux texte que vous décrivez : le serveur de fichiers ou tout ordinateur toujours allumé ayant accès au partage. L'installation prend une minute et s'effectue ensuite automatiquement. La version 2.6.0 ou ultérieure est requise ; la page de téléchargement propose toujours la version la plus récente.

   Pourquoi un petit programme plutôt qu'un pilote ? L'agent s'installe en une seule étape sur Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux). Il établit une connexion sortante chiffrée vers Query Streams, unique chemin réseau nécessaire : aucun port entrant ni VPN ne sont requis. Il lit le répertoire sur lequel il est installé ; les fichiers restent donc en place et seules les lignes renvoyées par une requête transitent par Internet vers l'extension, le navigateur ou le client d'IA installé sur votre serveur.

   La page de téléchargement affiche Votre clé d'accèsCollez-le dans l'Agent lorsqu'il vous le demande, et attendez que le badge affiche Connecté aux flux de requêtesC'est la seule chose que vous ferez sur l'ordinateur de l'agent ; tout le reste se passe dans votre navigateur.

   Des guides complets sont disponibles si vous le souhaitez : Fenêtres, Mac, Linux.

2. Pointez-le vers n'importe quel journal de texte que vous décrivez

   Retournez dans votre navigateur ouvert Données → Agents de donnéesTrouvez l'agent que vous venez d'installer et cliquez dessus. Ajouter un connecteur bouton. Ouvrez le Fichiers et dossiers pilule et choisir le Dossier journal personnalisé carte. Vous ne savez pas quelle carte convient ? Choisissez Fichiers dans un dossier En revanche : l’agent examine le dossier, indique son contenu sur une page « Ce que nous avons trouvé » et ouvre pour vous la fiche correspondante, préremplie.

   Le magicien court Dossiers → Vérifier → Paramètres → Domaine → Consulter. Sur Dossiers:

   Dossiers racine

   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.

   Analyser les sous-dossiers, profondeur maximale

   Activé, et 8 niveaux, par défaut.

   Inclure des motifs, exclure des motifs

   Quels fichiers sont pris en compte ? Le modèle d'inclusion commence par le bon glob pour cette carte. Un connecteur lit un seul type de fichier : un dossier contenant des fichiers CSV. et Les fichiers Parquet comportent deux connecteurs sur le même dossier, un par type.

   Suivez les liens symboliques et les jonctions

   Désactivé par défaut. L'agent ne suit pas les raccourcis ni les espaces réservés dans le cloud, sauf si vous activez cette option.

   Dans le portail, ouvrez l'agent qui peut voir le dossier et cliquez sur Ajouter un connecteur. Sous Fichiers et dossiers prendre Dossier journal personnaliséUne fois créé, il apparaît dans la liste des connecteurs comme Fichiers journaux.

   • Ajoutez le dossier sous Dossiers racineSaisissez un partage réseau comme \\serveur\partage\dossier, et non pas comme une lettre de lecteur mappée.
   • Ensemble Inclure des motifs pour correspondre à vos fichiers. Les valeurs par défaut du pilote de journalisation sont : **/*.enregistrer et **/*.SMS.
   • Décrivez le format. Le dossier de journal personnalisé est la seule fiche de journal que vous pouvez modifier : indiquez l’emplacement de l’horodatage sur une ligne et les éléments qui deviennent des colonnes. Ou cliquez Laissez Nova suggérer un format qui a un plafond journalier.
   • Nom de la table est facultatif et par défaut événements.
   • Remblai (jours) a 30 ans. Conserver les événements pendant N jours conserve tout sauf si vous le configurez.

   Si votre format est courant, la liste indique également : « Vous avez besoin d’un type de journal qui n’est pas répertorié ? Ouvrez une demande d’assistance et nous l’ajouterons en quelques jours. »

3. Vérifiez ce que cela va construire

   Sur Vérifier L'agent lit un échantillon de 64 fichiers maximum et affiche ce qu'il va créer. Rien n'est encore créé. Le bouton affiche : Test de connexion jusqu'à ce qu'un verdict soit rendu, alors Suivant; Réessayer L'échantillon est relancé après toute modification. Vous verrez l'un des quatre titres suivants :

   Prêt à créer

   Chaque fichier échantillonné est correctement formaté. Les puces situées en dessous indiquent le nombre de dossiers accessibles, le nombre de fichiers et de lignes, ainsi que les tables présentes.

   Prêt, avec notes

   Certains fichiers seront mis de côté, ou leur mise en page sera refusée. Une bannière orange indique précisément lesquels : « {n} des {m} fichiers seront mis de côté » avec un Afficher les fichiers concernés et pourquoi liste, et « Vous pouvez le créer quand même — le connecteur continuera à vérifier et indiquera la raison dans son onglet Manifeste. »

   Ces fichiers ne sont pas de ce type de journal.

   L'échantillon n'a pas pu être analysé au format de journal de cette carte. Vérifiez que vous avez sélectionné la bonne carte ou utilisez la Dossier journal personnalisé carte et décrivez le format.

   Un refus ou un fichier mis de côté ne vous bloque jamais : cliquez SuivantTerminez l'assistant et corrigez les fichiers problématiques ultérieurement. Seul un agent hors ligne ou un dossier manquant peut interrompre l'assistant.

   Sur VérifierL'agent lit un échantillon et affiche ce qu'il va créer. Rien n'est encore créé. Si l'échantillon ne correspond pas au format décrit, le titre s'affiche. Ces fichiers ne sont pas suivi du type, et une bannière ambre indique « La détection du schéma a refusé », avec la raison. Ouvrir Afficher les fichiers concernés et pourquoi Pour afficher le fichier et la grille de justification, ajustez le format ou resserrez-le. Inclure des motifs donc les fichiers isolés sont laissés de côté, alors RéessayerVous pouvez aussi le créer quand même. Le connecteur vérifie régulièrement et indique la raison sur son… Manifeste tabulation et lignes qui ne correspondent pas à la terre dans lignes_brutes_événements où vous pouvez les lire et en affiner le format.

4. Choisissez la fréquence d'analyse, puis créez-le

   Les valeurs par défaut sur Paramètres Convient à un dossier qui reçoit quelques fichiers par jour. Quatre éléments que vous pourriez vouloir modifier :

   Intervalle de balayage

   Toutes les heures Par défaut, la fréquence est paramétrable ; vous pouvez choisir une fréquence de 5 minutes à une fréquence quotidienne. Chaque analyse compare la taille et la date de modification des fichiers afin de détecter les fichiers nouveaux, modifiés et supprimés.

   Surveillez le dossier pour détecter les modifications (quasi en temps réel).

   Désactivé par défaut. Activé, l'agent réagit en quelques secondes sur les disques locaux ; sur les partages réseau, il fonctionne au mieux et l'analyse planifiée reste la seule garantie. période calme (15 secondes) attend la fin de l'écriture d'un fichier.

   Actualisez la page avant de répondre à une question.

   Désactivé par défaut. Activé, une requête effectue une nouvelle analyse lorsque la dernière analyse est antérieure à la date de début. fenêtre de vieillissement (60 secondes), en attendant au maximum le limite d'attente des requêtes (5 secondes). Cela s'applique aux personnes et aux modules complémentaires, et non aux sondages d'alerte.

   Lorsqu'un fichier disparaît

   Supprimez ses lignes par défaut, ou Conserver les lignes, marquer les lignes supprimées (pierre tombale). Le Ratio de garde d'effacement (0.5) refuse une analyse qui perd plus de la moitié des fichiers à la fois et conserve l'inventaire précédent, ce à quoi ressemble un partage hors ligne.

   Ensuite, choisissez le Domaine des données les lignes sont comptabilisées, vérifiez Revoir et cliquez Créer un connecteurLe premier scan démarre immédiatement. Le connecteur Manifeste L'onglet affiche ce qu'il a construit et tous les fichiers qu'il a mis de côté.

5. Regardez vos tables

   Ouvrez le connecteur : le Manifeste L'onglet liste les tables qu'il a créées et le Fichiers La boîte de dialogue affiche la liste de chaque fichier journal avec son état. Générateur de requêtes les mêmes tables se trouvent sous le ensemble de fichiers schéma. Trois requêtes fonctionnelles dès le premier jour :

   Dernières lignes avec le fichier dont elles proviennent

   SELECT event_time, file_name, message FROM fileset.events ORDER BY event_time DESC LIMIT 100

   Les 100 enregistrements les plus récents de chaque fichier du dossier. Fonctionne avant même de définir les colonnes.

   Lignes mentionnant une erreur, par fichier, au cours de la dernière journée

   SELECT file_name, COUNT(*) AS errors FROM fileset.events WHERE message ILIKE '%error%' AND event_time >= now() - INTERVAL 1 DAY GROUP BY file_name ORDER BY errors DESC LIMIT 100

   Une correspondance de texte sur messageUne fois que votre format définit une colonne de niveau, filtrez plutôt sur celle-ci.

   Certaines lignes ne correspondent pas à votre format, pour la raison

   SELECT reason, COUNT(*) AS lines, MIN(line) AS example FROM fileset.events_raw_lines GROUP BY reason ORDER BY lines DESC

   Lectures lignes_brutes_événementsUtilisez les exemples pour affiner le format, puis enregistrez le connecteur et l'agent rééchantillonne.

   Chaque connecteur de dossier utilise également les mêmes tables de comptabilité, le tout dans le ensemble de fichiers schéma:

   Tableau	Ce qu'il contient
   fichiers	Chaque fichier actuellement présent dans le dossier : chemin, nom, extension, taille, dates de création et de modification, première et dernière consultation. Vue d'ensemble fichiers_actuels, qui conserve également les fichiers disparus.
   fichiers_événements	L'historique des modifications : une ligne par fichier. apparu, était modifié, disparu, a été mis de côté (dérive) ou était refusé, avec le temps en événement_à, comment cela a été remarqué dans détecté par et la raison dans détail.
   annuaires, instantanés_de_répertoire, volumes	Nombre et taille des dossiers, leur évolution et les disques ou partages sur lesquels résident les fichiers racines.
   _fichier_source, _row_id	Deux colonnes par ligne de données : le fichier d’origine et un identifiant unique au sein de ce fichier. Grouper par _fichier_source comparer les fichiers.

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 Dossiers 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.

Utilisez-le partout

Le connecteur est une source de données comme une autre dans Query Streams. Enregistrez une requête une seule fois dans le Générateur de requêtes (le dialecte est DuckDB) et utilisez-le depuis :

Excel

Les modules complémentaires Diffuser une requête Insère les lignes dans une feuille et se relance en un clic. Exécuter du SQL dans Excel.

Google Sheets

Le Flux de requêtes Le module complémentaire remplit un onglet que vous sélectionnez. Power Query pour Google Sheets.

Claude, Cursor et autres clients IA

Par l'intermédiaire du serveur MCP Query Streams, Claude connaît le modèle de dossiers, y compris _fichier_source et fichiers_événements. Journalisation personnalisée avec Claude via MCP.

API REST

Chaque requête enregistrée devient un point de terminaison en lecture seule avec sa propre clé, sur chaque forfait. API REST des journaux personnalisés.

Nova

Posez des questions claires et concises sur le plan d'affaires ; Nova connaît chaque dossier, tableau et colonne grâce à ses descriptions intégrées.

Automatisations

Synchronisez les lignes avec Airtable, Smartsheet, Baserow, SeaTable ou une feuille de calcul selon un calendrier prédéfini. Guides d'automatisation.

Les tables de dossiers sont également liées à vos autres connecteurs : une requête fédérée peut correspondre _fichier_source noms ou identifiants de commande dans tout journal de texte que vous décrivez par rapport à une base de données sur le même agent.

Affichage des fichiers nouveaux, modifiés et supprimés

Fichiers mis de côté

Trois mots apparaissent à l'étape « Vérifier » et dans l'onglet « Manifeste ». Ils ont des significations différentes :

Mettre de côté (stationné)

Le fichier ne correspond pas à la mise en page définie, ou est illisible, déchiré, verrouillé ou masqué. Chaque fichier est traité de manière binaire : un fichier mis en attente ne contribue à aucune ligne. fichiers_événements enregistre un dérive rangée dont détail Le nom du fichier et de la colonne est indiqué. Le fichier est ignoré tant que sa taille et sa date de modification restent inchangées, et une nouvelle tentative est effectuée dès que ces informations sont modifiées.

Illisible

L'agent n'a pas pu ouvrir ni analyser le fichier en raison de son type : il ne s'agit pas d'un classeur valide, il est verrouillé par un autre programme, il s'agit d'un espace réservé dans le cloud ou il contient des octets indéchiffrables. Il se met en pause et le reste du dossier est traité. Seul un dossier ne contenant aucun fichier lisible refuse l'ensemble du traitement.

Refusé

L'agent n'a pu épingler aucune mise en page, par exemple parce que les fichiers ne définissent pas le type d'une colonne. Aucune table de données n'existe encore. fichiers_événements obtient un refusé dispute avec la raison dans détailL'agent effectue une nouvelle tentative à chaque analyse jusqu'à ce qu'une configuration soit trouvée. Corrigez ou excluez le fichier mentionné pour que le message disparaisse.

Où regarder : la bannière ambrée sur Vérifier (Afficher les fichiers concernés et pourquoi), le connecteur Manifeste onglet ensuite, et pour les connecteurs de journalisation, Fichiers boîte de dialogue, qui liste les fichiers mis en attente avec la raison dans dernière_erreurEn SQL : SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') TRIER PAR event_at DESC.

Des limites qu'il vaut la peine de connaître

Il n'y a pas de limite au nombre de dossiers ni de fichiers. Les lignes sont comptabilisées dans votre espace de données, comme pour tout autre connecteur. Vous pouvez modifier les valeurs par défaut du connecteur.

Limites de contenu, qui consistent à stocker un fichier plutôt qu'à le tronquer : 2 000 000 lignes ou 512 Mio par fichier, 10 000 000 lignes ou 2 Gio par analyse. Un dossier peut contenir au maximum 25 agencements différents. Une table par mise en page mode.

Questions que se posent les gens

• Système de fichiers
• Dossier CSV
• Dossier en parquet
• Dossier Excel
• Dossier SQLite
• Dossier JSONL
• Fichier CSV multi-enregistrements
• Journaux de machines
• Journaux du serveur Web
• Journaux de conteneurs
• Journaux d'application
• Journaux système