Phoenix LiveView application that collects and displays metrics for all 5 VSM subsystems. Exports Prometheus metrics and provides a web dashboard.
- Version: 0.1.0
- Phoenix application with LiveView dashboard
- Prometheus export via prometheus_ex and prometheus_plugs
- 2 test files; coverage unknown
- Depends on vsm_core via path dependency when standalone
Runs 5 supervisor trees (one per VSM subsystem), each containing monitoring GenServers that collect metrics. Exposes those metrics via Prometheus at /metrics and renders them in a LiveView dashboard at /.
| VSM System | Monitors | Metrics |
|---|---|---|
| System 1 (Operations) | OperationalMonitor, PerformanceTracker, ResourceMonitor | Response time, throughput, resource utilization |
| System 2 (Coordination) | ChannelMonitor, CoordinationMonitor, VarietyManager | Coordination efficiency, channel capacity, variety handling |
| System 3 (Control) | ControlMonitor, AuditManager, OptimizationEngine | Control effectiveness, audit compliance, optimization |
| System 4 (Intelligence) | EnvironmentScanner, FutureProjector, ThreatAnalyzer | Environmental awareness, future readiness |
| System 5 (Policy) | IdentityManager, PolicyMonitor, StrategicPlanner | Policy coherence, identity, strategic alignment |
Additional components:
| Module | Purpose |
|---|---|
Metrics |
Registers Prometheus histograms, counters, and summaries |
MetricsCollector |
Central aggregation point |
PrometheusExporter |
Formats metrics for Prometheus scraping |
AlgedonicChannel |
Urgent bypass signal channel |
VarietyCalculator |
Computes variety metrics |
DashboardLive |
Main LiveView dashboard |
SystemLive |
Per-system detail view |
| Path | Description |
|---|---|
/ |
LiveView dashboard |
/metrics |
Prometheus metrics endpoint |
/dev/dashboard |
Phoenix LiveDashboard (dev only) |
vsm_response_time- histogram with system/operation labelsvsm_processing_time- histogram with system/task_type labelsvsm_operations_total- counter with system/operation/status labelsvsm_errors_total- counter with system/error_type labelsvsm_messages_total- counter with from_system/to_system/message_type labelsvsm_variety_absorbed- summary per systemvsm_coordination_lag- summary between systems
mix deps.get
cd assets && npm install && cd ..
mix phx.server
# Visit http://localhost:4000config/config.exs- general settingsconfig/dev.exs- development (port, live reload)config/prod.exs- production (requires SECRET_KEY_BASE, PHX_HOST, PORT env vars)
- Monitor GenServers exist but it is unclear whether they emit real metrics or placeholder values
- No database; metrics are in-memory only
- VarietyCalculator has tests but the 15 monitor modules do not
- Path dependency on vsm_core prevents standalone Hex installation
- No Grafana dashboards or alerting rules included
MIT