tests/load/reports/README.md

Load Test Reports Directory

This directory stores load test results and baseline files for performance regression detection.

Directory Structure

• baseline.json - Reference performance metrics for regression detection
• load_test_*.json - Historical Locust JSON results
• load_test_*.html - Historical HTML reports
• load_test_*.log - Historical test logs

Updating Baseline

Important: Only update baseline.json on the main branch after verifying that performance improvements are legitimate.

To update the baseline:

# Run load tests
./backend/tests/scripts/run_load_tests.sh -u 200 -r 20 -t 10m

# Copy results to baseline
cp backend/tests/load/reports/load_test_<TIMESTAMP>.json backend/tests/load/reports/baseline.json

# Commit changes
git add backend/tests/load/reports/baseline.json
git commit -m "perf: update load test baseline to <TIMESTAMP>"

Performance Regression Detection

Compare new results against baseline:

./backend/tests/scripts/compare_performance.py \
  backend/tests/load/reports/baseline.json \
  backend/tests/load/reports/load_test_<TIMESTAMP>.json

Exit code 1 indicates regression detected.

Git Configuration

The .gitignore in this directory ignores all reports except baseline.json to keep repository size manageable.