How drumilbhati/damascus works
DAMASCUS is a resilience and capacity-testing control platform with a web dashboard. Users can create and run experiments against a separately operated target mesh; the manager coordinates load generation and telemetry observation, then analyzes capacity and produces a report. The repository also contains dependency analysis, telemetry-source and observability components, and an autorun feature. The sampled manager code supports its orchestration links; the README identifies the separately operated target and observability services. Several API and feature implementations were not sampled, so their runtime connections are not inferred.
Main entry points: manager.go Experiment Manager · index.tsx App Router · watcher.go Telemetry Watcher · engine.go Load Generator
Components 23
Experiment Control
- REST API Routes
internal/api/routes.go - API Handlers
internal/api/handler.go - Experiment Manager
internal/experiment/manager.go - Load Generator
internal/stress/engine.go - Experiment Storage
internal/storage/postgres.go
Analysis and Safety
- Telemetry Watcher
internal/watcher/watcher.go - Safety Controller
internal/safety/controller.go - Capacity Analyzer
internal/capacity/analyzer.go - Dependency Analysis
internal/graph/analyser.go - Report Generator
internal/report/generator.go
Dashboard
- Dashboard Pages
web/src/pages/DashboardPage.tsx - Experiment Views
web/src/pages/ExperimentsPage.tsx - Autorun View
web/src/pages/AutoRunPage.tsx - Dependency View
web/src/pages/DependenciesPage.tsx - Dependency Graph
web/src/components/DependencyGraph.tsx - Report View
web/src/pages/ReportsPage.tsx - App Router
web/src/router/index.tsx - Web App
web/src/App.tsx - API Client
web/src/api/client.ts
External Systems
- Target Services
- Prometheus
- Jaeger
Other components
- Platform User
Connections 17
- Platform User → Dashboard Pages: uses
- Web App → App Router: renders routes
web/src/App.tsx - App Router → Dashboard Pages: routes to
web/src/router/index.tsx - App Router → Experiment Views: routes to
web/src/router/index.tsx - App Router → Autorun View: routes to
web/src/router/index.tsx - App Router → Dependency View: routes to
web/src/router/index.tsx - App Router → Report View: routes to
web/src/router/index.tsx - Dependency View → Dependency Graph: displays graph
- Experiment Manager → Dependency Analysis: builds graph
internal/experiment/manager.go - Experiment Manager → Load Generator: starts load
internal/experiment/manager.go - Experiment Manager → Telemetry Watcher: starts watcher
internal/experiment/manager.go - Experiment Manager → Capacity Analyzer: analyzes observations
internal/experiment/manager.go - Experiment Manager → Report Generator: generates report
internal/experiment/manager.go - Experiment Manager → Experiment Storage: reads and writes
internal/experiment/manager.go - Load Generator → Target Services: sends load
- Telemetry Watcher → Prometheus: queries metrics
- Telemetry Watcher → Jaeger: reads traces