추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

예시 시나리오: Rowan이 소규모 Matrix 홈서버를 관리하고 [Errno 24] Too many open files활동이 증가할 때 Synapse 로그를 확인합니다. 실행 중인 Synapse 프로세스가 systemd 파일 열기 제한에 도달한 경우, LimitNOFILE해당 서비스에 대한 systemd 드롭인에서 제한을 높이고 systemd를 다시 로드한 다음 Synapse를 다시 시작하십시오. 실행 중인 프로세스의 제한을 확인하십시오. 시스템 전체의 파일 테이블이 소진되었다는 증거가 나올 때까지 전역 커널 제한을 변경하지 마십시오.

정확한 제한 값은 설치 환경과 작업 부하에 따라 달라지며, 아래 예시 값은 Synapse의 공식 최소값이 아닙니다. Synapse의 최신 systemd 가이드라인은 마스터 서비스, 선택적 워커 템플릿 유닛, 그리고 이들을 그룹화하는 타겟에 대한 내용을 다룹니다. 유닛 이름은 사용자의 설치 환경에 맞게 조정해야 합니다. 자세한 내용은 Synapse systemd-with-workers 문서를 참조하십시오 .

터미널 창에 matrix-synapse.service 저널 항목과 함께 Errno 24 "열린 파일이 너무 많습니다"라는 메시지가 반복적으로 표시됩니다.
예시로 보여드리는 저널 출력은 Synapse가 연결을 수락하는 동안 Errno 24 오류를 보고하는 것을 보여줍니다. 이는 증상을 설명하기 위한 예시이며 실제 서버 로그는 아닙니다.

어떤 한계점이 실패하는지 알아보세요

"열린 파일"이란 파일 디스크립터를 의미합니다. 파일 디스크립터는 프로세스가 소켓, 파일, 파이프 및 기타 리소스에 사용하는 정보를 처리합니다. Synapse는 클라이언트 연결, 연합, 데이터베이스 연결 및 워커 프로세스를 위해 많은 파일 디스크립터가 필요할 수 있습니다. 먼저 서비스와 해당 로그를 검사하십시오.

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

유닛 이름이 다른 경우 이 값 을 교체하십시오 matrix-synapse.service. 패키지, 컨테이너 또는 사용자 지정 배포는 서비스 이름을 다르게 지정하거나 서비스를 다른 방식으로 시작할 수 있습니다. systemctl list-units '*synapse*'현재 systemd 관리자가 관리하는 유닛을 찾으려면 이 값을 사용하십시오. systemd가 Synapse를 직접 시작하지 않는 경우 이 재정의 설정이 프로세스를 제어하지 못할 수 있습니다.

MainPID출력에서 해당 값을 가져와서 해당 프로세스를 검사하십시오. 해당 프로세스의 숫자 PID를 다음 값으로 대체하십시오 PID.

grep -i 'open files' /proc/PID/limits
ls /proc/PID/fd | wc -l

첫 번째 명령은 실행 중인 프로세스의 소프트 제한과 하드 제한을 보여주고, 두 번째 명령은 현재 열려 있는 디스크립터 수를 계산합니다. 이 수가 소프트 제한에 가깝고 로그에 Too many open files또는 가 포함되어 있으면 Errno 24프로세스별 제한이 원인일 가능성이 높습니다. 커널은 이러한 값을 를 통해 제공합니다 . 자세한 내용은 Linux 프로세스 제한 참조 문서를/proc/<pid>/limits 확인하세요 .

로완의 예시를 보면, 프로세스 소프트 제한이 1,024이고 디스크립터 수가 그 값에 근접했다고 가정해 봅시다. 이 경우 단위를 조정하는 것이 타당합니다. 하지만 프로세스가 제한 값에 훨씬 못 미치는 경우, 제한을 높이기 전에 전체 오류 및 리소스 사용량을 검사해야 합니다. 메모리 누수나 다른 오류가 원인일 수 있습니다.

터미널에 LimitNOFILE=1024가 표시되고, 프로세스 제한 테이블에서 열린 파일의 소프트 제한은 1024이고 하드 제한은 524288입니다.
샘플 프로세스 제한 테이블에는 소프트 파일 열기 제한이 1,024개로 설정되어 있고, 하드 제한은 더 높습니다. 로그인 셸의 ulimit에 의존하지 말고 실행 중인 Synapse 프로세스를 확인하십시오.

systemd 드롭인으로 제한을 높이세요

드롭인 방식은 패키지의 벤더 유닛을 수정하지 않고 작은 오버라이드를 추가합니다. 일반적인 systemd 설치 환경에서는 실제 마스터 유닛에 대한 오버라이드를 생성합니다.

sudo systemctl edit matrix-synapse.service

편집기에 다음 설정을 입력하십시오.

[Service]
LimitNOFILE=65536

저장 후 종료는 65536예시일 뿐, Synapse에서 권장하는 값은 아닙니다. 호스트의 지원되는 하드 제한 및 운영 용량 내에서 관찰된 최대 사용량보다 여유 있는 값을 선택하십시오. systemd는 와 같은 리소스 제한 설정을 허용합니다. LimitNOFILE또한 systemd 문서에서는 일부 프로그램이 select(2)1,023보다 큰 디스크립터를 처리할 수 없다고 경고합니다. 값을 맹목적으로 복사하기보다는 런타임과 애플리케이션이 선택한 값을 허용하는지 확인하십시오. systemd.exec 리소스 제한 문서를 참조하십시오 .

