Início
» Como fazer
»
Aumente o limite de arquivos do Systemd do Synapse sem complicações.
Aumente o limite de arquivos do Systemd do Synapse sem complicações.
Cenário ilustrativo: Rowan administra um pequeno servidor doméstico Matrix e observa o log do Synapse [Errno 24] Too many open filesquando a atividade aumenta. Se o processo do Synapse em execução atingir o limite de arquivos abertos do systemd, crie LimitNOFILEum drop-in do systemd para o serviço afetado, recarregue o systemd e reinicie o Synapse. Confirme o limite no processo em execução. Não altere um limite global do kernel até ter certeza de que a tabela de arquivos de toda a máquina está esgotada.
O limite exato depende da instalação e da carga de trabalho; o valor de exemplo abaixo não é um mínimo oficial do Synapse. As diretrizes atuais do systemd do Synapse abrangem um serviço mestre, unidades de modelo de trabalhador opcionais e um alvo que as agrupa. Ajuste os nomes das unidades à sua instalação. Consulte a documentação do systemd-with-workers do Synapse .
O exemplo de saída do diário mostra o Synapse relatando o erro Errno 24 ao aceitar conexões. Ele ilustra o sintoma e não é um registro de um servidor real.
Descubra qual limite está falhando.
"Arquivos abertos" significa descritores de arquivo: identificadores que um processo usa para sockets, arquivos, pipes e outros recursos. O Synapse pode precisar de muitos descritores para conexões de clientes, federação, conexões de banco de dados e workers. Primeiro, inspecione o serviço e seus logs:
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
Substitua matrix-synapse.servicese sua unidade tiver outro nome. Um pacote, contêiner ou implantação personalizada pode nomear ou iniciar o serviço de forma diferente. Use systemctl list-units '*synapse*'para encontrar unidades gerenciadas pelo gerenciador systemd atual. Se o systemd não iniciar o Synapse diretamente, essa substituição pode não controlar o processo.
Extraia o valor MainPIDda saída e inspecione esse processo. Substitua o seu PID numérico por PID:
grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l
O primeiro comando mostra os limites flexíveis e rígidos do processo em execução; o segundo conta seus descritores abertos no momento. Se a contagem estiver próxima do limite flexível e o log contiver `open` Too many open filesou `open` Errno 24, um limite por processo é uma causa plausível. O kernel expõe esses valores por meio de `ls -l` /proc/<pid>/limits; consulte a referência de limites de processo do Linux .
No exemplo de Rowan, suponha que o limite flexível do processo seja 1.024 e que a contagem de descritores esteja próxima desse valor. Isso justifica o ajuste da unidade. Se o processo estiver muito longe do seu limite, verifique todo o histórico de erros e o uso de recursos antes de aumentar os limites; um vazamento de memória ou outra falha pode ser a causa.
A tabela de limites de processo de exemplo mostra um limite flexível de 1.024 para abertura de arquivos e um limite rígido maior. Verifique o processo Synapse em execução em vez de confiar no limite de acesso (ulimit) do shell de login.
Aumente o limite com um módulo do systemd.
Um comando drop-in adiciona uma pequena sobrescrita sem editar a unidade do fornecedor do pacote. Em uma instalação típica do systemd, crie a sobrescrita para a unidade master real:
sudo systemctl edit matrix-synapse.service
Insira esta configuração no editor:
[Service]
LimitNOFILE=65536
Salve e saia. 65536Este é um exemplo, não um valor prescrito pelo Synapse. Escolha um valor acima do pico de uso observado, com margem de segurança, dentro do limite máximo suportado pelo host e da capacidade operacional. O systemd aceita configurações de limite de recursos como LimitNOFILE; sua documentação também alerta que alguns programas que usam select(2)não conseguem lidar com descritores acima de 1.023. Confirme se o ambiente de execução e o aplicativo toleram o valor escolhido em vez de copiá-lo cegamente. Leia a documentação do systemd.exec sobre limite de recursos .
Recarregue as definições de unidade e reinicie o Synapse para que o processo seja reiniciado com o novo limite:
Não confie na ulimit -nsua sessão SSH para alterar um serviço do sistema. Um shell de login e um serviço systemd recebem limites de contextos diferentes; a configuração efetiva do serviço deve ser inspecionada diretamente.
O módulo systemd define um valor LimitNOFILE em nível de serviço. O valor de exemplo é ilustrativo; selecione um limite adequado ao host e à aplicação.
Aplique o limite de trabalhadores e contêineres quando necessário.
Se você executar workers do Synapse, cada worker será um processo de serviço separado e terá seu próprio limite de recursos. O exemplo oficial do systemd usa unidades como `<worker_name>` matrix-synapse-worker@generic_worker.service. Crie uma unidade equivalente para cada worker ativo que estiver atingindo o limite, por exemplo:
Em seguida, adicione as mesmas [Service]linhas LimitNOFILE, recarregue o systemd e reinicie o worker ou o alvo do Synapse. A documentação do Synapse mostra que reiniciar o alvo reinicia o master e seus workers simultaneamente. Confirme o limite efetivo de cada unidade afetada individualmente.
Para o Docker ou outro gerenciador de contêineres, uma configuração adicional no systemd do host só funciona se essa unidade iniciar o processo diretamente e repassar o limite. Caso contrário, defina o limite de descritores de arquivo por meio da configuração de tempo de execução ou orquestração do contêiner, recrie/reinicie o contêiner e inspecione o processo dentro dele. A documentação de instalação do Synapse lista sua imagem de contêiner oficial; os detalhes do pacote variam, portanto, verifique a configuração atual do tempo de execução em vez de aplicar um comando exclusivo do host.
Após recarregar o systemd e reiniciar o serviço, o limite efetivo exibido é 65.536 e a unidade Synapse está ativa neste exemplo.
Verifique se o Synapse está funcionando corretamente.
Após a reinicialização, execute novamente systemctl showe inspecione /proc/PID/limitsusando o novo PID principal. Os limites rígidos e flexíveis efetivos devem refletir o valor configurado. Verifique o registro de erros em busca de falhas de inicialização e novos Too many open fileserros e, em seguida, faça uma solicitação do cliente e confirme se a atividade de federação ou do worker afetada foi retomada.
Se o erro indicar Too many open files in systemou os logs apontarem para a tabela de arquivos do kernel, inspecione /proc/sys/fs/file-nr: o primeiro número representa os descritores de arquivo alocados e o terceiro, o máximo. Uma escassez em todo o sistema é diferente do Synapse atingir seu próprio limite de descritores; investigue outros serviços e a capacidade global antes de considerar alterações no nível do kernel. Consulte os documentos de referência do sistema de arquivos proc do Linux .file-nrfile-max
Para Rowan, a correção só é verificada quando o processo reiniciado atinge o limite pretendido, o Synapse permanece ativo e o erro original no log não ocorre mais sob a carga de trabalho relevante. Se o uso continuar aumentando em direção ao novo limite, investigue vazamentos de descritores ou necessidades de capacidade em vez de aumentar o número repetidamente.