インサイト
Bitrise Insightsでは、Build Cacheのパフォーマンスに関する詳細なメトリクスを確認できます。invocation count、コマンド実行時間、キャッシュヒット率などが含まれます。任意のインボケーションからexplore Insightsできます。
-
Build Cacheを開きます。
-
Invocation detailsページを開きます。
-
Explore Insights をクリックします。
または、カード上のいずれかのメトリクスをクリックして Insights に移動することもできます。

キャッシュのメトリクスは、build cacheメトリクスとコマンドメトリクスとして提供されます。
Build cacheメトリクスClick to copy link
Build cacheメトリクスにより、Bitrise Build Cacheシステムの状況をデータに基づいて把握できます。非効率なキャッシュによる予測不能な挙動を減らし、より一貫性のある信頼性の高いCI/CDワークフローを実現できます。
Bitrise Build Cacheが正しく設定されていれば、Insights のデータにアクセスするために追加の設定は不要です。次のBuild Cacheメトリクスを利用できます。
-
Invocation count: このメトリクスは、ビルドでキャッシュがどの程度の頻度で使用されているかを示し、実行されているコマンドの頻度と種類を把握するのに役立ちます。invocation countが高い場合はキャッシュが十分に活用されていることを示し、低い場合はキャッシュが十分に活用されていない可能性があります。
-
Uploads/ダウンロード: このメトリクスは、コマンドごとのbuild cacheとの間のデータ転送量を示します。データ転送量が多い場合は、過剰なアップロードやダウンロードが発生し、ビルドが遅くなっている可能性があります。ダウンロード がアップロードより大幅に少なくない場合は、キャッシュが非効率である可能性があります。Insights には、アップロードとダウンロードの両方について、インボケーションごとの p50(中央値)と p90 の値が表示されます。つまり、1 回のインボケーションがアップロードおよびダウンロードするデータ量です。

-
Cache hit rate: このメトリクスは、build cacheで処理できたデータリクエストの割合を示します。Insights には、p10 のヒット率(ヒット率がそれ以下になるケースが全体の 10% のみであることを意味します)と、中央値(p50)のヒット率が表示されます。ヒット率が低い場合はキャッシュ設定が最適でないか、cache keysが正しく定義されていないことを示唆するため、特に p10 の値が重要です。
Build Cacheメトリクスでは、Insights の他のメトリクスと同様に、次の操作を行えます。
- ダッシュボードを作成する。
- 特定のしきい値に対してアラートを設定する。
build cacheメトリクスの一般的なユースケースClick to copy link
メトリクスが急激かつ大きく変動している場合は、関連する各インボケーションを確認して、問題がいつ始まったかを調べられます。対象の項目や期間で絞り込み、Related invocations タブを選択してください。アップロード/ダウンロードにもキャッシュヒット率にも役立ちます。
たとえば、ダウンロードに比べてアップロードが急増している場合は、データが繰り返し生成・保存されているものの、ほとんど再利用されておらず、効率が下がっている可能性があります。


別の例として、特定のWorkflowでキャッシュヒット率が急に変化しているケースがあります。これはキャッシュ設定に弱点があることを示唆しています。

invocation countを確認すると、Build Cacheを使って、プロジェクトでキャッシュの使用がいつ始まったか(invocation countが急に増加した時点)、またはいつ止まったか(invocation countが急に減少した時点)を特定できます。


これにより、たとえば、キャッシュ設定を壊している構成上の問題を検出して修正できます。