Skip to main content
RELAMPO
Documentation
ENES

run

relampo run validates and executes Relampo YAML scenarios.

Purpose​

Use run when you need to:

  • execute a functional or performance scenario
  • override VUs/duration for quick test runs
  • export results to JSON and/or HTML
  • run with embedded resource flags

Most Used Flags​

relampo run test.yaml
relampo run test.yaml -o results.json
relampo run test.yaml --html results.html
relampo run test.yaml -o results.json --html results.html
relampo run test.yaml --vus 5 --duration 10s
relampo run test.yaml --retrieve-embedded-execution --embedded-resource-types-execution css,js,img --embedded-resource-blacklist-execution tracker,analytics

How run Works​

  1. Validates YAML before execution.
  2. Applies execution limits and overrides.
  3. Executes the scenario with console reporting.
  4. Writes report files only if -o and/or --html are provided.

Expected Output​

  • YAML validation output in terminal.
  • Scenario execution without crash for valid inputs.
  • Console summary of results.
  • Report artifacts when requested (-o, --html).

Overrides and Limits​

  • --vus: overrides scenario concurrency.
  • --duration: overrides scenario duration.
  • Safety limit for run VUs: max 500.
  • Max duration in run: 1h.

If limits are exceeded or duration format is invalid, run returns a controlled error with non-zero exit.

Embedded Resources​

  • --retrieve-embedded-execution: enables embedded resource retrieval at execution time.
  • --embedded-resource-types-execution: defines allowed types (example: css,js,img).
  • --embedded-resource-blacklist-execution: excludes URLs by substrings (example: analytics,tracker).

Note About --validate​

In the current run flow, validation is executed before the scenario starts.