How clustercockpit/cc-backend works
ClusterCockpit is an HPC job-performance monitoring web backend with REST and GraphQL APIs, a Svelte interface, job archives, and live metric integrations. The main user path is browser request → HTTP routing/API → job or metric query → database/metric backend → rendered dashboard or analysis view. Separate product branches cover batch-system event ingestion, authentication, fleet services, job archiving, and background retention. Relationships are limited to those shown in the excerpts, SOURCE INDEX references, or README; unsampled wiring is omitted.
Main entry points: routes.go Web routes · resolver.go GraphQL API · jobQuery.go Job query layer · server.go HTTP server
Components 23
Web experience
- Svelte interface
web/frontend/src - Job filters
web/frontend/src/generic/Filters.svelte - Metric plots
web/frontend/src/generic/plots - Live dashboards
web/frontend/src/DashPublic.root.svelte
API and identity
- HTTP server
cmd/cc-backend/server.go - Web routes
internal/routerConfig/routes.go - Authentication
internal/auth/auth.go - REST API
internal/api/rest.go - Job API
internal/api/job.go - GraphQL API
internal/graph/resolver.go
Job and metric data
- Job query layer
internal/repository/jobQuery.go - SQLite database
internal/repository/dbConnection.go - Metric dispatch
internal/metricdispatch/dataLoader.go - Built-in metric store
pkg/metricstore/query.go - External metric stores
internal/metricstoreclient/cc-metric-store.go - Job archive
pkg/archive/archive.go
Cluster integrations
- NATS event API
internal/api/nats.go - Fleet services
internal/fleet/services.go
Archiving and operations
- Archive worker
internal/archiver/archiveWorker.go - Background tasks
internal/taskmanager/taskManager.go - Parquet archive
pkg/archive/parquet/writer.go
Other components
- Browser user
- HPC batch system
Connections 26
- Browser user → HTTP server: sends requests
- HTTP server → Web routes: routes requests
cmd/cc-backend/server.go - HTTP server → Authentication: checks identity
cmd/cc-backend/server.go - Web routes → Job API: routes jobs
internal/routerConfig/routes.go - Web routes → GraphQL API: routes GraphQL
internal/routerConfig/routes.go - Web routes → REST API: mounts REST
- Web routes → Svelte interface: serves interface
internal/routerConfig/routes.go - Svelte interface → GraphQL API: queries data
web/frontend/src/DashPublic.root.svelte - Job filters → Svelte interface: filters views
web/frontend/src/generic/Filters.svelte - Live dashboards → GraphQL API: queries status
web/frontend/src/DashPublic.root.svelte - Live dashboards → Metric plots: renders metrics
web/frontend/src/DashPublic.root.svelte - Job API → Job query layer: queries jobs
internal/api/job.go - Job query layer → SQLite database: reads records
internal/repository/jobQuery.go - GraphQL API → Job query layer: queries jobs
- GraphQL API → Metric dispatch: loads metrics
- Metric dispatch → Built-in metric store: queries metrics
- Metric dispatch → External metric stores: queries external
- External metric stores → Job archive: uses archive data
internal/metricstoreclient/cc-metric-store.go - HPC batch system → NATS event API: publishes events
- HPC batch system → REST API: sends updates
- NATS event API → Job query layer: updates job state
- Fleet services → SQLite database: registers services
internal/fleet/services.go - Archive worker → Job archive: archives completed jobs
internal/archiver/archiveWorker.go - Archive worker → Job query layer: updates archive status
internal/archiver/archiveWorker.go - Background tasks → Parquet archive: runs retention
- Background tasks → Job archive: manages retention