Synapses Systemd-Dateilimit ohne Rätselraten erhöhen
Beispiel: Rowan administriert einen kleinen Matrix-Homeserver und beobachtet im Synapse-Log [Errno 24] Too many open fileserhöhte Aktivität. Hat der laufende Synapse-Prozess das systemd-Limit für offene Dateien erreicht, sollte er LimitNOFILEein systemd-Drop-in für den betroffenen Dienst erstellen, systemd neu laden und Synapse neu starten. Anschließend sollte er das Limit des laufenden Prozesses überprüfen. Globale Kernel-Limits dürfen erst geändert werden, wenn nachgewiesen ist, dass die systemweite Dateitabelle erschöpft ist.
Der genaue Grenzwert hängt von der Installation und der Arbeitslast ab; der unten angegebene Beispielwert ist kein offizieller Mindestwert von Synapse. Die aktuelle systemd-Dokumentation von Synapse umfasst einen Master-Service, optionale Worker-Template-Units und ein Ziel, das diese gruppiert. Passen Sie die Unit-Namen an Ihre Installation an. Weitere Informationen finden Sie in der Synapse-Dokumentation zu systemd-with-workers .
Die Beispielausgabe des Protokolls zeigt, dass Synapse beim Annehmen von Verbindungen den Fehlercode Errno 24 meldet. Sie veranschaulicht das Symptom und stammt nicht von einem realen Server.
Finden Sie heraus, welcher Grenzwert nicht mehr funktioniert.
„Geöffnete Dateien“ bedeutet Dateideskriptoren: Sie dienen einem Prozess zur Verwaltung von Sockets, Dateien, Pipes und anderen Ressourcen. Synapse benötigt möglicherweise zahlreiche Deskriptoren für Client-Verbindungen, Föderation, Datenbankverbindungen und Worker. Überprüfen Sie zunächst den Dienst und seine Protokolle:
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
Ersetzen Sie den Wert matrix-synapse.service, falls Ihre Einheit einen anderen Namen hat. Pakete, Container oder benutzerdefinierte Bereitstellungen können den Dienst anders benennen oder starten. Verwenden Sie diese Option, systemctl list-units '*synapse*'um die vom aktuellen systemd-Manager verwalteten Einheiten zu finden. Falls systemd Synapse nicht direkt startet, hat diese Überschreibung möglicherweise keine Wirkung.
Nehmen Sie den Wert MainPIDaus der Ausgabe und untersuchen Sie diesen Prozess. Ersetzen Sie dessen numerische PID durch PID:
grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l
Der erste Befehl zeigt die Soft- und Hard-Limits des laufenden Prozesses an; der zweite zählt seine aktuell geöffneten Deskriptoren. Liegt die Anzahl nahe am Soft-Limit und enthält das Protokoll die Einträge „ Too many open filesoder“ Errno 24, ist ein prozessspezifisches Limit eine plausible Ursache. Der Kernel stellt diese Werte über die Funktion ` processlimits` bereit /proc/<pid>/limits; siehe dazu die Referenz zu Linux-Prozesslimits .
Nehmen wir Rowans Beispiel: Angenommen, das Prozesslimit liegt bei 1.024 und die Anzahl der Deskriptoren ist nahe daran. Das spricht für eine Anpassung der Einheit. Liegt der Prozess weit von seinem Limit entfernt, sollten Sie den gesamten Fehler und die Ressourcennutzung prüfen, bevor Sie die Limits erhöhen; möglicherweise liegt ein Speicherleck oder ein anderer Fehler vor.
Die Beispiel-Prozesslimittabelle zeigt ein weiches Limit von 1024 offenen Dateien und ein höheres hartes Limit. Überprüfen Sie den laufenden Synapse-Prozess, anstatt sich auf das ulimit der Login-Shell zu verlassen.
Erhöhen Sie das Limit mit einem systemd-Drop-in
Ein Drop-in fügt eine kleine Überschreibung hinzu, ohne die Vendor-Unit des Pakets zu bearbeiten. Bei einer typischen systemd-Installation erstellen Sie die Überschreibung für die eigentliche Master-Unit:
sudo systemctl edit matrix-synapse.service
Geben Sie diese Einstellung im Editor ein:
[Service]
LimitNOFILE=65536
Speichern und beenden. 65536Dies ist ein Beispiel, kein von Synapse vorgegebener Wert. Wählen Sie einen Wert oberhalb der beobachteten Spitzenlast mit Spielraum, innerhalb der unterstützten Hardwaregrenze und der Betriebskapazität des Hosts. systemd akzeptiert Ressourcenlimit-Einstellungen wie beispielsweise LimitNOFILE; die Dokumentation weist jedoch darauf hin, dass einige Programme, die verwenden, select(2)Deskriptoren über 1023 nicht verarbeiten können. Stellen Sie sicher, dass die Laufzeitumgebung und die Anwendung den gewählten Wert tolerieren, anstatt ihn blind zu kopieren. Lesen Sie die Dokumentation zu systemd.exec resource-limit .
Laden Sie die Unit-Definitionen neu und starten Sie Synapse neu, damit der Prozess mit dem neuen Limit neu gestartet wird:
Verlassen Sie sich nicht darauf, ulimit -nSystemdienste über Ihre SSH-Sitzung zu ändern. Eine Login-Shell und ein systemd-Dienst erhalten Beschränkungen aus unterschiedlichen Kontexten; die effektive Einstellung des Dienstes muss direkt überprüft werden.
Das systemd-Drop-in legt einen LimitNOFILE-Wert auf Dienstebene fest. Der Beispielwert dient nur der Veranschaulichung; wählen Sie einen Grenzwert, der zum Host und zur Anwendung passt.
Wenden Sie die Beschränkung bei Bedarf auf Arbeiter und Container an.
Wenn Sie Synapse-Worker verwenden, ist jeder Worker ein separater Dienstprozess mit eigenem Ressourcenlimit. Das offizielle systemd-Beispiel verwendet Units wie beispielsweise ` matrix-synapse-worker@generic_worker.serviceWorker`. Erstellen Sie für jede aktive Worker-Unit, die an das Limit stößt, eine passende Drop-in-Unit, zum Beispiel:
Fügen Sie anschließend die gleichen [Service]Zeilen LimitNOFILEhinzu, laden Sie systemd neu und starten Sie den Worker oder das Synapse-Ziel neu. Die Synapse-Dokumentation beschreibt, wie durch einen Neustart des Ziels der Master und seine Worker gemeinsam neu gestartet werden. Überprüfen Sie das effektive Limit jeder betroffenen Einheit einzeln.
Bei Docker oder einem anderen Container-Manager hilft eine Überschreibung des Host-Systems nur dann, wenn die entsprechende Unit den Prozess direkt startet und das Limit weitergibt. Andernfalls muss das Dateideskriptorlimit über die Container-Laufzeitumgebung oder die Orchestrierungskonfiguration festgelegt werden. Anschließend muss der Container neu erstellt/gestartet und der darin laufende Prozess überprüft werden. Die Installationsdokumentation von Synapse listet das offizielle Container-Image auf; da die Paketdetails variieren, sollte die aktuelle Konfiguration der Laufzeitumgebung geprüft werden, anstatt einen Befehl anzuwenden, der nur auf dem Host gilt.
Nach dem Neuladen von systemd und dem Neustart des Dienstes beträgt das angezeigte effektive Limit 65.536 und die Synapse-Einheit ist in diesem Beispiel aktiv.
Überprüfen Sie, ob Synapse ordnungsgemäß funktioniert.
Nach dem Neustart führen Sie den Prozess mit der neuen Haupt-PID erneut aus systemctl showund überprüfen Sie ihn /proc/PID/limits. Die effektiven Soft- und Hard-Limits sollten den konfigurierten Wert widerspiegeln. Prüfen Sie das Protokoll auf Startfehler und neue Too many open filesFehler. Senden Sie anschließend eine Clientanfrage und bestätigen Sie, dass die betroffene Federation- oder Worker-Aktivität wieder aufgenommen wurde.
Wenn die Fehlermeldung Too many open files in systemoder die Protokolle auf die Kernel-Dateitabelle hinweisen, überprüfen Sie diese /proc/sys/fs/file-nr: Die erste Zahl gibt die Anzahl der zugewiesenen Dateihandles an, die dritte das Maximum. Ein systemweiter Mangel ist etwas anderes als das Erreichen des eigenen Deskriptorlimits von Synapse; untersuchen Sie andere Dienste und die globale Kapazität, bevor Sie Änderungen auf Kernel-Ebene in Betracht ziehen. Die Linux- Referenzdokumente zum proc-Dateisystemfile-nr und file-max.
Für Rowan ist die Fehlerbehebung erst dann verifiziert, wenn der neu gestartete Prozess das vorgesehene Limit erreicht hat, Synapse aktiv bleibt und der ursprüngliche Protokollfehler unter der entsprechenden Arbeitslast nicht mehr auftritt. Steigt die Nutzung weiter in Richtung des neuen Limits, sollten Sie Deskriptorlecks oder Kapazitätsengpässe untersuchen, anstatt die Anzahl wiederholt zu erhöhen.