execution-instability-bench

English version: README.en.md

CPU/GPU 실행 과정에서 관측 가능한 구조적 변동과 추가 계산 비용을 재현하기 위한 실험 벤치입니다.

Argus는 별도의 관찰 도구이고, 이 저장소는 controlled workload, scenario config, metric schema, validation, summary utility를 제공합니다. 모든 실험 출력은 instability_metrics.json 스키마 결과 파일을 중심으로 다룹니다.

설치

python3 -m pip install -r requirements.txt

빠른 실행

CPU

python3 cpu/run_cpu.py --config cpu/configs/baseline.yaml
python3 cpu/run_cpu.py --config cpu/configs/locality_break.yaml
python3 cpu/run_cpu.py --config cpu/configs/rebuild_pressure.yaml

GPU

python3 gpu/run_gpu.py --config gpu/configs/baseline.yaml
python3 gpu/run_gpu.py --config gpu/configs/irregular_access.yaml
python3 gpu/run_gpu.py --config gpu/configs/rebuild_pressure.yaml

스키마 검증

python3 scripts/validate_schema.py results/sample
python3 scripts/validate_schema.py argus_results

결과 요약 CSV

python3 scripts/summarize_results.py results/sample --output results/sample/summary.csv
python3 scripts/summarize_results.py argus_results --output results/argus_cpu_execution_instability_summary.csv
# 또는
python3 scripts/export_table.py results/sample --output results/sample/summary.csv

출력 규칙

각 실행은 기본적으로 설정 파일의 output.dir 하위에 instability_metrics.json을 생성합니다.

스키마 상위 구조는 아래를 따릅니다.

• schema_version
• mode
• run_info
• system_info
• workload_info
• scenario_info
• measurement_window
• raw_metrics
• derived_metrics
• artifacts
• notes

폴더 역할

• cpu/: CPU synthetic workload와 scenario config
• gpu/: GPU-labeled synthetic workload와 scenario config
• common/: 공통 schema, metric derivation, JSON/YAML utility
• scripts/: schema validation과 CSV summary utility
• results/sample/: bench sample output
• argus_results/: 별도 관찰 도구인 Argus가 생성한 참조 결과 artifact

재현 절차와 Argus 결과 추적 방법은 REPRODUCIBILITY.md에 정리되어 있습니다.