How project-koku/koku-metrics-operator works
Koku Metrics Operator watches a CostManagementMetricsConfig resource, configures collection from cluster monitoring, gathers OpenShift usage, produces report files, packages them, and uploads them to Koku. It can also register the cluster as a Sources API source and manage persistent storage for its deployment. The controller is the principal workflow owner; sampled excerpts and the source index support its calls into collection, packaging, HTTP, Sources, and storage. Some internal details are unsampled, so uncertain links are omitted.
Main entry points: costmanagementmetricsconfig_controller.go Config reconciler · collector.go Usage reports · http_cloud_dot_redhat.go Koku upload client · prometheus.go Prometheus control
Components 18
Operator control
- Manager startup
cmd/main.go - Config reconciler
internal/controller/costmanagementmetricsconfig_controller.go - Metrics config
api/v1beta1/metricsconfig_types.go
Usage collection
- Prometheus control
internal/controller/prometheus.go - Usage reports
internal/collector/collector.go - Prometheus client
internal/collector/prometheus.go - Metric queries
internal/collector/queries.go - Report formatting
internal/collector/report.go
Report delivery
- Report directories
internal/dirconfig/dirconfig.go - Archive packaging
internal/packaging/packaging.go - Koku upload client
internal/crhchttp/http_cloud_dot_redhat.go - Source registration
internal/sources/handler.go - Upload authentication
internal/crhchttp/config.go
Cluster integration
- PVC management
internal/storage/storage.go - Cluster version
internal/clusterversion/cv.go
Other components
- Cluster admin
- Cluster Prometheus
- Koku service
Connections 20
- Cluster admin → Metrics config: configures
README.md - Manager startup → Config reconciler: starts
cmd/main.go - Config reconciler → Metrics config: reconciles
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → Prometheus control: coordinates
- Config reconciler → Usage reports: collects
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → Archive packaging: packages
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → Koku upload client: uploads
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → Source registration: registers source
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → PVC management: manages
internal/controller/costmanagementmetricsconfig_controller.go - Config reconciler → Cluster version: checks version
internal/controller/costmanagementmetricsconfig_controller.go - Prometheus control → Prometheus client: configures
- Prometheus client → Cluster Prometheus: queries
- Usage reports → Report directories: writes reports
internal/collector/collector.go - Usage reports → Metric queries: uses query definitions
- Usage reports → Report formatting: formats output
- Archive packaging → Report directories: reads files
internal/packaging/packaging.go - Koku upload client → Koku service: sends archive
README.md - Source registration → Koku upload client: uses HTTP client
internal/sources/handler.go - Koku upload client → Upload authentication: uses auth config
- Upload authentication → Koku service: requests token