Categorieën bekijken

Query Docker-containerlogboeken met SQL

ContainerlogboekenGratis planQuery-stromenSQL-tabellen

Map met containerlogs → SQL-tabellen · met Query Streams

Met Query Streams worden uw Docker-containerlogs alleen-lezen SQL-tabellen: de logs blijven waar ze zijn, de Agent op die computer leest nieuwe regels terwijl de bestanden groeien en slaat ze op in een versleutelde lokale cache, en er wordt niets geüpload of gewijzigd. De eerste keer ongeveer vijftien minuten, en het Free-abonnement dekt dit.

Begin gratis
Isometrische stapel van drie bestandsbladen die met één lijn zijn verbonden met één tabeltegel
Loop je ergens vast? Vraag het ons gerust. Open Ondersteuning Ga naar Query Streams (menu rechtsboven → Ondersteuning) en stuur ons een bericht. Echte mensen lezen het, en "Ik weet niet wat er op dit scherm wordt gevraagd" is een volkomen terechte vraag.

Wat je uiteindelijk overhoudt

ContainerlogboekpictogramJe krijgt uiteindelijk een tabel genaamd evenementen in de bestandenset schema, met één rij per regel uit je Docker-logs. Met het Docker json-file profiel zijn de kolommen app (de containernaam), stroom, niveau, logger, bericht, gastheer, dienst en gegevens, plus afbeelding, compose_project, compose_service, container_id en event_timeJe kunt de logbestanden opvragen met SQL vanuit Excel, Google Sheets, een dashboard of elke andere tool die Query Streams ondersteunt. De logbestanden verlaten nooit de computer waarop de agent draait. Dit is niet Docker's MCP Toolkit en het voert geen containers uit of beheert ze niet; het leest alleen hun logbestanden.

Lijnen komen aan in evenementen, of de Tabelnaam u stelt in. Elke rij bevat _stream_id (één per logbestand, bewaard gedurende rotaties), _regelnummer, event_time, event_time_raw, de identiteitskolom app, de kolommen van het profiel, _bronbestand en _rij_id. Altijd sorteren op event_time.

TafelWat het bevat
evenementenEén rij per logregel, met event_time, app, stroom, bericht, de andere profielkolommen, _bronbestand en _regelnummer.
gebeurtenissen_ruwe_lijnenRegels die niet correct zijn verwerkt, zijn behouden als lijn met een redenGeen grammatica-overeenkomst, oncodeerbaar, nul-bytes of record-max-regels. Niets wordt weggegooid.
log_cursors, log_snapshot_records, bronnen, activaBoekhouding van chauffeurs. Een apart gezet dossier toont in log_cursors geparkeerd met de reden in laatste_fout.

Elke mapconnector biedt u ook de mogelijkheid om... bestanden, bestanden_gebeurtenissen, mappen, map_snapshots en volumes.

WAAR DE BESTANDEN ZICH BEVINDENeen computer of bestandsdeling die de Agent kan openenUw mapvan bestandenbestanden blijven waar ze zijnQuery Streams Agentscant de map, bouwt tabellenin een lokale cache, voert de SQL uitAlleen SELECT, hier afgedwongenQuery-stromenéén uitgaande linkcontroleert wie wat mag zien · registreert elke zoekopdrachtWAAR JE HET GEBRUIKTelke computer, elke browserExcel · Google Sheets · NovaClaude · REST API · Automatiseringenzie de rijen, nooit de bestanden
De agent leest de map op zijn eigen computer, bewaart de rijen in een versleutelde lokale cache en voert elke query uit op die cache. Alleen de rijen die een query retourneert, worden via één uitgaande verbinding verzonden. Geen poort openen, geen VPN, geen upload.

Waar het zijn nut bewijst:

Wat je nodig hebt

Een Query Streams-account

Mapkoppelingen zijn beschikbaar in alle abonnementen, ook in het gratis abonnement. Het gratis abonnement is een abonnement dat je behoudt, geen proefperiode die verloopt. Er is geen limiet aan het aantal bestanden dat een map kan bevatten.

De Agent, versie 2.6.0 of later

Geïnstalleerd op een computer die de map kan openen: de bestandsserver zelf, een kantoorcomputer of de machine waarop de bestanden terechtkomen. Een oudere versie van Agent toont de mapkaarten grijs weergegeven met een Agent 2.6.0+ badge. Windows, Mac of Linux.

