Home
» Come fare
»
Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.
Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.
Scenario esemplificativo: Rowan amministra un piccolo homeserver Matrix e visualizza i log di Synapse [Errno 24] Too many open filesquando l'attività aumenta. Se il processo Synapse in esecuzione ha raggiunto il limite di file aperti di systemd, genera un'eccezione LimitNOFILEin un drop-in di systemd per il servizio interessato, ricarica systemd e riavvia Synapse. Verifica il limite sul processo in esecuzione. Non modificare un limite globale del kernel finché non hai la prova che la tabella dei file a livello di sistema è esaurita.
Il limite esatto dipende dall'installazione e dal carico di lavoro; il valore di esempio riportato di seguito non rappresenta un minimo ufficiale per Synapse. Le attuali linee guida di Synapse per systemd prevedono un servizio master, unità modello worker opzionali e un target che le raggruppa. Assicurati che i nomi delle unità corrispondano alla tua installazione. Consulta la documentazione di Synapse su systemd con worker .
L'esempio di output del registro mostra Synapse che segnala l'errore Errno 24 durante l'accettazione delle connessioni. Illustra il sintomo e non è un log proveniente da un server reale.
Scopri quale limite non funziona
"File aperti" si riferisce ai descrittori di file: gestiscono i processi che utilizzano socket, file, pipe e altre risorse. Synapse potrebbe aver bisogno di molti descrittori per le connessioni client, la federazione, le connessioni al database e i worker. Per prima cosa, esamina il servizio e i relativi log:
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
Sostituire matrix-synapse.servicese l'unità ha un nome diverso. Un pacchetto, un container o una distribuzione personalizzata possono assegnare un nome diverso al servizio o avviarlo in modo differente. Utilizzare questo comando systemctl list-units '*synapse*'per trovare le unità gestite dal gestore systemd corrente. Se systemd non avvia Synapse direttamente, questa sovrascrittura potrebbe non controllare il processo.
Prendi il valore MainPIDdall'output e ispeziona quel processo. Sostituisci il suo PID numerico con PID:
grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l
Il primo comando mostra i limiti soft e hard del processo in esecuzione; il secondo conta i descrittori attualmente aperti. Se il conteggio è vicino al limite soft e il log contiene Too many open fileso Errno 24, un limite per processo è una causa plausibile. Il kernel espone questi valori tramite /proc/<pid>/limits; vedere il riferimento ai limiti dei processi Linux .
Nell'esempio di Rowan, supponiamo che il limite flessibile del processo sia 1.024 e che il conteggio dei descrittori sia vicino a tale valore. Questo giustifica la regolazione dell'unità. Se il processo è ben lontano dal suo limite, è necessario esaminare l'intero flusso di errori e l'utilizzo delle risorse prima di aumentare i limiti; una perdita di memoria o un altro tipo di errore potrebbero esserne la causa.
La tabella dei limiti di processo di esempio mostra un limite di apertura file "soft" di 1.024 e un limite "hard" più elevato. Controlla il processo Synapse in esecuzione invece di affidarti al limite ulimit della shell di login.
Aumenta il limite con un'implementazione di systemd
Un drop-in aggiunge una piccola sovrascrittura senza modificare l'unità del fornitore del pacchetto. In una tipica installazione di systemd, crea la sovrascrittura per l'unità master effettiva:
sudo systemctl edit matrix-synapse.service
Inserisci questa impostazione nell'editor:
[Service]
LimitNOFILE=65536
Salva ed esci. 65536è un esempio, non un valore prescritto da Synapse. Scegli un valore superiore al picco di utilizzo osservato con un margine di sicurezza, entro il limite massimo supportato dall'host e la capacità operativa. systemd accetta impostazioni di limite delle risorse come LimitNOFILE; la sua documentazione avverte anche che alcuni programmi che utilizzano select(2)non possono gestire descrittori superiori a 1.023. Verifica che il runtime e l'applicazione tollerino il valore scelto anziché copiarlo ciecamente. Leggi la documentazione di systemd.exec sul limite delle risorse .
Ricarica le definizioni delle unità e riavvia Synapse in modo che il processo venga riavviato con il nuovo limite:
Non affidarti ulimit -nalla tua sessione SSH per modificare un servizio di sistema. Una shell di login e un servizio systemd ricevono limiti da contesti diversi; è necessario verificare direttamente l'impostazione effettiva del servizio.
Il componente aggiuntivo systemd imposta un valore LimitNOFILE a livello di servizio. Il valore di esempio è puramente illustrativo; selezionare un limite adatto all'host e all'applicazione.
Applicare il limite ai lavoratori e ai contenitori quando necessario
Se si utilizzano i worker di Synapse, ogni worker è un processo di servizio separato e ha un proprio limite di risorse. L'esempio ufficiale di systemd utilizza unità come matrix-synapse-worker@generic_worker.service. Creare un drop-in corrispondente per ogni unità worker attiva che sta raggiungendo il limite, ad esempio:
Quindi aggiungi le stesse [Service]righe LimitNOFILE, ricarica systemd e riavvia il worker o il target Synapse. La documentazione di Synapse mostra come riavviare il target per riavviare contemporaneamente il master e i suoi worker. Verifica individualmente il limite effettivo di ciascuna unità interessata.
Per Docker o altri gestori di container, un override di systemd sull'host è utile solo se tale unità avvia direttamente il processo e passa il limite. In caso contrario, impostare il limite di descrittori di file tramite la configurazione di runtime o di orchestrazione del container, quindi ricreare/riavviare il container e ispezionare il processo al suo interno. La documentazione di installazione di Synapse elenca l'immagine container ufficiale; i dettagli di packaging variano, quindi verificare la configurazione corrente del runtime anziché applicare un comando solo sull'host.
Dopo aver ricaricato systemd e riavviato il servizio, il limite effettivo visualizzato è 65.536 e l'unità Synapse è attiva in questo esempio.
Verifica che Synapse funzioni correttamente.
Dopo il riavvio, rieseguire systemctl showe ispezionare /proc/PID/limitsutilizzando il nuovo PID principale. I limiti soft e hard effettivi dovrebbero rispecchiare il valore configurato. Controllare il registro per eventuali errori di avvio e nuovi Too many open fileserrori, quindi effettuare una richiesta client e verificare che l'attività di federazione o di lavoro che era stata interessata sia ripresa.
Se l'errore indica Too many open files in systemo i log puntano alla tabella dei file del kernel, ispeziona /proc/sys/fs/file-nr: il suo primo numero sono gli handle di file allocati e il terzo è il massimo. Una carenza a livello di sistema è diversa dal raggiungimento del limite di descrittori da parte di Synapse; indaga su altri servizi e sulla capacità globale prima di considerare modifiche a livello di kernel. I documenti di riferimento del filesystem proc di Linuxfile-nr e file-max.
Per Rowan, la correzione viene verificata solo quando il processo riavviato raggiunge il limite previsto, Synapse rimane attivo e l'errore di log originale non si ripresenta più con il carico di lavoro in questione. Se l'utilizzo continua ad aumentare verso il nuovo limite, è necessario indagare su eventuali perdite di descrittori o esigenze di capacità anziché incrementare ripetutamente il valore.