c/STRESS_TEST_README.md

Local Register Stress Test (3 minutes)

This setup only targets localhost (127.0.0.1), for your own backend verification.

1. Install dependency

python -m pip install -U locust

2. Default target and route

Current script defaults:

• host: http://127.0.0.1
• register route: /api/user/register

If your local backend uses different host/port:

$env:TARGET_HOST="http://127.0.0.1:8080"

If route differs:

$env:REGISTER_PATH="/api/user/register"

3. Run large-scale register test (3 minutes)

locust -f locustfile.py --headless --users 300 --spawn-rate 60 --run-time 3m --csv register_stress_report

######################### python -m locust -f locustfile.py --headless --users 300 --spawn-rate 60 --run-time 3m --csv register_stress_report

Notes:

• --users 300: concurrent virtual users.
• --spawn-rate 60: user ramp-up per second.
• --run-time 3m: test duration.

4. Payload fields (adjust only when needed)

By default each request sends unique username + password:

{
  "username": "load_user_...",
  "password": "123456",
  "confirmPassword": "123456"
}

If your API field names are different, set env vars:

$env:USERNAME_FIELD="userName"
$env:PASSWORD_FIELD="passwd"
$env:CONFIRM_PASSWORD_FIELD="confirmPwd"

Optional extra fields:

$env:INCLUDE_EMAIL="1"
$env:INCLUDE_NICKNAME="1"

5. Result files and metrics

After run:

• register_stress_report_stats.csv
• register_stress_report_failures.csv
• register_stress_report_exceptions.csv

Focus on:

• requests/s
• p95 and p99 latency
• failure ratio