From e969842f598da0bf7cded16c832f521788cbb25e Mon Sep 17 00:00:00 2001 From: J Date: Fri, 10 Jul 2026 15:41:15 +0800 Subject: [PATCH] docs: sync zh/ja/ko troubleshooting with daemon.log rotation + daemon.err.log (MUL-4330) Co-authored-by: multica-agent --- apps/docs/content/docs/troubleshooting.ja.mdx | 5 ++++- apps/docs/content/docs/troubleshooting.ko.mdx | 5 ++++- apps/docs/content/docs/troubleshooting.zh.mdx | 5 ++++- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/apps/docs/content/docs/troubleshooting.ja.mdx b/apps/docs/content/docs/troubleshooting.ja.mdx index 98d95c91e4..2abb6a822c 100644 --- a/apps/docs/content/docs/troubleshooting.ja.mdx +++ b/apps/docs/content/docs/troubleshooting.ja.mdx @@ -279,9 +279,12 @@ netstat -ano | findstr :8080 # Windows | 構成要素 | 場所 | コマンド | |---|---|---| | **デーモン** | `~/.multica/daemon.log`（バックグラウンドモード）またはフォアグラウンドの stdout | `multica daemon logs -f --lines 100` | +| **デーモン（クラッシュ）** | `~/.multica/daemon.err.log` | 直接開く——パニックや起動初期のエラーはここに記録されます | | **サーバー（Docker）** | コンテナの stdout | `docker logs -f ` | | **サーバー（systemd）** | journal | `journalctl -u multica-server -f` | | **フロントエンド（dev）** | `pnpm dev` を実行中のターミナル | 直接確認 | | **フロントエンド（ブラウザ）** | DevTools → Console | `F12` を押す | -より詳細なデーモンログが必要な場合は、デーモンをバックグラウンドからフォアグラウンドに移してください: `multica daemon stop && multica daemon start --foreground`。 +バックグラウンドモードでは `daemon.log` はサイズでローテーションされ（デフォルトは 20MB × gzip バックアップ 5 世代。`MULTICA_DAEMON_LOG_MAX_SIZE_MB` / `_MAX_BACKUPS` / `_MAX_AGE_DAYS` で調整可能）、開けないほど大きくなることはありません。Go ランタイムのパニックや logger 初期化前のエラーは、独立した上限付きの `daemon.err.log` に出力されます。 + +より詳細なデーモンログが必要な場合は、デーモンをバックグラウンドからフォアグラウンドに移してください: `multica daemon stop && multica daemon start --foreground`。フォアグラウンドで実行すると、ログはローテーションファイルではなくターミナルにリアルタイムで出力されます。 diff --git a/apps/docs/content/docs/troubleshooting.ko.mdx b/apps/docs/content/docs/troubleshooting.ko.mdx index e089db49c6..dbd20d77eb 100644 --- a/apps/docs/content/docs/troubleshooting.ko.mdx +++ b/apps/docs/content/docs/troubleshooting.ko.mdx @@ -279,9 +279,12 @@ netstat -ano | findstr :8080 # Windows | 구성 요소 | 위치 | 명령 | |---|---|---| | **데몬** | `~/.multica/daemon.log`(백그라운드 모드) 또는 포그라운드 stdout | `multica daemon logs -f --lines 100` | +| **데몬(크래시)** | `~/.multica/daemon.err.log` | 직접 열기 — 패닉/초기 시작 오류가 여기에 기록됩니다 | | **서버(Docker)** | 컨테이너 stdout | `docker logs -f ` | | **서버(systemd)** | journal | `journalctl -u multica-server -f` | | **프런트엔드(dev)** | `pnpm dev`를 실행 중인 터미널 | 직접 확인 | | **프런트엔드(브라우저)** | DevTools → Console | `F12`를 누르세요 | -더 자세한 데몬 로그가 필요하면, 데몬을 백그라운드에서 포그라운드로 옮기세요: `multica daemon stop && multica daemon start --foreground`. +백그라운드 모드에서 `daemon.log`는 크기 기준으로 로테이션되므로(기본값 20MB × gzip 백업 5개; `MULTICA_DAEMON_LOG_MAX_SIZE_MB` / `_MAX_BACKUPS` / `_MAX_AGE_DAYS`로 조정 가능) 열 수 없을 만큼 커지지 않습니다. Go 런타임 패닉과 logger 초기화 이전 오류는 별도의 상한이 있는 `daemon.err.log`에 기록됩니다. + +더 자세한 데몬 로그가 필요하면, 데몬을 백그라운드에서 포그라운드로 옮기세요: `multica daemon stop && multica daemon start --foreground`. 포그라운드로 실행하면 로그가 로테이션 파일이 아니라 터미널에 실시간으로 출력됩니다. diff --git a/apps/docs/content/docs/troubleshooting.zh.mdx b/apps/docs/content/docs/troubleshooting.zh.mdx index 22b929b82f..423f5d6b40 100644 --- a/apps/docs/content/docs/troubleshooting.zh.mdx +++ b/apps/docs/content/docs/troubleshooting.zh.mdx @@ -278,9 +278,12 @@ netstat -ano | findstr :8080 # Windows | 组件 | 位置 | 命令 | |---|---|---| | **守护进程** | `~/.multica/daemon.log`（后台模式）或前台 stdout | `multica daemon logs -f --lines 100` | +| **守护进程（崩溃）** | `~/.multica/daemon.err.log` | 直接打开——panic / 启动早期错误会写到这里 | | **服务器（Docker）** | container stdout | `docker logs -f ` | | **服务器（systemd）** | journal | `journalctl -u multica-server -f` | | **前端（dev）** | `pnpm dev` 所在终端 | 直接看 | | **前端（browser）** | DevTools → Console | 按 `F12` | -需要更详细的 daemon 日志，把它从后台挪到前台跑：`multica daemon stop && multica daemon start --foreground`。 +后台模式下 `daemon.log` 会按大小轮转（默认 20MB × 5 份 gzip 备份；可用 `MULTICA_DAEMON_LOG_MAX_SIZE_MB` / `_MAX_BACKUPS` / `_MAX_AGE_DAYS` 调整），所以文件不会大到打不开。Go 运行时 panic 和 logger 建立前的错误会写到独立且有上限的 `daemon.err.log`。 + +需要更详细的 daemon 日志，把它从后台挪到前台跑：`multica daemon stop && multica daemon start --foreground`。前台运行会把日志实时打到终端，而不是写入轮转文件。