Chaos Studio

Design visual chaos workflows with serial and parallel execution

Chaos Studio Run

A visual drag-and-drop editor for designing complex chaos workflows. Build graphs of scenarios that execute in series or parallel, and measure application resilience with the Resiliency Score.


Creating and Saving Workflows

Creating a New Workflow

  1. Navigate to Chaos Studio from the main navigation
  2. Click the “New Workflow” button to start a blank canvas
  3. Give your workflow a meaningful name that describes its purpose

Adding Nodes

  1. Click the “Add Node” button or drag from the node palette
  2. Position nodes on the canvas by dragging them
  3. Configure each node by clicking on it and selecting:
    • Registry: Choose your scenario source
    • Scenario: Select the chaos scenario to run
    • Parameters: Set mandatory and optional parameters
    • Files: Mount any required configuration files

Connecting Nodes

  • Click and drag from a node’s output port to another node’s input port to create dependencies
  • Serial execution: connect nodes in a chain (A → B → C)
  • Parallel execution: connect one node to multiple targets (A → B and A → C)

Saving Your Workflow

  1. Click the “Save” button in the top toolbar
  2. The workflow is automatically saved to your workspace
  3. Saved workflows appear in the Chaos Studio workflow list
  4. You can edit saved workflows by selecting them from the list

Video Walkthrough


Visual Editor

  • Nodes represent individual krkn scenarios
  • Arrows define execution order — connect nodes to create dependencies
  • Serial execution: chain nodes sequentially with single arrows
  • Parallel execution: branch from one node to multiple targets
  • Drag and drop to arrange the workflow visually

Node Configuration

Each node is configured exactly like a single scenario: select a registry, choose a scenario, set mandatory/optional/global parameters, and mount files.

Global Parameters in Workflows

When configuring global parameters for workflow nodes:

  • Elasticsearch: Select from saved admin-configured endpoints to index metrics across the entire workflow
  • Prometheus: Configure Prometheus integration for metric collection
  • Cerberus: Enable cluster health monitoring during scenario execution

Clone: duplicate a configured node to repeat the same scenario multiple times within the workflow.


Validation

The editor validates the workflow before execution:

  • Configured nodes: green arrows and connections — ready to execute
  • Unconfigured nodes: red arrows and red node border — must be configured before the workflow can run

Only fully configured nodes can be connected and executed.


Resiliency Score

Enable the Resiliency Score on a workflow to measure application resilience:

  1. Enable the resiliency score option on the workflow
  2. Mount a PromQL file — a special file containing PromQL queries uploaded via File Management
  3. Queries execute during the workflow and their results contribute to the final score
  4. View the score in the Jobs page alongside the graph run results

The PromQL file defines which metrics to evaluate (latency, error rate, throughput, etc.) and their expected thresholds. The score reflects how closely the application maintained its expected behavior under chaos.

Last modified August 21, 2026: adding elasticsearch details (#601) (b183880)