단위 정의를 다시 로드하고 Synapse를 다시 시작하여 새 제한 값으로 프로세스가 다시 시작되도록 하십시오.

sudo systemctl daemon-reload
sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service --no-pager

SSH 세션을 통해 시스템 서비스를 변경하는 데 의존하지 마십시오 ulimit -n. 로그인 셸과 systemd 서비스는 서로 다른 컨텍스트에서 제한을 받으므로 서비스의 실제 설정은 직접 확인해야 합니다.

텍스트 편집기에는 Service 섹션과 LimitNOFILE=65536이 포함된 systemd 드롭인 override.conf 파일이 표시됩니다.
systemd 드롭인은 서비스 수준에서 LimitNOFILE 값을 설정합니다. 예시 값은 설명용이며, 호스트 및 애플리케이션에 적합한 제한 값을 선택하십시오.

필요에 따라 작업자와 컨테이너에 제한을 적용하십시오.

Synapse 워커를 실행하는 경우 각 워커는 별도의 서비스 프로세스이며 자체 리소스 제한이 있습니다. 공식 systemd 예제는 와 같은 단위를 사용합니다 matrix-synapse-worker@generic_worker.service. 제한에 도달하는 모든 활성 워커 단위에 대해 일치하는 드롭인 파일을 생성하십시오. 예를 들면 다음과 같습니다.

sudo systemctl edit matrix-synapse-worker@generic_worker.service

그런 다음 동일한 줄을 추가하고 [Service]systemd LimitNOFILE를 다시 로드한 후 워커 또는 Synapse 타겟을 재시작하십시오. Synapse 설명서에는 타겟을 재시작하면 마스터와 워커가 함께 재시작된다고 나와 있습니다. 영향을 받는 각 장치의 유효 제한을 개별적으로 확인하십시오.

Docker 또는 다른 컨테이너 관리자의 경우, 호스트 systemd 재정의는 해당 유닛이 프로세스를 직접 시작하고 제한을 전달하는 경우에만 효과가 있습니다. 그렇지 않으면 컨테이너 런타임 또는 오케스트레이션 구성을 통해 파일 디스크립터 제한을 설정한 다음 컨테이너를 다시 생성/재시작하고 내부 프로세스를 검사하십시오. Synapse 설치 문서에는 공식 컨테이너 이미지가 나와 있지만 패키징 세부 정보는 다를 수 있으므로 호스트 전용 명령을 적용하는 대신 런타임의 현재 구성을 확인하십시오.

터미널에 systemd 데몬 재로드 및 Synapse 재시작 명령이 표시되고, 이어서 LimitNOFILE=65536과 활성 서비스 상태가 표시됩니다.
systemd를 다시 로드하고 서비스를 재시작한 후 표시되는 유효 제한은 65,536이며 이 예시에서는 Synapse 장치가 활성화되어 있습니다.

Synapse가 정상인지 확인하십시오.

재시작 후 새 메인 PID를 사용하여 다시 실행 systemctl show하고 검사하십시오 /proc/PID/limits. 유효한 소프트 및 하드 제한은 구성된 값을 반영해야 합니다. 저널에서 시작 실패 및 새로운 Too many open files오류를 확인한 다음 클라이언트 요청을 수행하고 영향을 받았던 페더레이션 또는 워커 활동이 재개되었는지 확인하십시오.

오류 메시지 Too many open files in system나 로그에 커널 파일 테이블이 언급되어 있다면, /proc/sys/fs/file-nr해당 테이블의 첫 번째 숫자는 할당된 파일 핸들 수이고 세 번째 숫자는 최대값임을 확인하십시오. 시스템 전체의 리소스 부족은 Synapse가 자체 디스크립터 한계에 도달한 것과는 다릅니다. 커널 수준의 변경을 고려하기 전에 다른 서비스 및 전체 용량을 조사하십시오. Linux proc 파일 시스템 참조 문서를 참조 file-nr하십시오 file-max.

Rowan의 경우, 재시작된 프로세스가 의도한 제한에 도달하고, Synapse가 활성 상태를 유지하며, 관련 작업 부하에서 원래 로그 오류가 더 이상 발생하지 않을 때만 수정 사항이 검증됩니다. 사용량이 새 제한에 계속 가까워지는 경우, 숫자를 반복적으로 늘리는 대신 디스크립터 누수 또는 용량 부족 문제를 조사하십시오.

댓글 남기기

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.

데이터 손실 없이 오래된 Synapse 메시지와 미디어를 정리하세요

Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.

공유 파일을 손상시키지 않고 Synapse 미디어 디스크 공간을 확보하세요

Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.

회의실 기록을 삭제하지 않고 비활성 Matrix 사용자 비활성화

회의실 기록을 삭제하지 않고 비활성 Matrix 사용자 비활성화

기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.

Matrix Synapse에서 PostgreSQL 메모리 사용량 줄이기

PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.

Matrix Synapse 룸 접속이 느린 이유와 확인 사항

Matrix Synapse 룸 접속이 느린 이유와 확인 사항

Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.

Synapse에서 Matrix 가입을 종료하거나 초대 토큰을 요구하세요.

자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.