Matrix Synapse에서 PostgreSQL 메모리 사용량 줄이기
PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.
먼저 느린 접속 속도가 특정 방 하나에만 영향을 미치는지, 원격 홈서버 하나에만 영향을 미치는지, 아니면 모든 연합 방에 영향을 미치는지 확인하십시오. 타임아웃을 변경하거나 워커를 추가하기 전에 Synapse의 연합 대상 상태 및 로그를 사용하여 반복되는 실패 지점을 찾으십시오. 접속은 홈서버 경계를 넘나들며 접속 권한 및 방 상태 데이터를 교환하므로, 원격 서버의 속도가 느리거나 방 규모가 큰 경우 자체 서버가 정상 작동하더라도 접속이 지연될 수 있습니다.
Matrix 서버 간 사양은make_join 핸드 셰이크 및 참여하는 서버에 반환되는 상태를 설명합니다 send_join. 즉, "연합 지연"이 자동으로 로컬 Synapse 큐 문제로 귀결되는 것은 아닙니다. 아래 검사에서는 가능한 원인을 구분합니다.
접속 속도가 느린 경우, 다른 페더레이션 룸에 접속할 때와 비교해 보세요. 홈서버의 다른 사용자들도 동일한 지연 현상을 보고하는지 확인하고, 룸 ID 또는 별칭과 관련된 원격 서버 이름을 기록해 두세요. 특정 룸 하나만 접속 속도가 느리다면, 해당 룸의 상태 또는 이미 룸에 참여하고 있는 홈서버가 병목 현상의 원인일 수 있습니다. 동일한 원격 서버를 사용하는 여러 룸의 접속 속도가 느리다면, 해당 서버의 연결 가능성과 재시도 상태를 확인하세요. 서로 관련 없는 여러 서버에 대한 접속 속도가 느리다면, 홈서버의 리소스와 아웃바운드 페더레이션 경로를 점검해 보세요.
해당 원격 서버에 대해 Synapse가 실행 중인 컴퓨터에서 Synapse의 페더레이션 관리 API를 쿼리하십시오.
curl -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
"http://127.0.0.1:8008/_synapse/admin/v1/federation/destinations/remote.example"
홈서버 이름으로 바꾸고 remote.example배포 환경에 맞는 클라이언트-리스너 주소를 사용하십시오. 0이 아닌 retry_last_ts양수 retry_interval값은 Synapse가 최근 연결 실패를 기록하고 재시도하기 전에 대기 중임을 나타냅니다. 실제 실패 원인(예: DNS, TLS, 연결 또는 원격 응답 오류)은 해당 Synapse 로그에서 확인하십시오. Synapse는 이 페더레이션 관리 API를 실험적이며 변경될 수 있다고 명시하고 있으므로, 사용 중인 릴리스의 문서를 참조하십시오. 관리 API는 비공개로 유지하고 액세스 토큰을 공개 지원 요청에 붙여넣지 마십시오.

로컬에서 인증된 목적지 상태 요청을 보여주는 그림입니다. 패널에는 명령만 표시되며 실시간 응답은 표시되지 않습니다.
다른 서버가 사용자의 홈 서버에 연결할 수 없다고 의심되는 경우, 서버 이름으로 Matrix Federation Tester 공식 도구를 실행해 보세요 . 이 도구는 공개 페더레이션 검색 및 연결 상태를 확인합니다. 하지만 이 도구만으로는 Synapse 호스트에서 특정 피어로의 아웃바운드 요청이 성공했는지 여부를 증명할 수는 없으므로, 테스트 결과를 로그 및 대상 상태와 비교하여 확인해야 합니다.
Prometheus가 이미 Synapse 메트릭 엔드포인트를 스크랩하고 있는 경우, 영향을 받는 도메인을 에 추가한 federation_metrics_domains다음 배포 프로세스에 따라 Synapse를 다시 로드하거나 재시작하십시오 . Synapse는 구성 설명서homeserver.yaml 에 설명된 대로 나열된 도메인으로 전송되고 수신된 영구 회의실 이벤트(PDU)의 경과 시간에 대한 Prometheus 메트릭을 노출할 수 있습니다.
federation_metrics_domains:
- matrix.org
- remote.example
생성된 시계열 데이터를 사용하여 송신 또는 수신 이벤트의 경과 시간이 증가하는지 확인하십시오. 이는 방향을 알려주는 단서일 뿐, 최종적인 결론으로 받아들이지 마십시오. Synapse 구성 설명서에서는 지연이 홈 서버 또는 홈 서버 간 네트워크 문제에서 발생할 수 있다고 경고합니다. 여러 목적지로 전송되는 이벤트 시리즈에 지연이 발생하는 경우, 전송 경로 또는 로컬 용량에 문제가 있을 수 있습니다. 특정 피어에만 지연이 발생하는 경우 해당 피어와 해당 피어까지의 경로를 확인해야 합니다.

연합 시대 차트 개념을 나타낸 그림입니다. 선들은 Synapse 서버에서 실시간으로 측정된 값이 아닙니다.

