Interroger les journaux nginx, Apache et IIS avec SQL

Connecteur de dossiers · Journaux Web

Transformez vos journaux d'accès nginx, Apache, IIS ou Caddy 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

Vous finissez par avoir une table appelée événements dans le ensemble de fichiers schéma contenant une ligne par requête provenant de vos journaux d'accès nginx, Apache, IIS ou Caddy. Avec le profil combiné nginx et Apache, les colonnes sont site, adresse IP du client, authentification, méthode, chemin, http_version, statut, octets, référent et agent, plus heure_événementVous pouvez l'interroger avec SQL depuis Excel, Google Sheets, un tableau de bord ou tout outil compatible avec Query Streams. Les fichiers journaux restent toujours sur l'ordinateur où l'agent est exécuté.

Les demandes atterrissent dans événements, ou le Nom de la table Vous définissez. Chaque rangée contient _stream_id (un par fichier journal, conservé au fil des rotations), _ligne_no, heure_événement, event_time_raw, la colonne d'identité site, les colonnes de requête du profil, _fichier_source et _row_idLa chaîne du navigateur se trouve dans agentLes journaux IIS W3C conservent leurs propres noms, tels que : c_ip, cs_method, tige cs_uri et sc_statusToujours trier par heure_événement.

Chaque connecteur de dossier vous offre également fichiers, fichiers_événements, annuaires, instantanés_de_répertoire et volumes.

Là où elle gagne sa vie :

• Suivez les taux 4xx et 5xx par chemin dans un tableau de bord actualisé à chaque analyse.
• Importez une semaine de trafic nginx ou IIS dans Google Sheets pour obtenir un rapport rapide.
• Identifiez les adresses IP des clients qui envoient le plus de requêtes sans transmettre les journaux à un service tiers.

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'accéder aux journaux d'accès nginx, Apache, IIS ou Caddy : le serveur de fichiers ou tout autre ordinateur toujours allumé pouvant accéder 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. Indiquez-lui d'accéder aux journaux d'accès de votre serveur nginx, Apache, IIS ou Caddy.

   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 Journaux du serveur Web 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.

   Sur l'agent qui peut ouvrir le dossier des journaux, cliquez Ajouter un connecteur, ouvrir Fichiers et dossiers et choisissez le Journaux du serveur Web carte. Une fois enregistrée, elle apparaît dans la liste des connecteurs sous forme de Fichiers journaux.

   • Description — un nom pour le connecteur.
   • Dossiers racine — les dossiers sur l'ordinateur de l'agent, un par ligne. Saisissez un partage comme \\serveur\partage\dossier, et non une lettre de lecteur mappée.
   • Inclure des motifs — commencer comme **/access*.log*, **/error*.log* et **/*.enregistrer.
   • Type de journal — Choisissez le profil correspondant à votre serveur. Les colonnes diffèrent selon le profil ; utilisez donc un connecteur par format de journal. La liste est intégrée ; Dossier journal personnalisé vous permet de définir un format.
   • Nom de la table — facultatif, par défaut événements.
   • Remblai (jours) — 30. Conserver les événements pendant N jours — 60.

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.

   Si l'échantillon ne correspond pas au type de journal que vous avez sélectionné, le Vérifier L'en-tête indique « Ces fichiers ne sont pas » suivi du type. Ouvrir Rapport complet de l'agent Pour en connaître la raison, choisissez-en un autre. Type de journal et cliquez RéessayerUn refus ou une mise de côté de fichiers ne vous empêche pas de cliquer : vous pouvez toujours cliquer Suivant et créer le connecteur. Il vérifie en permanence et signale la raison sur son Manifeste languette.

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 :

   Principaux chemins d'accès ayant renvoyé une erreur 404 au cours des 7 derniers jours

   SELECT path, COUNT(*) AS hits FROM fileset.events WHERE status = 404 AND event_time >= now() - INTERVAL 7 DAY GROUP BY path ORDER BY hits DESC LIMIT 20

   Voici les pages manquantes les plus demandées cette semaine. Copiez-collez cette requête dans une feuille de calcul ou Excel ; elle se mettra à jour à chaque analyse.

   Adresses IP des clients derrière des erreurs 5xx, avec octets servis

   SELECT client_ip, COUNT(*) AS error_count, SUM(bytes) AS total_bytes, MAX(event_time) AS last_seen FROM fileset.events WHERE status >= 500 GROUP BY client_ip ORDER BY error_count DESC LIMIT 100

   Identifiez les clients rencontrant le plus souvent des erreurs serveur et la date de leur dernière connexion. Ajoutez un filtre sur l'agent pour distinguer les bots des navigateurs.

   Quels fichiers journaux ont été archivés ou mis de côté cette semaine ?

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

   Historique des fichiers de la semaine : rotations, troncatures et tout fichier mis de côté, avec la raison détaillée.

   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. Blogs Web 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 Web.

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 vos journaux d'accès nginx, Apache, IIS ou Caddy 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 de conteneurs
• Journaux d'application
• Journaux système
• Journaux personnalisés