// Triage detached GCP benchmark runs, DONE/FAILED sentinels, VM cleanup, vm.log, gcp_last_run.json, and partial result downloads. Use when GCP benchmark logs mention DONE, FAILED, exit_code.txt, VM disappeared, STOPPING, gcloud machine type errors, or missing artifacts.
| name | gcp-benchmark-triage |
| description | Triage detached GCP benchmark runs, DONE/FAILED sentinels, VM cleanup, vm.log, gcp_last_run.json, and partial result downloads. Use when GCP benchmark logs mention DONE, FAILED, exit_code.txt, VM disappeared, STOPPING, gcloud machine type errors, or missing artifacts. |
Detached runs upload artifacts under the run prefix recorded in gcp_last_run.json.
DONE: benchmark succeeded; fetch results/, then wait for VM cleanup/cache upload.FAILED: benchmark failed; fetch vm.log, FAILED, exit_code.txt, and any partial results/.exit_code.txt without DONE: use the exit code and vm.log as source of truth.STOPPING after DONE: usually cache upload/self-delete; wait before relaunching quota-heavy jobs.Read local metadata:
python - <<'PY' path/to/gcp_last_run.json
import json, sys
print(json.dumps(json.load(open(sys.argv[1])), indent=2))
PY
Fetch artifacts:
gcloud storage rsync --recursive "$RUN_PREFIX/results/" "$LOCAL_OUT/"
gcloud storage cat "$RUN_PREFIX/vm.log"
gcloud storage cat "$RUN_PREFIX/exit_code.txt"
Check machine availability before launching:
gcloud compute machine-types list \
--project albumentations \
--zones us-central1-b \
--filter='name=(c4-standard-16 c4d-standard-16 g2-standard-16)'
Check GPU quota:
python - <<'PY'
import json
import subprocess
raw = subprocess.check_output(
["gcloud", "compute", "project-info", "describe", "--project", "albumentations", "--format=json"],
text=True,
)
for quota in json.loads(raw).get("quotas", []):
metric = quota.get("metric", "")
if "CPU" in metric or "GPU" in metric or "NVIDIA" in metric:
print(f"{metric}: limit={quota.get('limit')} usage={quota.get('usage')}")
PY
c3-standard-16 does not exist; use c3d-standard-16 or c3-standard-22.--maintenance-policy TERMINATE. They also need a CUDA-capable image; do not
treat g2-standard-16 as a CPU VM just because --gcp-gpu-type is omitted.Quota 'GPUS_ALL_REGIONS' exceeded. Limit: 0.0 globally. means the project has zero GPU quota anywhere. Changing zone
will not help; request global GPU quota and regional L4/G2 quota before retrying.STOPPING instances, or a second launch while a blipped client thinks the VM is gone consume the remaining vCPUs.
A g2-standard-16 GPU VM also consumes 16 vCPUs.No image files found in dataset tarball for a video scenario usually means the detached job.json has the wrong typed
run_config.selection.scenario or media-derived staging fields. Detached runs should not carry flag argv payloads.ModuleNotFoundError from benchmark/cloud/stage_dataset.py before Installing uv... means bootstrap staging imported
a dependency too early. That script must stay stdlib-only because it runs before the control venv and library venvs are
created.Shear failures with mixed CPU/CUDA tensors are a known Kornia CUDA limitation. Current benchmark
jobs filter Shear only for Kornia image GPU micro/DataLoader rows; rerun with the patched code instead of removing
Shear from the global paper transform sets.*_results.json.Validates whether benchmark artifacts cover the paper's required RGB micro and RGB DataLoader sections. Use when checking missing RGB runs, deciding what to run next, validating gcp_runs/output folders, or preparing paper tables.
Automates running image/video augmentation benchmarks for single or multiple libraries, validates outputs, generates comparison reports, and updates documentation. Use when running benchmarks, comparing library performance, or when the user mentions benchmark, benchmark.cli, pyperf, GCP benchmark runs, or performance testing.
Updates benchmark documentation with latest results including README tables, speedup plots, and library metadata. Use when updating documentation, generating comparison tables, or when the user mentions update_docs.sh or documentation generation.
Guides adding support for new image/video augmentation libraries to the benchmark suite. Use when integrating a new library, adding library support, or when the user mentions adding a new augmentation library to test.
Executes the paper benchmark plan for RGB, multichannel, DataLoader, and video benchmarks. Use when the user mentions the paper benchmark, deadline plan, machine matrix, RGB micro, multichannel, DataLoader, video GPU, c4/c4d/g2 machines, or what to run next.
Analyzes benchmark results to identify slow transforms, warmup issues, and performance regressions. Compares speedups across libraries and generates optimization recommendations. Use when analyzing performance, investigating slow benchmarks, or comparing library results.