From 8454cd09cfa5831e02d8085872c99073e3ccbd27 Mon Sep 17 00:00:00 2001 From: Jizhou Deng Date: Tue, 28 Oct 2025 15:44:29 +0800 Subject: [PATCH] Add log documentation for sdoc-server and seasearch. --- manual/administration/logs.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/manual/administration/logs.md b/manual/administration/logs.md index bb67a7f4..bbcb9cb4 100644 --- a/manual/administration/logs.md +++ b/manual/administration/logs.md @@ -15,3 +15,25 @@ * seafevents.log: Empty * seafile-background-tasks.log: logs for background tasks and office file convertion * seahub_email_sender.log: logs for periodically email sending of background tasks + + +### Log files for seadoc server + +The logs for seadoc server are located under `/opt/seadoc-data/logs`. + +* sdoc-access.log: logs for recording each API request’s method, URL, response status, and processing time to support access auditing and performance monitoring. +* sdoc-access-slow.log: logs for sdoc-server's slow requests. +* sdoc-server.log: logs for tracking the sdoc-server’s periodic background save tasks to verify autosave behavior and service health. +* sdoc-socket.log: logs for tracking real-time collaborative editing operations over the document WebSocket connection to monitor realtime sync performance and diagnose lag. +* sdoc-socket-slow.log: logs for capturing collaborative editing socket operations that exceed the latency threshold to detect realtime performance bottlenecks and diagnose editing lag. +* sdoc_operation_log_clean.log: logs for recording the periodic cleanup task that purges old operation_log records from the database to control log growth and maintain storage health. +* seadoc-converter.log: logs for recording the scheduler activity of the seadoc-converter service’s operation log cleanup job. + + +### Log files for seasearch server + +The logs for seasearch server are located under `/opt/seasearch-data/log`. + +* seasearch.log: logs for recording the SeaSearch service startup and runtime status to confirm the search engine is initialized and ready to serve requests. +* seasearch-access.log: logs for recording incoming HTTP requests to the SeaSearch service to audit search/index queries and detect auth or access issues. +