Architecture at a glance
5 min
Kubegrade includes the following components

Kubegrade Control Plane
The central service/UI where users
- View cluster posture
- Run investigations
- Review plans and recommendations
- Approve remediations
- Manage policies, roles, and workflows
In-Cluster Agent(s)
Lightweight agents/controllers deployed in target clusters that
- Collect telemetry/metadata
- Execute approved workflows
- Respect cluster RBAC and network boundaries
- Support upgrade planning and operational actions
IaC / Git / GitOps Integrations
Kubegrade connects to
- IaC/config sources (Terraform, Helm, Kustomize)
- Git repositories
- GitOps systems (Argo CD / Flux) to generate auditable PRs and align runtime state with declared state.
Observability / Notification Integrations
Kubegrade can connect to monitoring, alerting, and collaboration systems to enrich context and route actions.