CHAOS · v0.1.0

CHAOS

Adversarial test harness for distributed systems.

INTRODUCTION
CHAOS overview

CHAOS is a transparent in-line WAN-emulation appliance for measurement-grade test and evaluation of devices under test.

GET STARTED
Getting started

Configure chaosd, bind the data ports, start the daemon, and apply your first per-direction impairment with the chaos CLI.

CONCEPTS
Core concepts and architecture

The CHAOS domain model — directions, the impairment composite, the qdisc stack, applied-state read-back, and the daemon architecture.

CONCEPTS
The impairment surface

The full set of impairment kinds CHAOS applies per direction — latency, loss, rate, queue, duplication, reordering, corruption — and their wire shapes.

SUBSYSTEMS
Traffic control and the data plane

How chaosd programs and reads the egress qdisc stack through rtnetlink, the read-back contract, and live statistics.

API
The HTTP API

The chaosd HTTP/JSON control surface — system info, per-direction impairment read/apply/clear, live statistics, and the calibration baseline.

SUBSYSTEMS
The chaos CLI

The chaos operator CLI — one-shot subcommands, the interactive shell, and the live data-plane monitor.

SUBSYSTEMS
Calibration

How CHAOS measures impairment accuracy against tolerance bands, and the calibration baseline surfaced by the daemon.

OPERATIONS
Configuration and operations

chaosd configuration, filesystem layout, capabilities, logging, and lifecycle on the CHAOS appliance.

LIFECYCLE
Roadmap and lifecycle

What CHAOS ships today, the subsystems planned for later phases, and how to tell present behavior from roadmap intent.