Analytics タブの概要

Analytics タブは、プロジェクトの動作の全体像を示します。ビルドにかかる時間、成功頻度、プランのビルド分と帯域幅の使用量、ビルドが遅い場合の時間配分などが表示されます。

Analytics の場所

Orbit を開き、プロジェクトをクリックして、プロジェクト タブ ストリップの Observability グループの下から Analytics を選択します。このページは Analytics というタイトルで、このプロジェクトのビルド パフォーマンス、トラフィック、デプロイ頻度をカバーしています。

隣接する 2 つのタブは同じデータを異なる方法でスライスします。Build Insights はビルド期間のパーセンタイルとキャッシュ動作に焦点を当て、Web Vitals は実ユーザーのパフォーマンスをカバーしています。Orbit Build Insights と Orbit Web Vitals を参照してください。

サマリー カード

5 つのカードが上部に並んでいます:

今月の使用量

カードの下にある Usage this month というパネルには、プラン名が表示され、これらの数字がアカウント全体であり、プロジェクト単位ではないことが明記されています。2 つのメータが表示されます:

• ビルド分: プランの月間割当量に対する使用量で、このプロジェクトの使用量が別途表示され、残り分も表示されます。
• 帯域幅 (オリジン): ギガバイト単位で同じ形式で表示されます。

割当量を超過した場合、パネルに超過分と該当費用が表示されます。ビルド分は US$0.05 / 分、オリジン帯域幅は US$0.03 / GB で課金されます (プランに加算)。

また、これまでのレートに基づいて月末までの予測も表示されます。超過を続けた場合の推定超過費用も表示されます。この予測は有用な数字です。問題が発生したときにまだ対応できるからです。

Build Insights

Build Insights ブロックはデータを読み込み、グラフで見つけることを残すのではなく、平易な言語で観察を書きます。表示内容はプロジェクトの状況によって異なります。例えば:

• 成功率ステートメント: 信頼性が高いことへの称賛、または最近の失敗をレビューするプロンプト。
• 前の 2 週間と比較してビルド時間が上下、両方の平均を引用します。
• キャッシュ ヒット率が低い場合、キャッシュを使用したビルド数と、コミット間でキャッシュ キーを安定に保つことについてのアドバイス。
• 月曜日のビルドが遅い場合 (通常はキャッシュが週末に期限切れになることを意味します)。
• 成功率が最も低いブランチ。
• 平均キューウェイトが 90 秒を超えている場合は、ビルドがランナーを待機しています。

これらはヒントと考えてください。判定ではなく、各項目はページの下の方にあるセクションの基になる数字を示しています。

デプロイ頻度、信頼性、およびアクティビティ

3 つの視覚化がペースをカバーしています:

• デプロイ頻度: 過去 30 日間 は 1 日あたりのデプロイ数を示します。
• 信頼性: 過去 8 週間 は成功したビルドと失敗したビルドを 1 週間ごとにスタックし、過去 4 週間のトレンドと比較します。
• デプロイ アクティビティ: 過去 1 年 はカレンダー ヒートマップで、ボリュームで網掛けされ、その日のデプロイが成功したかどうかで色分けされます。

年ごとのヒートマップは、プロジェクトの活動状況を尋ねられた場合に表示するのに適しています。ギャップとクラスタは一目で確認できます。

ビルド パフォーマンス

ビルド パフォーマンス では、成功したデプロイの最後の実行をバーでチャート化し、平均とビルド時間の最速および キャッシュ ヒット率を表示します。バーをホバーするとブランチとコミットが表示され、そのビルドがキャッシュにヒットしたかどうかが表示されます。

ビルド時間のトレンド は各週を P50 に縮小し、今週がより速いか遅いかを報告します。

ビルド時間のパーセンタイル は P50、P90、P99 を示します。脚注が重要な部分です: P90 が低いほど、ビルドはより一貫性があります。P50 は問題なくても P90 が 3 倍である場合、ほとんどのビルドは高速で、時折何か問題が発生しています。これは均一に遅いことと異なる問題です。

キャッシュ効率

キャッシュ効率 ブロックはコールド ビルドとキャッシュされたビルドを直接比較します: 各ビルドの平均期間、節約された総時間、および結果として生じたスピード アップです。

キャッシュされた平均がコールド平均とほぼ同じである場合、キャッシュは復元されていますが、役に立っていません。通常は、インストール ステップがビルドの遅い部分ではないためです。ヒット率自体が低い場合、キャッシュは頻繁に無効化されています。すべてのコミットで変更されるロック ファイルがそれを引き起こします。

環境ごとのビルド統計 は、本番、ステージング、プレビューごとにビルドとキャッシュ ヒットを分割します。ここで、プレビューがビルド分の大部分を消費していることがわかります。

ブランチ別および著者別の統計

2 つのテーブルは過去 30 日間をカバーしています:

• ブランチ別ビルド統計: デプロイ、成功率、ブランチ別の平均ビルド時間。
• 著者別デプロイ統計: プッシュした人別に同じです。

ブランチごとのテーブルは実用的です。成功率が低いブランチは、通常は壊れたテストまたは type-check を持つブランチで、皆がそれを無視することに学んでいます。

キューウェイトと時刻

ビルド キューウェイト: 過去 14 日間 はビルドがキューに入れられてからビルダーが処理を開始するまでの間隔を測定します。脚注は期待値を設定します: 5 秒未満は通常で、スパイクは競合を示します。

時刻別ビルド時間: 過去 90 日間 は UTC での曜日と時刻のヒートマップで、ビルドが最も遅い時刻を示します。セルは網掛けする前に少なくとも 2 つのビルドが必要です。キューウェイトと組み合わせると、遅いビルドがお客様のビルドなのか、多忙な時刻なのかがわかります。

失敗の原因

過去 30 日間の失敗したデプロイは、根本原因に分類されます: コンパイル エラー、インストール失敗、テスト失敗、Lint エラー、タイムアウト、メモリ不足、ネットワーク エラー、または不明。このセクションでは、最上位のカテゴリとそれが失敗の何パーセントかを示しています。

これは「ビルドが失敗し続ける」から、修正すべき特定の内容への最速ルートです。失敗の 3 分の 2 がインストール失敗である場合、問題はコードではなく依存関係の解決です。トラブルシューティング: ビルド失敗 では各カテゴリで実施する内容をカバーしています。

アーティファクト サイズ

時間別アーティファクト サイズ は各ビルドの出力がどの程度の大きさであるかを追跡します。増加、縮小、または安定としてラベル付けされ、最も古いサイズと最新のサイズが表示されます。

アーティファクトが着実に成長している場合は、サイトが遅くなる前に調査する価値があります。通常の原因は、誰も削除されていない画像ディレクトリと、何か巨大なものを引き込んだ依存関係です。

Web Analytics

下部セクションは、過去 30 日間の実際の訪問者からの Core Web Vitals を表示します。トップ ページ、国、リファラー、およびページごとの p75 パフォーマンスが表示されます。

まだ収集スニペットを追加していない場合、このセクションは空白で、設定へのリンクが提供されます。スニペットと各メトリックの意味については Orbit Web Vitals を参照してください。

次に確認する内容

• Orbit Build Insights: パーセンタイルとキャッシュの詳細用。
• Orbit Spending Cap: 超過費用の上限を設定します。
• Orbit Plan Limits: プランに含まれるもの。