ログとストリーミング

Zeabur は、すべてのサービスにリアルタイムのログストリーミングを提供し、ダッシュボードから直接アプリケーションの動作を即座に確認できます。

ログの表示

サービスのログを表示するには：

1. Zeabur ダッシュボードでプロジェクトを開きます。
2. 確認したいサービスを選択します。
3. Logs タブをクリックします。

ログビューアは、アプリケーションの stdout と stderr ストリームからの出力をリアルタイムで表示します。新しいログエントリは発行されると自動的に表示されます。手動で更新する必要はありません。

ビルドログとランタイムログ

Zeabur はログを2つのカテゴリに分類します：

• ビルドログ — ビルドフェーズ中に生成された出力（依存関係のインストール、コンパイルなど）。各デプロイの Deployments タブで確認できます。
• ランタイムログ — サービスの実行中に生成された出力。Logs タブに表示され、リアルタイムでストリーミングされます。

検索とフィルタリング

ログビューアは、特定のエントリを見つけるためのキーワード検索をサポートしています。ログビューア上部のフィルターバーに検索語を入力すると、一致する行がハイライトされてフィルタリングされます。

これは以下のような場合に特に便利です：

• エラーメッセージやスタックトレースの検索
• 特定のリクエスト ID のトレース
• ログレベル（ERROR、WARN など）によるフィルタリング

ログの保持

ランタイムログは、サービスが実行されている間利用可能です。サービスが再起動または再デプロイされると、以前のインスタンスのログはダッシュボードでアクセスできなくなります。

ベストプラクティス

• 構造化ログを使用してください。 特に外部サービスに転送する場合、ログを JSON 形式で出力すると検索やパースが容易になります。
• タイムスタンプを含めてください。 Zeabur はログエントリにタイムスタンプを追加しますが、アプリケーション出力にも含めることで環境間の一貫性が確保されます。
• 適切なレベルでログを記録してください。 日常的なイベントには INFO、回復可能な問題には WARN、注意が必要な障害には ERROR を使用してください。本番環境では過度な DEBUG 出力を避けてください。
• 機密データをログに記録しないでください。 パスワード、API キー、個人を特定できる情報は決してログに記録しないでください。