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
- Start a Chaos Stream Proxy instance with your origin URL.
- Open the Chaos Maker web UI and define impairment rules.
- Apply the generated configuration to your proxy to start injecting faults.
- 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
- Chaos Stream Proxy, the proxy that applies the configurations
- Chaos Stream Proxy Configurator, an alternative configuration tool