KubeBolt / docs
GitHub

Insights Engine

24 built-in rules that detect common Kubernetes issues and provide actionable recommendations.

Rule Definitions

8 Critical 14 Warning 2 Info
💥 crash-loop critical

Pod in CrashLoopBackOff with restarts >3/hour

🔥 oom-killed critical

Container terminated with OOMKilled (exit 137)

zero-replicas critical

Deployment with 0 available replicas

🖥 node-not-ready critical

Node condition Ready ≠ True

📦 image-pull-backoff critical

Pod in ImagePullBackOff state

progress-deadline-exceeded critical

Rollout stalled past progressDeadlineSeconds

🔗 missing-config-dependency critical

Container can't start: referenced ConfigMap/Secret not found

helm-release-failed critical

Helm release left in a failed state after install/upgrade

cpu-throttle-risk warning

CPU usage >80% of limit sustained

📊 memory-pressure warning

Memory usage >85% of limit

📈 hpa-maxed-out warning

HPA current replicas == max replicas

💾 pvc-pending warning

PVC in Pending state for >5 minutes

🔁 frequent-restarts warning

Pod with >5 restarts in 24 hours (non crash-loop)

🚪 evicted-pods warning

Pods evicted from node due to pressure

🚦 readiness-probe-failing warning

Pod Running but not Ready for >2 minutes

🩺 liveness-probe-failing warning

Liveness probe failing repeatedly before restarts pile up

🔌 service-no-endpoints warning

Service has zero ready endpoints

🛡 policy-no-match warning

NetworkPolicy podSelector matches no pods

🚧 pdb-no-match warning

PodDisruptionBudget selector matches no pods

helm-release-hook-pending warning

Helm release stuck pending >5 min (hook never completed)

📜 cert-expiring warning

cert-manager Certificate expired or within 14 days of expiry

🔄 argocd-out-of-sync warning

ArgoCD Application OutOfSync or Degraded

📉 resource-underrequest info

Requests <40% of actual usage

🕳 policy-orphan info

Namespace has running pods but no NetworkPolicy

Each insight includes the affected resource, a human-readable message, and a specific suggestion with remediation steps or kubectl commands.