Skip to main content
RELAMPO
Documentation
ENES

debug

relampo debug runs a YAML scenario in diagnostic mode with live trace output to identify functional and configuration issues.

Purpose​

Use debug when you need to:

  • inspect a failing flow step by step
  • quickly validate changes before run
  • diagnose variable, correlation, or step-sequencing issues

Most Used Flags​

relampo debug test.yaml
relampo debug test.yaml --validate
relampo debug test.yaml --vus 2
relampo debug test.yaml --duration 30s
relampo debug test.yaml --vus 2 --duration 30s --validate

How debug Works​

  1. Run relampo debug <file>.
  2. Optionally enable --validate to validate YAML before debugging.
  3. Relampo executes the scenario with live reporter output and detailed trace.
  4. If issues appear, adjust the YAML and run again.

Expected Output​

  • Debug mode start message in terminal.
  • If --validate is used, validation success or validation errors are shown.
  • Live trace output during execution.
  • For invalid input (bad file, exceeded limits, malformed duration), controlled error with non-zero exit.

Debug Mode Limits​

  • --vus: max 2 for debug.
  • --duration: max 1h.

These limits are designed for fast diagnosis and to avoid heavy executions during debugging.

Common Errors​

  • Running without <file>.
  • Non-existent file path.
  • Invalid YAML when using --validate.
  • --vus greater than 2.
  • Invalid --duration format (for example: xyz).