Home
» Hoe
»
Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.
Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.
Illustratief scenario: Rowan beheert een kleine Matrix-homeserver en ziet in de Synapse-logboeken [Errno 24] Too many open fileswanneer de activiteit toeneemt. Als het actieve Synapse-proces de systemd-limiet voor geopende bestanden heeft bereikt, moet er LimitNOFILEeen systemd drop-in worden uitgevoerd voor de betreffende service, systemd opnieuw worden geladen en Synapse opnieuw worden gestart. Controleer de limiet van het actieve proces. Wijzig geen globale kernellimiet totdat er bewijs is dat de machinebrede bestandstabel is uitgeput.
De exacte limiet hangt af van de installatie en de werkbelasting; de onderstaande voorbeeldwaarde is geen officieel minimum voor Synapse. De huidige richtlijnen voor systemd van Synapse beschrijven een masterservice, optionele worker-template-eenheden en een doel dat deze groepeert. Stem de namen van de eenheden af op uw eigen installatie. Zie de Synapse systemd-with-workers-documentatie .
De voorbeeldloguitvoer laat zien dat Synapse foutcode 24 rapporteert tijdens het accepteren van verbindingen. Het illustreert het symptoom en is geen logbestand van een echte server.
Ontdek welke limiet niet wordt gehaald.
"Open bestanden" betekent bestandsdescriptors: dit zijn de handlers die een proces gebruikt voor sockets, bestanden, pijpen en andere resources. Synapse heeft mogelijk veel descriptors nodig voor clientverbindingen, federatie, databaseverbindingen en workers. Controleer eerst de service en de bijbehorende logbestanden:
sudo systemctl status matrix-synapse.service
sudo journalctl -u matrix-synapse.service -b --no-pager -n 100
sudo systemctl show matrix-synapse.service -p MainPID -p LimitNOFILE
Vervang dit matrix-synapse.serviceals uw unit een andere naam heeft. Een pakket, container of aangepaste implementatie kan de service anders benoemen of starten. Gebruik dit systemctl list-units '*synapse*'om units te vinden die worden beheerd door de huidige systemd-manager. Als systemd Synapse niet rechtstreeks start, is deze overschrijving mogelijk niet van toepassing op het proces.
Neem de MainPIDuitvoer en inspecteer dat proces. Vervang de numerieke PID door PID:
grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l
Het eerste commando toont de soft- en hard-limieten van het actieve proces; het tweede telt de momenteel geopende descriptors. Als het aantal dicht bij de soft-limiet ligt en het logbestand Too many open filesof bevat Errno 24, is een per-proceslimiet een plausibele oorzaak. De kernel geeft deze waarden weer via /proc/<pid>/limits; zie de Linux-referentie voor proceslimieten .
In Rowans voorbeeld, stel dat de soft limit van het proces 1024 is en het aantal descriptors daar dichtbij ligt. Dat rechtvaardigt het aanpassen van de eenheid. Als het proces de limiet bij lange na niet bereikt, inspecteer dan de volledige fouten en het resourcegebruik voordat u de limieten verhoogt; een lek of een andere storing kan de oorzaak zijn.
De voorbeeldtabel met proceslimieten toont een zachte limiet van 1024 geopende bestanden en een hogere harde limiet. Controleer het actieve Synapse-proces in plaats van te vertrouwen op de ulimit van een loginshell.
Verhoog de limiet met een systemd drop-in.
Een drop-in voegt een kleine overschrijving toe zonder de vendor-unit van het pakket te wijzigen. Bij een typische systemd-installatie maakt u de overschrijving aan voor de daadwerkelijke master-unit:
sudo systemctl edit matrix-synapse.service
Voer deze instelling in de editor in:
[Service]
LimitNOFILE=65536
Opslaan en afsluiten. 65536is een voorbeeld, geen door Synapse voorgeschreven waarde. Kies een waarde die hoger is dan het waargenomen piekgebruik met wat speling, binnen de ondersteunde harde limiet en operationele capaciteit van de host. systemd accepteert resource-limit-instellingen zoals LimitNOFILE; de documentatie waarschuwt er ook voor dat sommige programma's die gebruiken select(2)geen descriptors boven de 1023 aankunnen. Controleer of de runtime en de applicatie de gekozen waarde tolereren in plaats van deze blindelings over te nemen. Lees de documentatie over resource-limit van systemd.exec .
Herlaad de eenheidsdefinities en herstart Synapse zodat het proces opnieuw wordt gestart met de nieuwe limiet:
Gebruik uw SSH-sessie niet ulimit -nom een systeemservice te wijzigen. Een loginshell en een systemd-service ontvangen limieten vanuit verschillende contexten; de daadwerkelijke instelling van de service moet direct worden gecontroleerd.
De systemd drop-in stelt een LimitNOFILE-waarde in op serviceniveau. De voorbeeldwaarde is illustratief; kies een limiet die past bij de host en de applicatie.
Pas de limiet indien nodig toe op werknemers en containers.
Als je Synapse-workers gebruikt, is elke worker een afzonderlijk serviceproces met een eigen resourcebeperking. Het officiële systemd-voorbeeld gebruikt units zoals `<worker>` matrix-synapse-worker@generic_worker.service. Maak een overeenkomstige drop-in voor elke actieve worker-unit die de limiet bereikt, bijvoorbeeld:
Voeg vervolgens dezelfde [Service]regels toe LimitNOFILE, herlaad systemd en herstart de worker of het Synapse-doel. De Synapse-documentatie laat zien dat het herstarten van het doel de master en de workers tegelijkertijd herstart. Controleer de effectieve limiet van elke betreffende eenheid afzonderlijk.
Voor Docker of een andere containermanager is een systemd-override op de host alleen nuttig als die unit het proces direct start en de limiet doorgeeft. Stel anders de limiet voor bestandsdescriptors in via de runtime- of orchestratieconfiguratie van de container, maak de container vervolgens opnieuw aan/start deze en inspecteer het proces erin. De installatiedocumentatie van Synapse vermeldt de officiële containerimage; de verpakkingsdetails variëren, dus controleer de huidige configuratie van de runtime in plaats van een commando te gebruiken dat alleen op de host van toepassing is.
Na het herladen van systemd en het herstarten van de service is de weergegeven effectieve limiet 65.536 en is de Synapse-eenheid in dit voorbeeld actief.
Controleer of Synapse gezond is.
Na de herstart kunt u systemctl showde controle opnieuw uitvoeren /proc/PID/limitsmet de nieuwe hoofd-PID. De effectieve soft- en hard-limieten moeten de geconfigureerde waarde weerspiegelen. Controleer het logboek op opstartfouten en nieuwe Too many open filesfouten, doe vervolgens een clientverzoek en bevestig dat de federatie- of workeractiviteit die werd beïnvloed, is hervat.
Als de foutmelding Too many open files in systemof logboekvermeldingen verwijzen naar de kernelbestandstabel, controleer dan /proc/sys/fs/file-nr: het eerste getal geeft de toegewezen bestandsdescriptors aan en het derde getal het maximum. Een systeemwijd tekort is iets anders dan Synapse dat zijn eigen descriptorlimiet bereikt; onderzoek andere services en de globale capaciteit voordat u wijzigingen op kernelniveau overweegt. Raadpleeg de Linux proc- bestandssysteemreferentiedocumenten file-nren file-max.
Voor Rowan is de oplossing pas geverifieerd als het herstartte proces de beoogde limiet heeft bereikt, Synapse actief blijft en de oorspronkelijke logfout niet meer optreedt onder de betreffende werkbelasting. Als het gebruik blijft stijgen richting de nieuwe limiet, onderzoek dan descriptorlekken of capaciteitsbehoeften in plaats van het aantal herhaaldelijk te verhogen.