このページでは、キャッシュ ヒット率を確認する方法と、リモート実行のコンテキストでキャッシュ ミスを調査する方法について説明します。
このページでは、リモート実行を正常に利用するビルドまたはテストがあり、リモート キャッシュを効果的に利用していることを確認することを前提としています。
キャッシュ ヒット率を確認する
Bazel の実行の標準出力で、プロセスを一覧表示する INFO 行を探します。これは、Bazel アクションにほぼ対応しています。この行には、アクションが実行された場所が詳しく記載されています。リモートで実行されたアクションを示す remote ラベル、ローカル
サンドボックスで実行されたアクションを示す linux-sandbox、その他の実行戦略を示すその他の値を探します。結果がリモート
キャッシュから取得されたアクションは remote cache hit と表示されます。
次に例を示します。
INFO: 11 processes: 6 remote cache hit, 3 internal, 2 remote.
この例では、リモート キャッシュ ヒットが 6 回あり、2 つのアクションはキャッシュ ヒットがなく、リモートで実行されました。3
つの内部パーツは無視できます。
通常、シンボリック リンクの作成など、小さな内部アクションです。この概要には、ローカル キャッシュ
ヒットは含まれません。プロセスが 0 個（または想定よりも少ない数）の場合は、bazel clean の後にビルド/テストコマンドを実行します。
キャッシュ ヒットのトラブルシューティング
想定どおりのキャッシュ ヒット率が得られない場合は、次の操作を行います。
同じビルド/テストコマンドを再実行するとキャッシュ ヒットが発生することを確認する
キャッシュにデータを入力するビルドまたはテストを実行します。特定のスタックで新しいビルドを初めて実行する場合は、リモート キャッシュ ヒットは発生しません。リモート実行の一環として、アクションの結果はキャッシュに保存され、後続の実行で取得されます。
bazel cleanを実行します。このコマンドを実行すると、ローカル キャッシュが消去されます。これにより、ローカル キャッシュ ヒットによって結果がマスクされることなく、リモート キャッシュ ヒットを調査できます。調査しているビルドとテストを同じマシンで再度実行します。
INFO行でキャッシュ ヒット率を確認します。remote cache hitとinternal以外のプロセスが表示されない場合は、キャッシュが正しく入力され、アクセスされています。その場合は、次のセクションに進みます。不一致の原因として考えられるのは、ビルド内の非ハーメチックな要素により、2 回の実行でアクションが異なるアクションキーを受け取ることです。このようなアクションを見つけるには、次の操作を行います。
a. 問題のビルドまたはテストを再実行して、実行ログを取得します。
bazel cleanbazel --optional-flags build //your:target --execution_log_binary_file=/tmp/exec1.logb. 2 回の実行の実行ログを比較します。2 つのログファイルでアクションが同一であることを確認します。 不一致は、 実行間で発生した変更の手がかりとなります。ビルドを更新して、これらの不一致を解消します。
キャッシュの問題を解決でき、繰り返し実行するとすべてのキャッシュ ヒットが発生する場合は、次のセクションに進みます。
アクション ID が同一でもキャッシュ ヒットがない場合は、構成内の何らかの要素がキャッシュを妨げています。このセクションに進んで、一般的な問題を確認してください。
実行ログの差分を比較する必要がない場合は、人間が読める
--execution_log_json_fileフラグを使用できます。実行時間が含まれており、順序が保証されないため、安定した比較には使用できません。実行ログ内のすべてのアクションで
cacheableが true に設定されていることを確認します。特定のアクションの実行ログにcacheableが表示されない場合は、対応するルールにBUILDファイルの定義でno-cacheタグが含まれている可能性があります。実行ログの人間が読めるprogress_messageフィールドを確認して、アクションの発生元を特定します。アクションが同一で
cacheableでもキャッシュ ヒットがない場合は、コマンドラインに--noremote_accept_cachedが含まれている可能性があります。この場合、ビルドのキャッシュ検索が無効になります。実際のコマンドラインを特定するのが難しい場合は、Build Event Protocol の正規のコマンドラインを次のように使用します。
a. ログのテキスト バージョンを取得するには、
--build_event_text_file=/tmp/bep.txtを Bazel コマンドに追加します。b. ログのテキスト バージョンを開き、
structured_command_lineメッセージを検索します。command_line_label: "canonical". 展開後のすべてのオプションが一覧表示されます。c.
remote_accept_cachedを検索し、falseに設定されているかどうかを確認します。d.
remote_accept_cachedがfalseの場合は、コマンドラインまたは bazelrc ファイルのどちらでfalseに設定されているかを確認します。
マシン間でのキャッシュを確認する
同じマシンで想定どおりにキャッシュ ヒットが発生したら、別のマシンで同じビルドまたはテストを実行します。マシン間でキャッシュが発生していないと思われる場合は、次の操作を行います。
既存のキャッシュにヒットしないように、ビルドに小さな変更を加えます。
最初のマシンでビルドを実行します。
bazel cleanbazel ... build ... --execution_log_binary_file=/tmp/exec1.log2 台目のマシンでビルドを実行し、ステップ 1 の変更が含まれていることを確認します。
bazel cleanbazel ... build ... --execution_log_binary_file=/tmp/exec2.log2 回の実行の実行ログを比較します 。ログが同一でない場合は、ビルド構成の不一致と、ホスト環境のプロパティがどちらかのビルドに漏洩しているかどうかを調べます。
実行ログを比較する
実行ログには、ビルド中に実行されたすべてのアクションのレコードが含まれています。各アクションには、アクションキーのすべての情報を含む SpawnExec 要素があります。したがって、 ログが同一であれば、アクション キャッシュキーも同一です。
想定どおりにキャッシュ ヒットを共有していない 2 つのビルドのログを比較するには、次の操作を行います。
各ビルドから実行ログを取得し、
/tmp/exec1.logと/tmp/exec2.logとして保存します。次のコマンドを使用して Bazel ソースコードをダウンロードし、Bazel フォルダに移動します。execlog パーサーで 実行ログを解析するには ソースコードが必要です。
git clone https://github.com/bazelbuild/bazel.git cd bazel実行ログ パーサーを使用して、ログをテキストに変換します。次の呼び出しでは、比較を容易にするために、2 番目のログのアクションを最初のログのアクションの順序に合わせて並べ替えます。
bazel build src/tools/execlog:parser bazel-bin/src/tools/execlog/parser \ --log_path=/tmp/exec1.log \ --log_path=/tmp/exec2.log \ --output_path=/tmp/exec1.log.txt \ --output_path=/tmp/exec2.log.txt任意のテキスト差分ツールを使用して、
/tmp/exec1.log.txtと/tmp/exec2.log.txtの差分を確認します。