Get applied impairment

gethttp://localhost/v1/impairments/{direction}

Served over the Unix socket /run/chaosd/chaosd.sock

Returns the current AppliedState for a direction: the impairment decoded from the qdisc stack the kernel holds right now.

Path parameters

directionstringRequired

The direction to operate on. Each direction is configured independently. An unknown value returns 400.

Allowedport1port2

Response

200 · application/json

Current applied state. Returns an AppliedState object.

directionstringRequired

Allowedport1port2

impairmentImpairmentRequired

The complete shaping state of one direction. Omitted fields are not applied.

divergencelist of DivergenceOptional

Differences between requested and applied state. Omitted when empty.

captured_atinteger <int64>Required

Monotonic timestamp in nanoseconds. The ordering source of truth.

captured_at_wallinteger <int64>Required

Wall-clock time in nanoseconds since the Unix epoch, for human correlation only.

Errors

400

Problem

Unknown direction or malformed body.

500

Problem

Backend or I/O error.

getGet system info

putApply impairment

get/v1/impairments/{direction}

curl --unix-socket /run/chaosd/chaosd.sock -X GET http://localhost/v1/impairments/port1

Response

{
  "direction": "port1",
  "impairment": {
    "latency": {
      "kind": "constant",
      "duration": 40000000
    }
  },
  "captured_at": 123456789,
  "captured_at_wall": 1700000000000000000
}