docs: sync zh/ja/ko troubleshooting with daemon.log rotation + daemon.err.log (MUL-4330)

Co-authored-by: multica-agent <github@multica.ai>
This commit is contained in:
J
2026-07-10 15:41:15 +08:00
parent 863952d35e
commit e969842f59
3 changed files with 12 additions and 3 deletions

View File

@@ -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 <container>` |
| **サーバー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`。フォアグラウンドで実行すると、ログはローテーションファイルではなくターミナルにリアルタイムで出力されます。

View File

@@ -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 <container>` |
| **서버(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`. 포그라운드로 실행하면 로그가 로테이션 파일이 아니라 터미널에 실시간으로 출력됩니다.

View File

@@ -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 <container>` |
| **服务器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`。前台运行会把日志实时打到终端,而不是写入轮转文件。