為什麼 Matrix Synapse 會議室加入速度慢——以及需要檢查哪些方面

首先檢查加入速度慢的問題是否僅影響一個房間、一個遠端主伺服器或所有聯盟房間。在變更逾時設定或新增工作節點之前,請使用 Synapse 的聯盟目標狀態和日誌來尋找重複出現的故障。加入操作會跨越主伺服器邊界,並交換加入授權和房間狀態數據,因此即使您自己的伺服器運作正常,遠端伺服器速度慢或房間規模大也可能導致加入延遲。

Matrix伺服器間規範描述了make_join握手send_join過程以及傳回給加入伺服器的狀態。這意味著「聯盟延遲」並非一定是本地 Synapse 佇列的問題。以下檢查將區分可能的原因。

延遲是否僅限於一個房間或一台家庭伺服器?

將加入速度慢的房間與加入其他聯合房間的速度進行比較。詢問您主伺服器上的其他使用者是否報告了相同的延遲,並記錄房間 ID 或別名以及涉及的遠端伺服器名稱。如果只有一個房間速度慢,則可能是該房間的狀態或其中已有的主伺服器存在瓶頸。如果涉及相同遠端伺服器的多個房間速度都很慢,請檢查該目標伺服器的可及性和重試狀態。如果加入多個不相關伺服器的速度都很慢,請檢查您自身的資源和出站聯合路徑。

對於受影響的遠端伺服器,請從執行 Synapse 的機器查詢 Synapse 的 Federation Admin API:

curl -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "http://127.0.0.1:8008/_synapse/admin/v1/federation/destinations/remote.example"

替換remote.example為主伺服器名稱,並使用部署的客戶端監聽器位址。非零值retry_last_ts且為正數retry_interval表示 Synapse 已記錄到最近一次連線失敗,正在等待重試。請檢查對應的 Synapse 日誌以了解實際故障,例如 DNS、TLS、連線或遠端回應錯誤。 Synapse 將此聯合管理 API文件說明為實驗性功能,可能會有所變更;請參閱您所執行版本的文件。請將管理 API 保密,不要將其存取權杖貼到公開的支援請求中。

下列範例終端命令使用管理員令牌查詢 Synapse 對 remote.example 的聯合目標狀態。

本地認證目標狀態請求示意圖。面板僅顯示指令,不顯示即時回應。

如果您懷疑其他伺服器無法存取您的主伺服器,請執行官方的Matrix Federation Tester來測試您的伺服器名稱。此測試器會檢查公共聯盟發現和連接性。但它本身並不能證明從您的 Synapse 主機到特定對等方的出站請求是否成功,因此請將其報告與您自己的日誌和目標狀態進行比較。

Synapse 是否顯示出日益增長的聯邦延遲?

如果 Prometheus 已經抓取了您的 Synapse 指標端點,請將受影響的網域新增至federation_metrics_domains組態中homeserver.yaml,然後根據您的部署流程重新載入或重新啟動 Synapse。 Synapse 可以公開 Prometheus 指標,用於統計發送到您列出的網域以及從這些網域接收的持久房間事件 (PDU) 的年齡,具體說明請參閱設定手冊:

federation_metrics_domains:
  - matrix.org
  - remote.example

利用產生的時間序列來查看出站或入站事件的年齡是否在增加。將其視為方向性線索,而非最終結論:Synapse 的配置文件提醒,延遲可能來自主伺服器或它們之間的網路。多個目標伺服器的出站事件序列滯後,表示問題可能出在您的發送路徑或本地容量上;如果延遲僅出現在一個對等節點,則需要檢查該對等節點及其路由。

標題為「按域劃分的聯邦 PDU 年齡」的範例監控圖,包含兩條時間序列線

聯邦年齡圖表概念示意圖;圖中的線條並非來自 Synapse 伺服器的即時測量值。

以下是 homeserver.yaml 的範例程式碼片段,其中在 federation_metrics_domains 下列出了 matrix.org 和 remote.example。

Synapse 設定用於啟用選定遠端網域的 PDU 年齡指標。

