Service: Chaos Maker - EyevinnOSC/community GitHub Wiki

Chaos Maker

Chaos Maker (serviceId ablindberg-chaosmaker) is a visual configuration interface for Chaos Stream Proxy, an open source tool that injects network impairments into HLS and MPEG-DASH streams. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. Source: ABLindberg/ChaosMaker.

What it can do

  • Build and manage chaos configurations in a web UI instead of writing raw configuration by hand.
  • Define impairment rules such as latency, packet loss and segment corruption.
  • Generate configuration objects compatible with Chaos Stream Proxy and apply them to a proxy URL.

Creating an instance

Optionally create a Chaos Stream Proxy instance first, to apply configurations to. Then call create-service-instance with serviceId: "ablindberg-chaosmaker":

{ "name": "myconfig" }

Verify with wait-for-service-ready or get-instance-status, then describe-service-instance for the URL of the web UI.

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric/underscore only (^\w+$), at most 20 characters.

Using the instance

  1. Start a Chaos Stream Proxy instance with your origin URL.
  2. Open the Chaos Maker web UI and define impairment rules.
  3. Apply the generated configuration to your proxy to start injecting faults.
  4. Point your video player at the proxy URL and observe behavior under degraded network conditions.

OSC CLI equivalent of creating the instance:

osc create ablindberg-chaosmaker myconfig

Resources