ビルドログの表示

すべてのOrbitデプロイメントは、完全なビルドログ、ビルドが実行した内容と各フェーズの所要時間の構造化された分析を保持しています。このガイドでは、ログの場所、周辺のメタデータの読み方、Orbitがログに対して実行する分析について説明します。

最新のデプロイメントのログを表示する

Orbitでプロジェクトを開きます。OverviewタブのLatest buildパネルに、最新のデプロイメントのログが表示されます。ビルドが現在実行中の場合、ログはビルドエージェントが生成する行ごとにライブストリーミングされます。

Full detailsをクリックして、完全なデプロイメント詳細ページを開きます。

特定のデプロイメントのログを表示する

1. Orbitでプロジェクトを開きます。
2. Deploymentsタブを開きます。
3. 任意のデプロイメントをクリックして、その詳細ページを開きます。
4. 完全なビルドログはそのページに表示されます。

Overview タブのRecent deploymentsリストの各行には、同じ場所へのリンクとなるView logsリンクがあります。プレビューデプロイメントはPreview deploymentsセクションに同じリンクがあります。

ビルドフェーズ

詳細ページはビルドを名前付きフェーズに分割し、各フェーズの期間を表示します:

これは「そのビルドが遅かった理由は?」という質問に最速で答える方法です。Cold buildバッジ付きの長いInstallフェーズはキャッシュミスを意味します。長いBuildフェーズは、独自のビルドが遅くなったことを意味します。

ビルドメタデータ

ログの上のカードにはデプロイメントについての事実が表示されます:

Orbitがログに対して実行する分析

詳細ページは単なるテキストダンプではありません。Orbitはログを解析して重要な情報を表示します。

• Build timelineフェーズごとの期間付き。
• Slow build detectedビルドが独自の中央値より大幅に遅い場合、パーセンテージと過去10回のビルドからの典型的な時間付き。
• TypeScript errorsビルドがタイプチェックで失敗した場合、抽出され集計される。
• Build analysis Next.jsビルド用: ルートごとのサイズ、初回読み込みJS、および静的、動的、ISRルート数。
• Bundle regression警告ルートの初回読み込みJSが前のデプロイメント比で20%以上増加した場合、または共有JSバンドルが増加した場合。
• npm audit結果インストール出力から直接解析され、重大度別に要約される。
• Security headers audit 60点満点で採点される。
• Smoke test結果、スモークテストパスを設定している場合。
• Performance budgets超過した場合、設定されたバジェットがある場合。
• Build optimization advisor具体的な変更を推定される節約サイズとともにリスト表示、影響度でランク付け。
• Real user metricsそのデプロイメントがライブだった間に記録されたp75 Core Web Vitals。

ビルドが実際に見た環境変数

詳細ページには、ビルド時に注入された環境変数のキーがリストされ、現在の設定と比較されます: 追加、変更、削除、変更なし。ティール色のキーは環境固有のオーバーライドから、グレーのキーはプロジェクトレベルからのものです。

値は保存されたり表示されたりすることはありません。キーにマウスを置くとSHA-256フィンガープリントが表示され、値を明かすことなく2つの環境が同じ値を持っていることを確認するのに十分です。

2つのデプロイメントを比較する

デプロイメントのCompareをクリックして、前のものとdiffします: ビルド時間、アーティファクトサイズ、キャッシュ状態、フレームワーク、およびファイルレベルのアーティファクトdiff。これは「実際に何が変わったか」を確認したい場合の最速のルートです。

ビルドが失敗した場合

ステータスカードはFailedに変わり、ログは停止した場所を表示します。ログの上に、Orbitはカテゴリ化された失敗の要約と提案される修正を追加します。認識されるカテゴリはメモリ不足、コンパイルエラー、テスト失敗、lintエラー、インストールエラー、ネットワークエラー、タイムアウトを含み、Orbitは不足しているモジュール、ERESOLVEピア依存関係の競合、TypeScriptエラーコード、ディスク容量満杯、パッケージ404、および古いロックファイルなどの特定のパターンと照合します。

また、Get AI diagnosisボタンがあり、ログの最後の120行とともに検出されたフレームワークと失敗カテゴリを読み込んで、わかりやすい説明を返します。

失敗したビルドを再試行する

デプロイメント詳細ページでRetry buildをクリックして、新しいコミットをプッシュしないで同じコミットを再実行します。これはインストール中のネットワークエラーなどの一時的な失敗を修正します。

キャッシュされた古い依存関係を疑う場合は、More retry optionsを使用して、Retry with cleared cacheを選択します。これはビルドキャッシュを削除してから再試行します。

失敗ごとの詳細なガイダンスはトラブルシューティング失敗したビルドにあります。

実行中のビルドをキャンセルする

ビルドの実行中にCancelをクリックします。

アーティファクトをダウンロードする

すべての成功したデプロイメントはパッケージ化された出力を保持します。ArtifactカードのDownloadをクリックして、提供された正確なバンドルをプルします。また、バンドル全体をダウンロードすることなく内容を検査するためのアーティファクトブラウザもあります。

アーティファクトが保持される期間は、SettingsのArtifact retentionで設定されます: 環境ごとに保持する成功したアーティファクトの数、10から500まで、デフォルトは50です。古いアーティファクトは毎日削除されます。現在ライブのデプロイメントのアーティファクトは、設定に関係なく常に保持されます。

関連記事

• トラブルシューティング失敗したビルド
• デプロイメントをロールバックする
• プロジェクトをデプロイする