From 8454cd09cfa5831e02d8085872c99073e3ccbd27 Mon Sep 17 00:00:00 2001 From: Jizhou Deng Date: Tue, 28 Oct 2025 15:44:29 +0800 Subject: [PATCH 1/3] 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. + From 57f818ead3379c7858be78b3260dd1e7d015be62 Mon Sep 17 00:00:00 2001 From: Djz <60094659+Djz0725@users.noreply.github.com> Date: Tue, 28 Oct 2025 15:59:38 +0800 Subject: [PATCH 2/3] fix some errors --- manual/administration/logs.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/manual/administration/logs.md b/manual/administration/logs.md index bbcb9cb4..eb2b7ac2 100644 --- a/manual/administration/logs.md +++ b/manual/administration/logs.md @@ -26,9 +26,7 @@ The logs for seadoc server are located under `/opt/seadoc-data/logs`. * 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. - +* sdoc_operation_log_clean.log: logs for recording the scheduler activity of the seadoc-converter service’s operation log cleanup job to verify the maintenance task is running on schedule. ### Log files for seasearch server From 323baf8f232a41bf1b474713e3b3b6a4e664c891 Mon Sep 17 00:00:00 2001 From: Djz <60094659+Djz0725@users.noreply.github.com> Date: Tue, 28 Oct 2025 16:23:32 +0800 Subject: [PATCH 3/3] fix some errors --- manual/administration/logs.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/manual/administration/logs.md b/manual/administration/logs.md index eb2b7ac2..d4f93133 100644 --- a/manual/administration/logs.md +++ b/manual/administration/logs.md @@ -19,18 +19,20 @@ ### Log files for seadoc server -The logs for seadoc server are located under `/opt/seadoc-data/logs`. +The logs for seadoc server are located in the `/opt/seadoc-data/logs` directory. * 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 scheduler activity of the seadoc-converter service’s operation log cleanup job to verify the maintenance task is running on schedule. +* 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 to verify the maintenance task is running on schedule. + ### Log files for seasearch server -The logs for seasearch server are located under `/opt/seasearch-data/log`. +The logs for seasearch server are located in the `/opt/seasearch-data/log` directory. * 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.