如果很多操作都很慢,請同時檢查 CPU、記憶體、資料庫延遲以及 Synapse 的交易持續時間儀表板。 Synapse 的Grafana 指南指出,persist_events寫入資料到資料庫可能會導致交易持續時間過長;指南還解釋說,大量的前向極端操作會增加狀態解析的工作量。如果這些本地指標在連接操作的同時也升高,請在調整聯邦重試次數之前,先解決資源或資料庫瓶頸問題。

增加聯邦發送節點的工作節點會有幫助嗎?

只有當監控顯示多個目標位置的出站工作積壓且目前進程受限時,才會新增發送方容量。目前的Synapse 工作進程文件建議為此角色使用synapse.app.generic_worker`with`,federation_sender_instances而不是圍繞舊的專用發送方工作進程類型建立新的部署。

每個出站目標都根據遠端伺服器名稱的雜湊值分配給一個發送方。多個發送方工作進程可以將流量分散到多個遠端伺服器上,但對一個慢速目標的請求仍然會對應到一個工作進程。因此,增加工作進程不太可能解決單節點問題。共享配置中的工作進程名稱必須與正在執行的工作進程名稱相符;更改發送方實例清單時,請同時停止並啟動所有聯盟發送方,以便它們使用相同的配置。

以下是一個範例 homeserver.yaml 程式碼片段,其中列出了兩個聯邦發送器工作進程的名稱。

federation_sender_instances 欄位表示意圖;每個命名的工作節點都必須存在於部署中。

應該重置退避機制還是增加超時時間?

僅在解決瞬態連接問題並確認 Synapse 已將該目標標記為失敗後,才能重置目標的重試計時器。管理 API 提供了一個POST /_synapse/admin/v1/federation/destinations/<destination>/reset_connection端點;其請求在背景運行,因此立即返回 HTTP 200 並不意味著聯盟已恢復。此端點也被標記為實驗性功能。

不要將此設定federation.client_timeout為首要響應事項。目前配置手冊中預設值為 60 秒。更長的超時時間可以讓回應較慢的遠端伺服器有更多時間回應;但這並不會加快伺服器或網路速度,反而可能導致加入請求等待時間更長。只有當日誌顯示合法的聯盟請求數量超過目前值,且您已檢查伺服器容量時,才應變更此設定。

你怎麼知道修復奏效了?

重試加入同一個房間,並將其與另一個已加入聯盟的房間進行比較。確認受影響的目標房間不再顯示不斷增長的重試間隔,日誌顯示聯盟請求成功,並且配置的 PDU 年齡指標停止增長。如果只有一個房間仍然緩慢,而其他目標房間運作正常,請將該房間的房間 ID、相關的遠端主伺服器、時間窗口以及經過編輯的錯誤訊息提供給房間管理員或 Synapse 支援團隊。避免發送存取令牌或完整的授權標頭。

留下評論

降低 Matrix Synapse 中的 PostgreSQL 記憶體壓力

找出 PostgreSQL 記憶體消耗是來自查詢工作、共享緩衝區、連接還是維護,然後進行有針對性的、Synapse 安全的變更。

為什麼 Matrix Synapse 會議室加入速度慢——以及需要檢查哪些方面

為什麼 Matrix Synapse 會議室加入速度慢——以及需要檢查哪些方面

在變更 Synapse 設定之前,請追蹤 Matrix 房間加入速度慢的原因,例如遠端 homeserver、聯盟退避、本機資料庫載入或出站傳送佇列。

關閉 Synapse 上的 Matrix 註冊或要求使用邀請令牌

停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。

元素會話身份警告:請安全驗證您的登入訊息

Clear Element 會使用受信任的裝置或復原金鑰發出未驗證會話警告,並進行檢查以保護您的加密聊天記錄。

使用正確的後端解決 ownCloud 檔案鎖定逾時問題

區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。

在正確的運行時清除 ownCloud PHP 記憶體警告

設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。

排查 ownCloud 10 MySQL 連線故障

找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。

為 ownCloud 公共連結設定嚴格的過期時間

為 ownCloud 公共連結設定嚴格的過期時間

在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。