A simple HTTP API for runtime debugging and management of Substreams tier2.
Get the current overloaded simulation state:
curl -s http://localhost:8081/debug/simulate_overloaded | jqExample response:
{
"overloaded": false
}Set the service to simulate being overloaded:
curl -s -X POST -H "Content-Type: application/json" -d '{"overloaded": true}' http://localhost:8081/debug/simulate_overloaded | jqAlternative using query parameter:
curl -s -X POST http://localhost:8081/debug/simulate_overloaded?value=true | jqExample response:
{
"overloaded": true
}Trigger an immediate garbage collection:
curl -s -X POST http://localhost:8081/debug/gc | jqExample response:
{
"before": "Alloc = 235 MiB, Heap inuse = 245 MiB",
"after": "Alloc = 198 MiB, Heap inuse = 210 MiB"
}List all currently active requests:
curl -s http://localhost:8081/debug/requests | jqExample response will show details of all active requests.
Cancel a specific request:
curl -s -X DELETE -H "Content-Type: application/json" -d '{
"trace_id": "abc123",
"output_module_hash": "def456"
}' http://localhost:8081/debug/requests | jqExample response:
{
"matches": ["request-1", "request-2"]
}For more specific cancellation, you can include optional parameters:
curl -s -X DELETE -H "Content-Type: application/json" -d '{
"trace_id": "abc123",
"output_module_hash": "def456",
"segment_number": 5,
"segment_size": 100,
"stage": 2
}' http://localhost:8081/debug/requests | jq