De rungeschiedenis vulde de schijf
Opgeslagen rundata kan groeien tot de schijf vol is en de server stopt. Zeven controles: wat groeit er op uw agentserver, en wie merkt het op tijd?

Eén taak, ongeveer 14.000 items, een paar uur. Meer was er niet nodig om een schijf van 120 GB op een self-hosted workflowserver te vullen en de server plat te leggen.
Een team meldde dit op de issuetracker van het project. Het team draaide de tool in Docker, op de standaarddatabase, SQLite, die een database in één hoofdbestand bewaart. Het geplande opschonen van oude runs stond aan. Een eigen synchronisatietaak verwerkte ongeveer 14.000 items, en elk item startte weer nieuwe workflowruns. De opgeslagen rundata vulde de schijf. De server reageerde niet meer, en niemand kon het scherm openen.
Het team maakte de schijf groter: 160 GB. Daarna verwijderde het in het scherm runs tot er nog maar 17 over waren. Het databasebestand was nog steeds 101 GB.
De ruimte kwam pas terug toen het team de container stopte en met de hand VACUUM uitvoerde. In SQLite schrijft VACUUM het databasebestand opnieuw, zonder de lege ruimte. Het schijfgebruik ging van 116 GB naar 16 GB. Het team meldde dat er geen foutmelding en geen waarschuwing kwam voordat de schijf vol was.
Een tweede melding: eerst werd de server traag
Een gebruiker met een self-hosted server die al lang draaide, met dezelfde tool en dezelfde standaarddatabase, meldde een ander soort groei. Het databasebestand was 1,8 GB. Daarnaast was het write-ahead log gegroeid tot ongeveer 18,9 GB. Het write-ahead log is een bijbestand waarin de database wijzigingen eerst vastlegt, voordat hij ze naar het hoofdbestand kopieert.
Zolang het log zo groot was, werden de lijst met workflows, de rungeschiedenis en nieuwe runs erg traag. Een herstart loste het op, omdat de gebruiker de tool bij elke start VACUUM liet uitvoeren. Binnen dagen of weken groeide het log weer aan. Het gebeurde twee keer, terwijl het geplande opschonen aanstond.
Wat de twee gemeen hebben
In beide gevallen stond het opschonen aan en werden oude runs verwijderd. Toch liep de schijf vol, of werd de server traag. Een rij verwijderen en ruimte teruggeven aan de schijf zijn twee verschillende dingen.
In beide gevallen waarschuwde niets vooraf. Het eerste team merkte het toen de server stopte. Het tweede merkte het toen alles traag werd.
Runverslagen zijn het bewaren waard: ze laten zien wat een agent of workflow deed. De AI agent is klaar. Niemand kan zeggen wat hij deed. beschrijft wat een goed runverslag bevat. Maar elk verslag kost ruimte, en een grote run kost er veel.
Zeven controles: wat groeit er op uw agentserver, en wie merkt het voordat de schijf vol is?
Deze controles gelden voor elke self-hosted tool die agents of workflows draait, ook de onze. Waar EpicStaff een antwoord heeft, staat dat onder de controle.
1. Weet waar runverslagen staan
Een runverslag (run record) bevat wat er in een run ging, wat elke stap teruggaf en wat eruit kwam. Zoek uit welke database deze verslagen bewaart, op welke schijf, en wat die schijf nog meer gebruikt. In de eerste melding vulde de database een schijf die de hele server nodig had.
In EpicStaff: Runverslagen staan in uw eigen PostgreSQL-database.
2. Weet wie oude runs mag verwijderen, en wat een verwijdering achterlaat
Zoek uit welke rol oude runs mag verwijderen, en wie daar tijd voor heeft. Zoek daarna uit wat een verwijdering weghaalt. Een run kan bestanden schrijven en logs laten groeien. Haalt een verwijdering alleen het verslag weg, dan blijft de rest op de schijf staan.
In EpicStaff: Een Org Admin kan oude runs één voor één of in bulk verwijderen. Bestanden die de runs schreven, blijven in de bestandsopslag (file store) staan.
3. Weet of er iets volgens een schema verwijdert
Zoek uit of uw tool oude runs zelf verwijdert, wat de instelling is en wie die koos. Vergelijk het schema met uw grootste taak, niet alleen met de dagelijkse: de taak van 14.000 items hierboven vulde de schijf in een paar uur, terwijl het geplande opschonen aanstond. Verwijdert er niets volgens een schema, zet het opschonen dan in een agenda en wijs een eigenaar aan. Bepaal ten slotte hoe lang uw auditors en uw supportteam oude runverslagen nodig hebben.
In EpicStaff: Runverslagen staan in uw eigen database. Ze worden alleen volgens een schema verwijderd als uw beheerder een bewaartermijn instelt (30 tot 365 dagen); bij 0 blijven ze voor altijd bewaard.
4. Weet of verwijderen ruimte teruggeeft aan de schijf
In de eerste melding liet het verwijderen van runs een bestand van 101 GB achter, en alleen VACUUM, met de hand uitgevoerd terwijl de tool stilstond, gaf de ruimte terug. In PostgreSQL wordt ruimte die verwijderde rijen vrijmaken, hergebruikt voor nieuwe rijen zodra vacuum heeft gedraaid. Die ruimte gaat niet terug naar de schijf, tenzij u VACUUM FULL uitvoert.
Test wat een verwijdering op uw eigen server doet. Noteer de grootte van de database, verwijder een reeks oude runs, en meet de volgende dag opnieuw. Dan kent u het antwoord voordat u de ruimte nodig hebt.
5. Wijs aan wie de grootte van schijf en database bewaakt
Een volle schijf ziet u ruim van tevoren aankomen, als iemand kijkt. Bewaak de vrije ruimte op elke schijf die de server gebruikt, en de grootte van de database zelf. Stel een eerste waarschuwing in ruim voordat de schijf vol is, en een tweede dichter bij vol. Stuur beide naar iemand die er iets mee kan doen. Op een self-hosted server is dit uw taak; wat dat eigenaarschap verder inhoudt, leest u in Zelfgehoste AI: zo houdt u uw AI-stack zelf in handen.
6. Weet wat er nog meer groeit
Maak een lijst van elke map en elk volume op de server dat met het gebruik groeit: logs, bestanden die runs schrijven, en bijbestanden van de database, zoals het write-ahead log uit de tweede melding. Een derde melding, over een andere tool, komt uit het lezen van de broncode, niet uit een volle schijf: de gebruiker meldde dat elke keer dat een bouwer wijzigingen aan de skills of bestanden van een agent doorzet, het oude bestandsrecord en de opgeslagen kopie achterblijven, zonder manier om ze op te ruimen. Noteer voor elk item op uw lijst waar het staat en wat het weghaalt.
In EpicStaff: Runverslagen zijn niet het enige dat groeit: bestanden, logs, Redis en opgeslagen Python-omgevingen groeien ook.
7. Meet de grootte, en test een restore, volgens een vast schema
Noteer elke week de grootte van de database, de bestandsopslag en de logs. De trend zegt meer dan één los getal. Zet elk kwartaal een back-up terug op een reservemachine (een restore), en meet hoe lang dat duurt. Een database vol oude runs kost meer tijd om te back-uppen en meer tijd om terug te zetten. De test laat zien hoeveel meer, voordat een storing dat doet.
Twee getallen die u vandaag noteert
Noteer vandaag twee getallen: de vrije ruimte op de schijf met uw runverslagen, en de grootte van uw database. Meet ze over een week opnieuw. Het verschil is uw groei per week. Deel de vrije ruimte door dat getal, en u weet hoeveel weken u nog hebt.
Plan daarna voor de grote run. Controleer de vrije ruimte voordat een taak met duizenden items start, en weet wie de runverslagen ervan achteraf verwijdert.
Vragen & Antwoorden
Hoe lang moet ik de rungeschiedenis van workflows bewaren?
Zo lang als u die nodig hebt om vragen over eerdere runs te beantwoorden: voor audits, klachten en het opsporen van fouten. Vraag uw audit- en juridische teams welke termijn voor uw gegevens geldt. Runverslagen kunnen persoonsgegevens uit de invoer bevatten, dus te lang bewaren heeft ook een prijs. Leg de termijn vast, en geef iemand de taak om op die datum te verwijderen.
Hoeveel schijfruimte heeft een self-hosted workflowserver nodig?
Meet het; er is geen vast getal dat voor elke server past. Vermenigvuldig uw groei per week met het aantal weken dat u de rungeschiedenis bewaart. Tel daar ruimte bij op voor uw grootste losse run, voor logs en voor back-ups op dezelfde schijf. Houd daarboven nog vrije ruimte over.
Moet ik de gegevens van geslaagde workflowruns bewaren?
Beslis dat per workflow. Opgeslagen gegevens laten zien wat een run deed, en dat helpt als iemand maanden later een uitkomst betwist. Ze kosten ook ruimte. Een mogelijke keuze: bewaar volledige gegevens voor workflows waarvan de uitkomst voor een audit telt, en bewaar mislukte runs langer dan geslaagde. Leg de beslissing vast.
Waar bewaart EpicStaff de rungeschiedenis van workflows?
Runverslagen staan in uw eigen PostgreSQL-database. Ze worden alleen volgens een schema verwijderd als uw beheerder een bewaartermijn instelt (30 tot 365 dagen); bij 0 blijven ze voor altijd bewaard. Een Org Admin kan oude runs één voor één of in bulk verwijderen. Bestanden die de runs schreven, blijven in de bestandsopslag (file store) staan.


