Accueil
» Comment faire
»
Augmenter la limite de fichiers systemd de Synapse sans tâtonnement
Augmenter la limite de fichiers systemd de Synapse sans tâtonnement
Scénario illustratif : Rowan administre un petit serveur Matrix et constate [Errno 24] Too many open filesune augmentation de l’activité dans les journaux Synapse. Si le processus Synapse en cours d’exécution a atteint sa limite de fichiers ouverts définie par systemd, augmentez cette LimitNOFILElimite via un module complémentaire systemd pour le service concerné, rechargez systemd et redémarrez Synapse. Vérifiez ensuite la limite du processus en cours d’exécution. Ne modifiez pas la limite globale du noyau tant que vous n’avez pas la certitude que la table des fichiers de la machine est saturée.
La limite exacte dépend de l'installation et de la charge de travail ; la valeur indiquée ci-dessous ne correspond pas à un minimum officiel pour Synapse. La documentation actuelle de Synapse concernant systemd décrit un service maître, des unités de travail optionnelles et une cible les regroupant. Adaptez les noms d'unités à votre installation. Consultez la documentation Synapse sur systemd avec des unités de travail .
L'exemple de journalisation montre Synapse signalant l'erreur Errno 24 lors de l'acceptation des connexions. Il s'agit d'une illustration du problème et non d'un journal provenant d'un serveur réel.
Identifiez la limite défaillante.
« Fichiers ouverts » désigne les descripteurs de fichiers : il s’agit des gestionnaires utilisés par un processus pour les sockets, les fichiers, les tubes et autres ressources. Synapse peut nécessiter de nombreux descripteurs pour les connexions client, la fédération, les connexions à la base de données et les workers. Commencez par examiner le service et ses journaux :
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
Remplacez ce matrix-synapse.servicenom si votre unité en porte un autre. Un paquet, un conteneur ou un déploiement personnalisé peut nommer ou lancer le service différemment. Utilisez cette option systemctl list-units '*synapse*'pour trouver les unités gérées par le gestionnaire systemd actuel. Si systemd ne lance pas directement Synapse, cette substitution risque de ne pas fonctionner.
Récupérez le MainPIDPID numérique du processus et examinez-le. Remplacez-le par PID:
grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l
La première commande affiche les limites souples et strictes du processus en cours d'exécution ; la seconde compte ses descripteurs actuellement ouverts. Si ce nombre est proche de la limite souple et que le journal contient Too many open filesdes erreurs Errno 24, une limite par processus est une cause plausible. Le noyau expose ces valeurs via `ls`/proc/<pid>/limits ; voir la documentation sur les limites des processus Linux .
Dans l'exemple de Rowan, supposons que la limite logicielle du processus soit de 1 024 et que le nombre de descripteurs s'en approche. Cela justifie un ajustement de l'unité. Si le processus est loin de sa limite, il convient d'examiner attentivement l'erreur complète et l'utilisation des ressources avant d'augmenter les limites ; une fuite ou une autre défaillance peut en être la cause.
Le tableau des limites de processus d'exemple indique une limite souple de 1 024 fichiers ouverts et une limite stricte plus élevée. Vérifiez le processus Synapse en cours d'exécution plutôt que de vous fier à la limite de votre session.
Augmentez la limite avec un module d'installation systemd
Un fichier de configuration permet d'ajouter une petite modification sans modifier l'unité fournisseur du paquet. Sur une installation systemd classique, créez la modification pour l'unité maître réelle :
sudo systemctl edit matrix-synapse.service
Saisissez ce paramètre dans l'éditeur :
[Service]
LimitNOFILE=65536
Enregistrez et quittez. 65536Ceci est un exemple, et non une valeur recommandée par Synapse. Choisissez une valeur supérieure à la consommation maximale observée, avec une marge de sécurité, dans les limites de la limite matérielle et de la capacité opérationnelle de l'hôte. systemd accepte des paramètres de limite de ressources tels queLimitNOFILE ; sa documentation précise également que certains programmes utilisant cette select(2)limite ne peuvent pas gérer des descripteurs supérieurs à 1 023. Assurez-vous que l'environnement d'exécution et l'application tolèrent la valeur choisie plutôt que de la copier aveuglément. Consultez la documentation relative à la limite de ressources de systemd.exec .
Rechargez les définitions d'unités et redémarrez Synapse pour que le processus soit relancé avec la nouvelle limite :
Ne vous fiez pas à ulimit -nvotre session SSH pour modifier un service système. Un shell de connexion et un service systemd sont soumis à des limites différentes selon le contexte ; il est nécessaire de vérifier directement la configuration effective du service.
Le module systemd permet de définir une valeur LimitNOFILE au niveau du service. La valeur indiquée en exemple est illustrative ; choisissez une limite adaptée à l’hôte et à l’application.
Appliquer la limite aux travailleurs et aux conteneurs lorsque cela est nécessaire
Si vous exécutez des workers Synapse, chaque worker est un processus de service distinct et possède sa propre limite de ressources. L'exemple officiel de systemd utilise des unités telles que `<nom_du_worker>` matrix-synapse-worker@generic_worker.service. Créez un fichier de configuration correspondant pour chaque unité worker active qui atteint sa limite, par exemple : `<nom_du_worker>`.
Ajoutez ensuite les mêmes [Service]lignes LimitNOFILE, rechargez systemd et redémarrez le nœud de calcul ou la cible Synapse. La documentation Synapse indique que redémarrer la cible permet de redémarrer simultanément le nœud maître et ses nœuds de calcul. Vérifiez individuellement la limite effective de chaque unité concernée.
Pour Docker ou un autre gestionnaire de conteneurs, une modification du comportement de systemd sur l'hôte n'est utile que si l'unité lance directement le processus et transmet la limite. Sinon, définissez la limite de descripteurs de fichiers via la configuration d'exécution ou d'orchestration du conteneur, puis recréez/redémarrez le conteneur et examinez le processus à l'intérieur. La documentation d'installation de Synapse indique son image de conteneur officielle ; les détails d'empaquetage varient, vérifiez donc la configuration actuelle de l'environnement d'exécution plutôt que d'appliquer une commande uniquement sur l'hôte.
Après avoir rechargé systemd et redémarré le service, la limite effective affichée est de 65 536 et l’unité Synapse est active dans cet exemple.
Vérifier que Synapse est en bonne santé
Après le redémarrage, relancez le processus systemctl showet vérifiez-le /proc/PID/limitsen utilisant le nouveau PID principal. Les limites logicielles et matérielles effectives doivent correspondre à la valeur configurée. Consultez le journal pour détecter les échecs de démarrage et les nouvelles Too many open fileserreurs, puis effectuez une requête client et confirmez que l'activité de fédération ou de traitement affectée a repris.
Si l'erreur Too many open files in systemou les journaux pointent vers la table des fichiers du noyau, examinez-la/proc/sys/fs/file-nr : son premier nombre correspond au nombre de descripteurs de fichiers alloués et le troisième au nombre maximal. Une pénurie à l'échelle du système est différente du fait que Synapse ait atteint sa propre limite de descripteurs ; examinez les autres services et la capacité globale avant d'envisager des modifications au niveau du noyau. Consultez la documentation de référence du système de fichiers Linux proc .file-nrfile-max
Pour Rowan, la correction n'est validée que lorsque le processus redémarré atteint la limite prévue, que Synapse reste actif et que l'erreur de journalisation initiale ne se reproduit plus sous la charge de travail concernée. Si l'utilisation continue d'augmenter jusqu'à la nouvelle limite, il convient d'examiner les fuites de descripteurs ou les besoins en capacité plutôt que d'augmenter la valeur de manière répétée.