Skip to main content

Insights for the Build Cache

Bitrise Insights offers detailed metrics on the performance of your Build Cache, including invocation count, command duration, or cache hit rate. You can explore Insights starting from any invocation:

  1. Open the Build Cache.

  2. Open the Invocation details page.

  3. Click Explore Insights.

    Alternatively, clicking any of the metrics on the card takes you to Insights.

    cache-insights-explore.png

Caching metrics are available as build cache metrics and command metrics.

ビルドキャッシュメトリクス

概要

ビルドキャッシュメトリクスは、データに基づく可視性を提供します。 Bitrise ビルドキャッシュ システム。非効率的なキャッシュに伴う予測不可能性を軽減することで、より一貫性と信頼性の高い CI/CD ワークフローを実現できます。

ビルドキャッシュメトリクスは、データに基づく可視性を提供します。 Bitrise ビルドキャッシュ システム。非効率的なキャッシュに伴う予測不可能性を軽減することで、より一貫性と信頼性の高い CI/CD ワークフローを実現できます。

Bitrise Build Cache が正しく設定されていれば、Insights のデータにアクセスするために追加の設定は必要ありません。次の Build Cache メトリックが利用可能です。

  • 呼び出し回数: このメトリックは、ビルドでキャッシュが使用される頻度を示し、実行されるコマンドの頻度と種類を理解するのに役立ちます。呼び出し回数が多いとキャッシュが広く採用されていることを示し、呼び出し回数が少ないとキャッシュが十分に活用されていない可能性があります。

  • アップロード/ダウンロード: これは、各コマンドごとのビルド キャッシュとの間のデータ転送量を測定します。データ転送量が多いと、アップロードまたはダウンロードが多すぎることを示し、ビルドの速度が低下する可能性があります。ダウンロードがアップロードよりも大幅に低くない場合は、キャッシュが非効率的であることを示している可能性があります。Insights では、アップロードとダウンロードの両方について、呼び出しごとの p50 (中央値) 値と p90 値が表示されます。

    p90-uploads.png
  • キャッシュヒット率: これは、ビルド キャッシュで処理できるデータ リクエストの割合を測定します。Insights には、p10 ヒット率 (つまり、同等またはそれ以下のヒット率になるケースは 10% のみ) と中央値 (p50) ヒット率が表示されます。ヒット率が低い場合、キャッシュ構成が最適ではないか、キャッシュ キーが誤って定義されていることを示しているため、p10 値は特に重要です。

ビルド キャッシュ メトリックについては、Insights の他のメトリックと同様に、次のことが可能です。

ビルドキャッシュメトリクスの一般的な使用例

メトリクスに突然の大きな変化が見られる場合、関連する呼び出しをそれぞれチェックして、問題がいつ始まったのか調べることができます。関連する項目/期間をフィルタリングし、 関連する呼び出し タブ。これは、アップロード/ダウンロードまたはキャッシュヒット率の両方に役立ちます。

たとえば、ダウンロード数と比較してアップロード数が急増した場合、データは繰り返し生成され保存されているものの、ほとんど再利用されず、効率が低下している可能性があります。

trends.png
issues-list.png

別の例として、特定のワークフローのキャッシュ ヒット率が突然変化した場合を示します。これは、キャッシュ設定に弱点があることを示しています。

cache-hit-rate-workflow.png

ビルド キャッシュを使用すると、呼び出し回数を確認して、プロジェクトがいつ開始されたか (呼び出し回数が突然急増したとき)、またはいつ停止されたか (呼び出し回数が突然減少したとき) を識別できます。

started-build-cache.png
stopped-using-cache.png

これは、たとえば、キャッシュ設定を壊す構成の問題を検出して修正するのに役立ちます。