Het pad van de map, zoals de agent het ziet.

Een lokaal pad, of een netwerkshare die als volgt is geschreven: \\server\share\folderDe agent draait als een service, waardoor hij geen toegang heeft tot de schijven die u bij uw aanmelding hebt toegewezen (zoals Z:). Op Windows kan de agent zich aanmelden bij een gedeelde map met een door u opgeslagen gebruikersnaam; op Linux of een Mac moet u de gedeelde map eerst koppelen (Linux onder /mnt of /mediaeen Mac onder /Volumes).

Waar vindt het werk plaats? Op de computer waarop de agent draait, scant deze de map en kopieert de rijen naar een versleutelde lokale cache (één schema, genaamd...). bestandenset) en voert elke query uit op die cache. Uw bestanden worden gelezen, nooit gewijzigd, verplaatst of geüpload.

Stel het in vijf stappen in.

  1. Installeer de agent op een computer die de map kan openen.

    Aanmelden, openen DownloadInstalleer de agent voor uw systeem op de computer die de logbestanden van uw Docker-container kan openen: de bestandsserver of een andere computer die altijd aan staat en toegang heeft tot de gedeelde map. Dit duurt een minuut en start daarna automatisch. U hebt versie 2.6.0 of hoger nodig; de meest recente versie is altijd beschikbaar op de downloadpagina.

    Waarom een klein programma in plaats van een driver? De agent is een eenmalige installatie voor Windows, Mac of Linux (ongeveer 85 MB op Windows, iets meer dan 100 MB op Mac en Linux). Het opent één versleutelde uitgaande verbinding met Query Streams en dat is het enige netwerkpad dat nodig is: geen inkomende poort om te openen, geen VPN. Het leest de bestanden in de map waarin het zich bevindt, waardoor de bestanden op hun plaats blijven en alleen de rijen die een query retourneert via internet naar de add-in, browser of AI-client aan uw kant worden verzonden.

    De downloadpagina toont Uw toegangssleutelPlak het in de Agent wanneer daarom wordt gevraagd en wacht tot de badge is weergegeven. Verbonden met querystreamsDat is het enige wat je op de computer van de agent doet; al het andere gebeurt in je browser.

    Complete walkthroughs zijn beschikbaar als je die wilt: Windows, Mac, Linux.

  2. Richt het op de logbestanden van je Docker-container.

    Ga terug naar uw browser Gegevens → GegevensagentenZoek de agent die je zojuist hebt geïnstalleerd en klik erop. Connector toevoegen knop. Open de Bestanden en mappen pil en kies de Containerlogboeken kaart. Weet je niet zeker welke kaart past? Kies Bestanden in een map In plaats daarvan: de agent neemt een steekproef van de map, benoemt de inhoud op een pagina 'Wat we hebben gevonden' en opent de juiste, vooraf ingevulde kaart voor u.

    De tovenaar rent Mappen → Controleren → Instellingen → Realm → Controleren. Op Mappen:

    Hoofdmappen
    Eén pad per regel, zoals de computer van de agent het ziet. Elke map toont een status (bereikbaar, geweigerd, ontbreekt, onbereikbaar, ongeldige referenties of niet gekoppeld) zodra u deze toevoegt. Op een Windows-agent krijgt een share waarvoor een aanmelding nodig is, deze van de map. Referentie kolom, eenmaal per server opgeslagen; op Linux of een Mac moet u eerst de gedeelde map koppelen.
    Scan submappen, maximale diepte
    Aan, en standaard 8 niveaus.
    Patronen opnemen, patronen uitsluiten
    Welke bestanden tellen mee? Het include-patroon begint met de juiste glob voor deze kaart. Eén connector leest één bestandstype: een map met CSV-bestanden. en Parquet-bestanden hebben twee connectors in dezelfde map, één per bestandstype.
    Volg symbolische links en junctions
    Standaard uitgeschakeld. De agent volgt geen snelkoppelingen of cloud-placeholders, tenzij u deze functie inschakelt.

    Klik op de agent die de Docker-logmap kan openen. Connector toevoegen, open Bestanden en mappen en kies de Containerlogboeken kaart. Na het opslaan verschijnt deze in de connectorlijst als Logbestanden.

    • Beschrijving — een naam voor de connector.
    • Hoofdmappen — de mappen op de agentcomputer, één per regel. Op Linux koppelt u gedeelde mappen onder /mnt of /media.
    • Voeg patronen toe — begin als **/*-json.log, **/*.log en **/*.log.*.
    • Logtype — kies het profiel voor uw bestanden. De lijst is ingebouwd; alleen Aangepaste logmap Hiermee kunt u een formaat definiëren.
    • Tabelnaam — optioneel, standaardwaarde evenementen.
    • Aanvulling (dagen) — 30. Bewaar evenementen gedurende N dagen. — 30.
  3. Bekijk wat het zal bouwen

    Op Rekening De agent leest een voorbeeld van maximaal 64 bestanden en laat zien wat er gebouwd zal worden. Er is nog niets aangemaakt. De knop geeft de volgende tekst weer: Testverbinding totdat er een vonnis is, dan Volgende; Test opnieuw Het voorbeeld wordt opnieuw uitgevoerd nadat u iets hebt gewijzigd. U ziet dan een van de vier volgende kopteksten:

    Klaar om te creëren
    Elk geselecteerd bestand past. De chips eronder geven aan hoeveel mappen bereikbaar waren, hoeveel bestanden en rijen er waren en welke tabellen er aanwezig waren.
    Klaar, met aantekeningen.
    Sommige bestanden worden opzijgezet, of de lay-outcontrole wordt geweigerd. Een oranje banner geeft precies aan welke: "{n} van {m} bestand(en) worden opzijgezet" met een Geef aan welke bestanden het betreft en waarom. lijst, en "Je kunt het sowieso aanmaken - de connector blijft controleren en rapporteert de reden op het tabblad Manifest."
    Deze bestanden zijn niet van dit logtype.
    Het voorbeeld werd niet herkend als het logformaat van deze kaart. Controleer of u de juiste kaart hebt geselecteerd, of gebruik de volgende methode. Aangepaste logmap beschrijf de kaart en het formaat ervan.

    Een weigering of het terzijde leggen van bestanden blokkeert je nooit: klik hier. VolgendeVoltooi de wizard en repareer de afwijkende bestanden later. Alleen een offline agent of een ontbrekende map stopt de wizard.

    Als het voorbeeld niet overeenkomt met het logtype dat u hebt geselecteerd, dan... Rekening De kop luidt: "Deze bestanden zijn niet" gevolgd door het bestandstype. Openen Volledig rapport van de agent Om de reden te zien, kies een andere. Logtype en klik Test opnieuwEen afwijzing of het terzijde leggen van bestanden houdt u niet tegen: u kunt nog steeds klikken. Volgende en de connector aan te maken. Het blijft controleren en rapporteert de reden. Manifest tab.

  4. Kies hoe vaak er gescand moet worden en maak het vervolgens aan.

    De standaardinstellingen op Instellingen Geschikt voor een map die dagelijks een paar bestanden ontvangt. Vier zaken die je wellicht wilt wijzigen:

    Scaninterval
    Elk uur Standaardinstelling; kies een frequentie van elke 5 minuten tot dagelijks. Elke scan vergelijkt de grootte en de wijzigingstijd om nieuwe, gewijzigde en verdwenen bestanden te vinden.
    Houd de map in de gaten voor wijzigingen (vrijwel in realtime).
    Standaard uitgeschakeld. Ingeschakeld reageert de agent binnen enkele seconden op lokale schijven; op netwerkshares werkt deze naar beste vermogen en blijft de geplande scan de garantie. Rustperiode (15 seconden) wacht tot het schrijven van een bestand is voltooid.
    Vernieuw de pagina voordat u een vraag beantwoordt.
    Standaard uitgeschakeld. In deze stand wordt een zoekopdracht eerst opnieuw uitgevoerd als de laatste scan ouder is dan de ingestelde waarde. Verouderingsvenster (60 seconden), wachtend op maximaal de Wachtlimiet voor query's (5 seconden). Dit geldt voor personen en invoegingen, niet voor het peilen van waarschuwingen.
    Wanneer een bestand verdwijnt
    Verwijder de rijen standaard, of Behoud rijen, markeer verwijderd (grafsteen)De Verdwijningspercentage (0.5) weigert een scan die meer dan de helft van de bestanden tegelijk verliest en behoudt de vorige inventaris, wat overeenkomt met hoe een offline gedeelde map eruitziet.

    Kies vervolgens de Gegevensrijk Het aantal rijen telt mee, controleer Beoordeling en klik Connector makenDe eerste scan start direct. De connector Manifest Het tabblad laat zien wat er is gebouwd en welke bestanden er zijn opgeslagen.

  5. Kijk naar je tafels

    Open de connector: de Manifest tab geeft een overzicht van de tabellen die zijn gemaakt en de Bestanden In het dialoogvenster worden alle logbestanden met hun status weergegeven. Querybouwer dezelfde tafels staan onder de bestandenset schema. Drie query's die vanaf dag één werken:

    stderr-regels per container in het afgelopen uur
    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

    Welke containers schrijven momenteel naar stderr en hoeveel? De container die als eerste vastliep, had meestal de vroegste schrijfpiek.

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

    De meest recente stderr-regels bevatten de containernaam en de image, waardoor een mislukte image-uitrol in elke container die deze uitvoert, wordt weergegeven.

    Welke logbestanden zijn vandaag geroteerd of opzijgezet?
    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

    Bestandsgeschiedenis voor vandaag: welke containerlogs zijn geroteerd en of er bestanden zijn gereserveerd, met een gedetailleerde uitleg van de reden.

    Elke mapconnector bedient ook dezelfde boekhoudtabellen, allemaal in de bestandenset schema:

    TafelWat het bevat
    bestandenElk bestand dat zich momenteel in de map bevindt: pad, naam, extensie, grootte, aanmaak- en wijzigingsdatum, eerste en laatste keer gezien. Een overzicht van bestanden_huidig, die ook bestanden bewaart die verdwenen zijn.
    bestanden_gebeurtenissenDe wijzigingsgeschiedenis: één regel per bestand dat verscheen, was gewijzigd, verdwenen, werd opzijgezet (drift) of was geweigerd, met de tijd in event_athoe het werd opgemerkt in gedetecteerd_door en de reden in detail.
    mappen, map_snapshots, volumesHet aantal mappen en hun grootte, hoe ze zijn gegroeid en op welke schijven of gedeelde mappen de wortels voortleven.
    _bronbestand, _rij_idElke gegevensrij bevat twee kolommen: het bestand waar de rij vandaan komt en een stabiele rij-ID binnen dat bestand. Groeperen op _bronbestand om bestanden te vergelijken.

Dat is alles. Sleep een nieuw bestand naar de map en na de volgende scan staat het in de tabel. De bestanden hebben de computer waarop ze stonden nooit verlaten.

Een bestand openen op een gedeelde netwerkmap

De agent opent bestanden als een achtergrondservice, niet als een gewone gebruiker. Daarom is er voor een bestand op een andere computer een extra stap nodig. Welke stap dat is, hangt af van de computer waarop de agent draait.

Windows

Typ het netwerkpad, bijvoorbeeld: \\server\share\foldernooit een toegewezen stationsletter zoals S:die de agent niet kan zien. Als de gedeelde map alleen toegang geeft aan benoemde personen, klik dan hier. Service-identiteit (de chip onder het pad, of een map) Referentie kolom) en sla een login voor die server op: een bedrijfsdomeinaccount of een account dat op de server zelf is aangemaakt met Domein leeggelaten. De agent meldt zich vervolgens aan bij die server en leest het bestand daar. Elke connector op die agent die dezelfde server leest, moet dezelfde aanmelding gebruiken. Zonder aanmelding leest de agent het bestand als zijn eigen serviceaccount, wat een bedrijfsdomein ziet als de computer zelf. Stapsgewijze handleiding voor Windows

Linux

De in de portal opgeslagen share-aanmeldingen worden niet gebruikt op Linux: een beheerder koppelt de share eerst op de computer van de agent, in een map onder /mnt of /mediaomdat de service van de agent dit niet kan zien /thuis of /run/userHoud in de connector de \\server\share pad, dat de Agent aan de mount koppelt, of typ in plaats daarvan het mountpad, bijvoorbeeld: /mnt/fileserver-shared/Accounts. Hoe koppel je een gedeelde map op Linux?

Mac

Aanmeldingen voor gedeelde mappen die in de portal zijn opgeslagen, worden niet gebruikt op een Mac: koppel de gedeelde map eerst via Terminal met sudo, in een map onder /Volumeszodat de achtergrondservice van de agent deze kan zien. Houd in de connector de volgende instellingen aan: \\server\share pad, dat de Agent aan de mount koppelt, of typ in plaats daarvan het mountpad, bijvoorbeeld: /Volumes/fileserver-shared/Accounts. Hoe koppel je een gedeelde map op een Mac?

Als de test het aandeel niet kan vinden, zoek dan in het resultaat naar de volgende woorden: onbereikbaar Dit betekent dat de computer van de agent geen antwoord van de server heeft ontvangen. Op Linux of een Mac, niet gemonteerd Dit betekent dat de gedeelde map nog moet worden aangekoppeld, en dat bericht bevat het exacte aankoppelcommando voor uw server.

Mappen op een gedeelde map? Op Windows dekt één aanmelding alle mappen die u vanaf dezelfde server toevoegt. Houd de map in de gaten voor wijzigingen. Het werkt ook op basis van een gedeelde database, naar beste vermogen; de geplande scan garandeert dat elke wijziging wordt gedetecteerd.

Wanneer een map niet bereikbaar is

Elke map op de Mappen Zodra je een stap toevoegt, wordt de status weergegeven. Beweeg de muis over de status om het bericht van de agent te lezen; de eerste woorden geven aan om welke zaak het gaat.

Status of berichtWat het betekentWat te doen
geweigerdDe gedeelde map gaf de agent geen toegang. Omdat er geen inloggegevens waren opgeslagen, interpreteert een Windows Agent zijn serviceaccount, wat binnen een bedrijfsdomein de computer zelf vertegenwoordigt.Windows: klik Service-identiteit in de map Referentie Voeg een kolom toe en sla een login op die de gedeelde map kan lezen, of vraag degene die de server beheert om de opgeslagen login leesrechten te geven. Linux of Mac: de gedeelde map is gekoppeld, maar de machtigingen blokkeren de toegang voor de Agent; controleer hoe deze is gekoppeld.Linux, Mac).
ongeldige inloggegevens, of De opgeslagen inloggegevens voor \\server werden geweigerd.De server heeft de opgeslagen inloggegevens geweigerd: een typefout, een verkeerd domein of een gewijzigd wachtwoord. De agent wacht een minuut voordat hij de inlogpoging opnieuw probeert, zodat het account niet wordt geblokkeerd.Klik op de accountnaam in de Referentie kolom en typ de login opnieuw in. Voor een account dat op de server zelf is aangemaakt, laat u het veld leeg. Domein leeg.
ontbrekendEr bestaat geen map op dat pad. Op Windows wordt een servernaam die niet gevonden kan worden, of een gedeelde map die de server niet heeft, ook als ontbrekend weergegeven.Controleer de namen, of selecteer de map met Map toevoegen vanuit de agent in plaats van het te typen.
onbereikbaar, of De server heeft niet gereageerd.Geen reactie van de server: deze is uitgeschakeld, de naam is onjuist of een firewall blokkeert het delen van bestanden.Open hetzelfde \\server\share Controleer het pad op de computer van de agent. Als dat ook niet werkt, is er een netwerkprobleem.
niet gemonteerd (Linux of Mac)De share is niet gekoppeld op de computer van de agent. Beweeg de muis over de status, of de Niet gemonteerd chip in de Referentie kolom, voor het exacte montagecommando.Monteer het aandeel (Linux, Mac), en test de map dan opnieuw.
Een andere connector op deze agent meldt zich al aan bij \\server als …Windows staat één account per bestandsserver per computer toe, en een andere connector op deze agent gebruikt een ander account.Gebruik dezelfde inloggegevens als die connector, of wijzig deze op elke connector die deze server leest.
Windows heeft al een aanmelding bij \\server voor …Op de computer van de agent is iets anders met een ander account aangemeld bij die server, en de agent sluit nooit een aanmelding af die hij zelf niet heeft gedaan.Volg de instructies in het bericht: daarin wordt het Windows-account genoemd waaronder de agent wordt uitgevoerd en wordt aangegeven of Gebruik service-identiteit zou het aandeel via de bestaande aanmelding lezen.
Deze agentbuild kan niet inloggen op \\server met opgeslagen referenties.Een oudere agent die geen gebruik kan maken van een opgeslagen gedeelde aanmelding.Werk de agent bij en test het vervolgens opnieuw.

Gebruik het overal

De connector is een gegevensbron, net als elke andere in Query Streams. Sla een query eenmaal op in de Querybouwer (het dialect is DuckDB) en gebruik het vanuit:

Excel

De add-ons Een query streamen De rijen worden in een spreadsheet geplaatst en met een muisklik opnieuw uitgevoerd. SQL-query's uitvoeren in Excel.

Google formulieren

De Query Streamer De add-on vult een tabblad dat je selecteert. Power Query voor Google Sheets.

Claude, Cursor en andere AI-clients

Via de Query Streams MCP-server kent Claude het mapmodel, inclusief _bronbestand en bestanden_gebeurtenissen. Containerlogs met Claude via MCP.

REST API

Elke opgeslagen query wordt een alleen-lezen eindpunt met een eigen sleutel, in elk plan. Containerlogs REST API.

Nova

Stel uw vragen in begrijpelijke taal over het bedrijfsplan; Nova kent elke map, tabel en kolom dankzij de ingebouwde beschrijvingen.

Automatiseringen

Synchroniseer de rijen met Airtable, Smartsheet, Baserow, SeaTable of een spreadsheet volgens een planning. Automatiseringshandleidingen.

Maptabellen kunnen ook gekoppeld worden aan uw andere connectors: een gefedereerde query kan overeenkomsten vinden. _bronbestand Namen of order-ID's in de logboeken van uw Docker-container worden vergeleken met een database op dezelfde agent.

Hoe nieuwe, gewijzigde en verwijderde bestanden worden weergegeven

Nieuwe en gewijzigde bestanden

Op elke Scaninterval (of binnen enkele seconden met Bekijk map (on) een nieuw bestand dat aan de lay-out voldoet, krijgt zijn rijen toegevoegd en ontvangt een verscheen Een gewijzigd bestand wordt in één transactie opnieuw ingelezen: de oude rijen verdwijnen, de nieuwe rijen komen erbij en het bestand krijgt een nieuwe status. gewijzigd gebeurtenis. Logbestanden worden bijgehouden naarmate ze groeien; een geroteerd bestand behoudt zijn stream-ID.

Verwijderde bestanden

Een bestand dat verdwijnt, verwijdert standaard de bijbehorende rijen, of blijft gemarkeerd als verwijderd als je de optie 'verwijderd' hebt gekozen, en krijgt een verdwenen gebeurtenis. Als meer dan de helft van de bestanden tegelijk verdwijnt, wordt de scan geweigerd en blijft de vorige inventaris behouden: een offline gedeelde map ziet er precies zo uit.

Aparte bestanden

Een bestand dat niet in de lay-out past, niet geopend kan worden of een bepaalde limiet overschrijdt, wordt volledig aan de kant geschoven: geen van de rijen wordt geladen. bestanden_gebeurtenissen krijgt een drift De rij met de bestandsnaam en de kolomnaam worden gecorrigeerd. Het bestand wordt hersteld en opgeslagen; bij de volgende scan wordt het opnieuw geprobeerd.

Hoe vers is wat ik zie?

De query's worden beantwoord op basis van de laatste scan. Er is geen knop 'Opnieuw scannen' of 'Nu synchroniseren'; het scaninterval, de mapmonitor en Vernieuw de pagina voordat u een vraag beantwoordt. Dit zijn de drie bedieningselementen. MAX(laatst gezien_utc) vanaf bestanden_huidig Geeft aan wanneer de agent voor het laatst heeft gekeken.

De agent volgt elk containerlogbestand naarmate het groeit. Elk bestand heeft een byte- en regelcursor, waardoor bij elke scan alleen nieuwe regels worden gelezen en een halfgeschreven laatste regel wacht op de volgende. Een geroteerd bestand wordt herkend aan de eerste 4 KB en behoudt dezelfde inhoud. _stream_id, zodat niets dubbel geteld wordt. Elk .gz Het lid wordt eenmaal gelezen; .zip, .taxi en .tijdschrift Bestanden worden overgeslagen. De eerste leesbewerking gaat standaard 30 dagen terug, met een maximum van 64 MiB per bestand, en regels worden 30 dagen bewaard, tenzij u dit wijzigt. Bewaar evenementen gedurende N dagen.Om elk logbestand te bekijken, de status ervan en de reden waarom een bestand is weggezet of onleesbaar is, opent u de connector. Bestanden dialoog.

Bestanden die apart zijn gezet.

Op de stap 'Controleren' en het tabblad 'Manifest' staan drie woorden. Ze hebben verschillende betekenissen:

Aan de kant zetten (parkeren)
Het bestand komt niet overeen met de vastgezette lay-out, of is onleesbaar, beschadigd, vergrendeld of te groot. Het is alles of niets per bestand: een geparkeerd bestand draagt nul rijen bij. bestanden_gebeurtenissen records een drift rij waarvan detail De bestandsnaam en de kolomnaam worden doorgegeven. Het bestand wordt overgeslagen zolang de grootte en de wijzigingstijd hetzelfde blijven, en opnieuw geprobeerd zodra deze wijzigen.
Onleesbaar
De agent kon het bestand niet openen of verwerken vanwege het type: geen echt werkblad, vergrendeld door een ander programma, een cloud-placeholder, onleesbare bytes. Het bestand wordt automatisch afgesloten en de rest van de map wordt wel verwerkt. Alleen een map met nul leesbare bestanden weigert de volledige set.
Geweigerd
De agent kon geen enkele lay-out vastzetten, bijvoorbeeld omdat bestanden het niet eens waren over een kolomtype. Er bestaat nog geen gegevenstabel. bestanden_gebeurtenissen krijgt een geweigerd rij met de reden in detailEn de agent probeert het bij elke scan opnieuw totdat een lay-out wordt vastgezet. Corrigeer of sluit het bestand uit dat wordt genoemd en de melding verdwijnt.

Waar te kijken: de amberkleurige banner op Rekening (Geef aan welke bestanden het betreft en waarom.), de connector Manifest tab daarna, en voor logconnectoren de Bestanden dialoogvenster, waarin geparkeerde bestanden met de reden worden weergegeven laatste_foutIn SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.

Grenzen die het waard zijn om te kennen

Er is geen limiet aan het aantal mappen of bestanden in het abonnement. De rijen tellen wel mee voor uw Data Realm, net als bij elke andere connector. U kunt de standaardinstellingen van de connector verhogen of verlagen:

InstellingStandaardWat het doet
Maximale diepte8Hoeveel mapniveaus onder elke rootmap worden gescand (1–64).
Maximaal aantal bestanden per scan100,000Dossiers worden in één keer bekeken.
Maximale bestandsgrootte naar hash32 MiBHet gaat alleen om... Inhoud van het hashbestand op.
Bewaring van gebeurtenislogboeken30 dagenHoe lang bestanden_gebeurtenissen De rijen blijven behouden.
Scanparallellisme per wortel2Mappen worden per hoofdmap één keer gelezen.

Inhoudslimieten, die een bestand parkeren in plaats van het te verkleinen: 2.000.000 rijen of 512 MiB per bestand, 10.000.000 rijen of 2 GiB per scan. Een map kan maximaal 25 verschillende lay-outs bevatten. Eén tafel per lay-out modus.

Vragen die mensen stellen

Welke containerlogformaten en -profielen worden ondersteund?

De Logtype De lijst op de kaart 'Container Logs' omvat de logbestanden van Docker-containers. Het Docker json-file-profiel geeft app, stroom, niveau, logger, bericht, gastheer, dienst en gegevens, plus afbeelding, compose_project, compose_service en container_idOnder de lijst staat: "Heeft u een logtype nodig dat niet in de lijst staat? Dien een supportverzoek in en we voegen het binnen enkele dagen toe."

Kan ik mijn eigen format toevoegen?

Niet op deze kaart. De containerprofielen zijn vergrendeld. Gebruik de Aangepaste logmap kaart in plaats daarvan, waar u zelf het formaat beschrijft of klikt Laat Nova een format voorstellen..

Is dit Docker's MCP Toolkit of een vervanging voor docker logs?

Nee. Het voert geen containers uit, beheert ze niet en koppelt er ook niet aan. Het leest de logbestanden die Docker al heeft geschreven en presenteert deze als SQL-rijen. Gebruik docker logs Voor een live terminal tail; gebruik dit wanneer je de regels in een tabel wilt weergeven.

Hoe snel verschijnt een nieuwe logregel?

Bij de volgende scan, standaard elk uur onder ScanintervalInschakelen Houd de map in de gaten voor wijzigingen (vrijwel in realtime). Om binnen enkele seconden te reageren op een lokale schijf. Een halfgeschreven laatste regel wacht tot deze voltooid is.

Kan Claude deze tabellen ook bevragen?

Ja. Dezelfde connector wordt door Claude via MCP gebruikt, alleen-lezen. Zie Hoe Docker-logs via MCP met Claude te verbinden.

Zijn mijn bestanden ergens geüpload?

Nee. De agent leest de gegevens op zijn eigen computer en bewaart de rijen in een versleutelde lokale cache. Een query wordt uitgevoerd op die cache en alleen de rijen die de query retourneert, verlaten de machine via één uitgaande verbinding. Bestanden worden nooit gewijzigd, verplaatst of geconverteerd.

Moet ik een poort openen of een VPN-verbinding gebruiken?

Nee. De agent maakt één uitgaande verbinding op poort 443 en zowel verzoeken als rijen worden via die poort verzonden. Als uitgaande HTTPS werkt, werkt dit ook.

Kan de map zich op een netwerkshare bevinden, of in OneDrive of Dropbox?

Ja. Typ een deel als \\server\share\folderOmdat de agent als een service draait en geen toegang heeft tot de schijven die aan uw account zijn gekoppeld, moet u op Windows een aanmelding voor de server opslaan als de gedeelde map alleen toegang biedt aan personen met een naam; zonder aanmelding leest de agent de gegevens als een eigen serviceaccount. Op Linux of een Mac moet u de gedeelde map eerst koppelen. Een gesynchroniseerde OneDrive- of Dropbox-map werkt wanneer de bestanden op de computer zijn opgeslagen: stel de map in op Bewaar dit apparaat altijd bij de hand.De agent downloadt geen bestanden die alleen in de cloud staan.

De map bevat meerdere bestandstypen. Eén connector of twee?

Eén connector leest één bestandstype. Een map met CSV- en Parquet-bestanden bestaat uit twee connectors op dezelfde root, één per type. Bestanden die niet overeenkomen met het include-patroon worden genegeerd, niet apart gehouden.

Is er een knop om opnieuw te scannen?

Nee. De agent scant op de Scanintervalreageert op veranderingen wanneer Bekijk map is ingeschakeld en kan opnieuw scannen voordat een query wordt beantwoord wanneer u deze functie inschakelt. Bewerk de connector om een van de drie instellingen te wijzigen.

Is dit echt inbegrepen bij het gratis abonnement?

Ja. Gratis is een abonnement dat je behoudt, geen proefperiode die verloopt. Mapconnectoren hebben geen eigen bestandslimiet; de rijen tellen mee voor je Data Realm, net als bij elke andere connector. Bekijk wat elk abonnement inhoudt op de website. prijspagina.

Zit je nog steeds vast? Open Ondersteuning Ga naar Query Streams en laat ons weten in welke stap u zich bevindt en wat u ziet. Dan zorgen wij ervoor dat u verbonden wordt.

Elke gids voor Container Logs

Is dit niet helemaal jouw situatie?

  • Schrijft jouw app zijn eigen logbestanden buiten Docker? Application Logs leest die bestanden → App Logs
  • Is uw logformaat niet een van de standaard logtypen? Met een aangepaste logmap kunt u het formaat zelf definiëren → Custom Logs

Installatieproblemen?

  • De agent geeft aan dat het bestand of de map niet bestaat, of dat de toegang is geweigerd? Toegewezen schijven, netwerkshares, OneDrive en Linux-thuismapjes vereisen elk een oplossing → Waar de agent bestanden kan lezen van
  • Geeft de agent de status 'Offline' weer, of zijn 'Verbinding testen' en 'Bladeren' grijs weergegeven? Controleer of de agent online is → Is de agent online?
Geüpdatet op november 9, 2026

Mogelijk gemaakt door BetterDocs