サーバーのログとクラッシュレポートの読み方
ゲームサーバーのログから大事な 1 行を見つける方法です。ログレベル、スタックトレース、最初のエラーの法則、そしてパネル内でのログとクラッシュレポートの置き場所を扱います。
読了時間6分 · 2026年10月21日に更新 · 著者: GuavaHost Team
サーバーがクラッシュしたり起動を拒んだりしたとき、その理由はほぼ必ずログに書かれています。ログは身構えてしまう見た目ですが、全部を理解する必要はまずありません。必要なのは 1 行を見つけることです。このガイドでは、ログの 1 行の読み方、レベルの意味、スタックトレースの読み方、そしてパネル内でのログとクラッシュレポートの置き場所をお伝えします。
ログ 1 行の構造
Minecraft サーバーの典型的な 1 行です。
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]は時刻です。サーバーの時計なので、ご自身の時間帯と一致しないことがあります。Server threadは、プログラムのどの部分が書いたかです。server thread はメインのゲームループです。INFOはレベル、つまりその行がどれだけ深刻かです。- コロンより後のすべてがメッセージです。
ほかのゲームでは行の書式が違いますが、ほぼすべてがどこかに時刻、レベル、メッセージを含んでいます。
ログレベル
| レベル | 意味 | 心配すべき? |
|---|---|---|
| DEBUG または TRACE | 開発者向けの細かい情報 | ふつうは隠れています。無視してください |
| INFO | 通常の動き。起動、参加、セーブ | いいえ |
| WARN | 何かおかしいが、サーバーは続いている | ときどき。多くの警告は無害な雑音です |
| ERROR | 何かが失敗した | はい、自分の問題と重なるなら |
| FATAL または SEVERE | サーバーが続けられない | はい、ふつうこれがクラッシュそのものです |
すべての警告を追いかけないでください。健康なサーバーでも、毎回の起動で同じ無害な警告をたくさん出します。自分の問題が起きたときに起きているエラーに集中してください。
最初のエラーの法則
本当の問題はひとつでも、その後にエラーの山を生むことがよくあります。サーバーの別の部分が、最初の失敗につまずくからです。画面の最後のエラーは、ふつうは症状です。ふだんどおりに見えた最後の行のあとの最初のエラーが、ふつうは原因です。
- 何事もなく見えた最後の行を見つけます。
- そこから下へ読み、最初の
ERROR、Exception、FATALまでたどります。 - それを直して再起動し、もう一度読みます。失敗するまでに前より先へ進んだなら、進歩しています。
スタックトレースを読む
スタックトレースとは、プログラムが失敗したときに踏んでいた手順の一覧です。Minecraft のプラグインサーバーでよくあるものです。
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
読み方です。
- 最初の行が何が失敗したかを言っています。 ExampleShop というプラグインが起動できませんでした。
- 例外の種類が理由を言っています。
NoClassDefFoundErrorは、そこに無いコードを必要としたという意味です。 atの行が場所を示します。 ゲームの内部ではなく、プラグイン自身の名前のように見覚えのある名前を探してください。Caused byが根っこです。 トレースに複数ある場合、最後のCaused byがふつう本当の理由です。ここでは Vault のクラスが見つからないので、直し方はこのショップが依存している Vault プラグインをインストールすることです。
よくあるエラーとその意味
| 表示 | ふつうの意味 |
|---|---|
NoClassDefFoundError、ClassNotFoundException | 依存関係が足りない、またはプラグインか Mod が別バージョン向け |
NoSuchMethodError | 別のゲームバージョン向けに作られたもの |
OutOfMemoryError | サーバーが RAM を使い切った |
FAILED TO BIND TO PORT または Address already in use | ポートが使われています。多くは 2 つ目のコピーがまだ動いています |
found character '\t' that cannot start any token | YAML の設定ファイルにタブがあります。YAML はスペースしか許しません |
NullPointerException | バグ、または設定の値が欠けているか綴りを間違えている |
クラッシュレポート
ゲームによっては、クラッシュしたときに別途もっと詳しいレポートを書きます。
- Minecraft は
crash-reportsフォルダに、日付と時刻を付けた名前で保存します。上のほうにDescriptionの行と例外があります。Mod 入りのサーバーは読み込まれたすべての Mod を列挙し、Forge と NeoForge のレポートは疑わしい Mod を指し示すことがよくあります。 - Java 自体を落とす Java のクラッシュは、サーバーのメインフォルダに
hs_err_pidに数字が続く名前のファイルを残します。これらはふつう、プラグインではなくメモリかネイティブのライブラリを指しています。
パネル内でのログの置き場所
Console タブには実行中の出力が表示されます。保持されるのは直近の行だけなので、それより古いものは Files タブでログファイルを開くか、SFTP でダウンロードしてください。
| ゲーム | 見る場所 |
|---|---|
| Minecraft Java | logs/latest.log。古いログは logs の中の .log.gz ファイル (ダウンロードして展開してください)。クラッシュは crash-reports |
| BepInEx 入りの Valheim | BepInEx/LogOutput.log |
| ARK: Survival Evolved と Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | DoNotStarveTogether/config/server/Master と .../Caves の中の server_log.txt、シャードごとに 1 つ |
| Enshrouded | enshrouded_server.json の logDirectory で指定したフォルダ。既定では logs |
| その他のゲーム | Console が出力したもの。あわせて logs や Logs フォルダ、.log で終わるファイルを探してください |
パネルがクラッシュを報告したとき
サーバーのプロセスが予期せず止まると、パネルが独自のメッセージでサーバーのクラッシュを伝え、終了コードを添えることがあります。知っておくとよいものをいくつか挙げます。
- 0: 通常の停止です。
- 1: エラーのためゲームが終了しました。すぐ上の行を読んでください。
- 137: プロセスが強制的に終了させられました。ふつうはメモリ上限を超えたためです。サーバーの RAM が足りなくなっているサイン をご覧ください。
- 139: ゲーム自体の中で起きたネイティブのクラッシュです。
長いログを検索する
- ログをダウンロードし、テキストエディタで開きます。
- 検索 (Ctrl+F、Mac では Cmd+F) で
ERROR、次にException、次にCaused byを探します。 - 最後に追加したプラグインか Mod の名前で検索します。
- タイムスタンプを、問題が起きた時刻と照らし合わせます。
ログを添えて助けを求める
何事もなかった最後の行から、最初のエラーの終わりまでをコピーし、スクリーンショットではなくテキストとして貼ってください。どこかで共有する前に、パスワード、トークン、その他プライベートなものを取り除いてください。そのうえで当社の Discord にお持ちいただければ、チームが一緒に読みます。とくに起動時の問題については サーバーが Starting のまま止まる をご覧ください。
まだ解決しませんか?Discordのdiscord.gg/GuavaHostに来ていただければ、チームがお手伝いします。
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
まだ解決しませんか? チームが24時間365日オンラインでご質問にお答えします。