Skip to content

Latest commit

 

History

History
236 lines (154 loc) · 5.22 KB

bolt.md

File metadata and controls

236 lines (154 loc) · 5.22 KB
Raw

Create a new proxy

Core 1

HTTP API:

curl -X POST localhost:6666/proxies -H "Content-Type: application/json" -d '{ "name": "bolt_core_1", "listen": "[::]:7687", "upstream": "core1:17687", "enabled": true}'

CLI:

toxiproxy-cli -h localhost:6666 create --listen '[::]:7687' --upstream core1:17687 bolt_core_1

Core 2

HTTP API:

curl -X POST localhost:6666/proxies -H "Content-Type: application/json" -d '{ "name": "bolt_core_2", "listen": "[::]:8687", "upstream": "core2:27687", "enabled": true}'

CLI:

toxiproxy-cli -h localhost:6666 create --listen '[::]:8687' --upstream core2:27687 bolt_core_2

Core 3

HTTP API:

curl -X POST localhost:6666/proxies -H "Content-Type: application/json" -d '{ "name": "bolt_core_3", "listen": "[::]:9687", "upstream": "core3:37687", "enabled": true}'

CLI:

toxiproxy-cli -h localhost:6666 create --listen '[::]:9687' --upstream core3:37687 bolt_core_3

Create or replace a list of proxies

Core X

HTTP API:

curl -X POST localhost:6666/populate \
    -H "Content-Type: application/json" \
    -d '[
        { "name": "bolt_core_1", "listen": "[::]:7687", "upstream": "core1:17687", "enabled": true},
        { "name": "bolt_core_2", "listen": "[::]:8687", "upstream": "core2:27687", "enabled": true},
        { "name": "bolt_core_3", "listen": "[::]:9687", "upstream": "core3:37687", "enabled": true}
        ]'

Update a proxy's fields

Core 1

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_1 -H "Content-Type: application/json" -d '{"listen": "[::]:7687", "upstream": "core1:17687", "enabled": false}'

Core2

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_2 -H "Content-Type: application/json" -d '{"listen": "[::]:8687", "upstream": "core2:27687", "enabled": false}'

Core3

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_3 -H "Content-Type: application/json" -d '{"listen": "[::]:9687", "upstream": "core2:37687", "enabled": false}'

Delete an existing proxy

HTTP API:

curl -X DELETE localhost:6666/proxies/bolt_core_X -H "Content-Type: application/json"

CLI:

toxiproxy-cli -h localhost:6666 delete bolt_core_X

Create a new toxic

Latency

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "latency", "attributes":{"latency":30000,"jitter":1000}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t latency -a latency=30000 -a jitter=1000 --upstream raft_core_X

Bandwidth

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "bandwidth", "attributes":{"rate":10}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t bandwidth -a rate=50000 --upstream bolt_core_X

Slow close

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "slow_close", "attributes":{"delay":20000}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t slow_close -a delay=20000 --upstream bolt_core_X

Timeout

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "timeout", "attributes":{"timeout":10000}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t timeout -a timeout=10000 --upstream bolt_core_X

Reset peer

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "reset_peer", "attributes":{"timeout":1000}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t reset_peer -a timeout=10000 --upstream bolt_core_X

Slicer

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "slicer", "attributes":{"average_size":100, "size_variation":10,"delay":100}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t slicer -a average_size=100 -a size_variation=10 -a delay=100 --upstream bolt_core_X

Limit data

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics -H "Content-Type: application/json" -d '{ "type": "limit_data", "attributes":{"bytes":100}, "stream":"upstream"}'

CLI:

toxiproxy-cli -h localhost:6666 toxic add -t limit_data -a average_size=100 -a bytes=100 --upstream bolt_core_X

Update an active toxic (except stream)

Latency

HTTP API:

curl -X POST localhost:6666/proxies/bolt_core_X/toxics/latency_upstream -H "Content-Type: application/json" -d '{ "type": "latency", "attributes":{"latency":20000,"jitter":800}}'

CLI:

toxiproxy-cli -h localhost:6666 toxic update -n latency_upstream  -a latency=50000 bolt_core_X

Remove an active toxic

CoreX

HTTP API:

curl -X DELETE localhost:6666/proxies/bolt_core_X/toxics/latency_upstream

CLI:

toxiproxy-cli -h localhost:6666 toxic delete -n latency_upstream bolt_core_X

Enable all proxies and remove all active toxics

HTTP API:

curl -X POST localhost:6666/reset