Using DIXY
REST API
Run DIXY in web mode and query deadlocks, threads, locks and status over HTTP.
Start web mode
bash
java -Duser.timezone=UTC -Dspring.profiles.active=web \ -jar build/libs/virtual_deadlock_detection-0.0.1-SNAPSHOT.jarcurl http://localhost:8081/actuator/healthAPI key
Every endpoint except /actuator/health needs an X-API-Key header. The local default is dixy-local-dev-key-123; change it with -Dsecurity.api-key=YOUR_KEY.
The default key and database password are for local development only.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/deadlocks | List detected deadlock reports |
| GET | /api/deadlocks/{id} | Get one report |
| POST | /api/graph/detect | Run detection on the current graph |
| GET | /api/threads | List threads |
| GET | /api/locks | List locks |
| GET | /api/v1/status | HEALTHY / WARNING / CRITICAL with metrics |
| DELETE | /api/v1/status/clear | Remove stored threads, locks and wait edges |
| POST | /api/telemetry | Send telemetry to DIXY |
| POST | /api/internal/deadlocks | Used by the agent to push cycles |
| GET | /actuator/prometheus | Prometheus metrics |