선택한 원격 도메인에 대한 PDU 사용 기간 측정 기능을 활성화하는 데 사용되는 Synapse 설정에 대한 그림입니다.
여러 작업 속도가 느리다면 CPU, 메모리, 데이터베이스 지연 시간, 그리고 Synapse의 트랜잭션 지속 시간 대시보드를 확인하십시오. Synapse의 Grafana 가이드에 따르면 persist_events데이터베이스에 이벤트를 기록하는 작업은 트랜잭션 지속 시간이 길어질 수 있으며, 많은 포워드 익스텐션이 상태 해결 작업을 증가시킬 수 있다고 설명합니다. 조인 작업과 동시에 이러한 로컬 측정값이 상승한다면 페더레이션 재시도 설정을 조정하기 전에 리소스 또는 데이터베이스 병목 현상을 해결해야 합니다.
모니터링 결과 발신 작업이 여러 목적지에 걸쳐 누적되고 현재 프로세스에 제약이 있는 경우에만 송신자 용량을 추가하십시오. 현재 Synapse 워커 문서에서는 기존의 전용 송신자 워커 유형을 기반으로 새 배포를 생성하는 대신 이 역할에 대해 synapse.app.generic_workerwith를 사용하는 것을 권장합니다 .federation_sender_instances
각 발신 대상은 원격 서버 이름의 해시값을 기반으로 발신자에게 할당됩니다. 여러 발신자 워커를 사용하면 트래픽을 여러 원격 서버에 분산시킬 수 있지만, 속도가 느린 특정 대상으로의 요청은 여전히 하나의 워커에 매핑됩니다. 따라서 워커를 추가한다고 해서 단일 피어 문제가 해결될 가능성은 낮습니다. 공유 구성의 워커 이름은 실행 중인 워커와 일치해야 합니다. 발신자 인스턴스 목록을 변경할 때는 모든 페더레이션 발신자를 동시에 중지하고 시작하여 동일한 구성을 사용하도록 해야 합니다.

federation_sender_instances 목록의 예시입니다. 각 이름의 워커는 배포 환경에 반드시 존재해야 합니다.
일시적인 연결 문제를 해결하고 Synapse에서 해당 대상을 실패로 표시했는지 확인한 후에만 대상의 재시도 타이머를 재설정하십시오. 관리자 API는 POST /_synapse/admin/v1/federation/destinations/<destination>/reset_connection엔드포인트를 제공하며, 해당 요청은 백그라운드에서 실행되므로 HTTP 200 응답이 즉시 반환된다고 해서 연동이 복구된 것은 아닙니다. 또한 이 엔드포인트는 실험적인 기능으로 문서화되어 있습니다.
첫 번째 응답으로 타임아웃을 발생시키지 마십시오 federation.client_timeout. 현재 구성 설명서에서는 기본값을 60초로 설정하고 있습니다. 타임아웃 시간을 길게 설정하면 속도가 느린 원격 서버에 응답할 시간을 더 확보해 줄 수 있지만, 서버나 네트워크 속도를 향상시키는 것은 아니며 오히려 참여 요청 대기 시간을 늘릴 수 있습니다. 정상적인 페더레이션 요청이 현재 값을 초과하고 서버 용량을 확인한 경우에만 타임아웃 시간을 변경하십시오.
동일한 회의실 참가 시도를 다시 수행하고 다른 연합 회의실과 비교하십시오. 문제가 발생한 대상 회의실의 재시도 간격이 더 이상 증가하지 않는지, 로그에 연합 요청이 성공적으로 기록되었는지, 구성된 PDU-age 지표가 더 이상 증가하지 않는지 확인하십시오. 다른 대상 회의실은 정상인데 특정 회의실만 속도가 느린 경우, 해당 회의실 ID, 관련된 원격 홈서버, 시간 범위, 그리고 일부 오류 메시지를 회의실 관리자 또는 Synapse 지원팀에 공유하십시오. 액세스 토큰이나 전체 인증 헤더는 전송하지 마십시오.
PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.
Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.
Clear Element는 신뢰할 수 있는 장치 또는 복구 키를 사용하여 미확인 세션 경고를 표시하며, 암호화된 채팅 기록을 보호하는 검사 기능을 제공합니다.
데이터베이스 잠금 경합과 만료된 WebDAV 잠금을 구분한 다음, 적절한 ownCloud 10 해결 방법을 선택하고 구성하십시오.
대상 검사를 통해 빈 ownCloud 웹 화면이 나타나는 원인을 브라우저 캐시, 누락된 웹 자산, 서비스 오류 또는 역방향 프록시 URL 설정으로 추적할 수 있습니다.
ownCloud의 웹 PHP 메모리 제한을 설정하고, 해당 서비스를 재시작한 다음, CLI 설정이나 업로드 제한과 혼동하지 않고 활성 값을 확인하십시오.
MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.
ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.
Keycloak을 통해 TOTP를 활성화하고, 사용자를 안전하게 등록하고, Infinite Scale의 경로 수준 MFA 설정이 적용되는 시점을 파악하세요.