DumbMonit
EN
GitHub Install

IntegrationsVirtualization and containers

Monitor Kubernetes / k3s with DumbMonit

A cluster through its API: nodes not ready or under pressure, pods crash looping or stuck pending, workloads missing replicas, volume claims never bound.

DocumentationOfficial website: Kubernetes

Product descriptions are in English, as in the product. The page labels follow your language.

What DumbMonit watches

A cluster through its API server: nodes that are not Ready or under pressure, pods crash looping or stuck Pending, Deployments, StatefulSets and DaemonSets missing replicas, volume claims that never get bound, and the warning events of the last hour.

Typical use. Cluster: nodes not ready, pods crash looping or pending, workloads missing replicas, stuck volume claims

Examples

  • k3s
  • kubeadm cluster
  • k0s
  • MicroK8s
  • Talos

How it connects

What you need

  • Service account tokenThe token of the dumbmonit service account, read from its dumbmonit-token Secret.

Network ports to open

  • 6443/TCPAPI server (HTTPS, default)
Setup steps: Create a read-only service account for DumbMonit

  1. Create the service account.

    kubectl create serviceaccount dumbmonit -n kube-system

  2. Create a ClusterRole that can only get and list what DumbMonit reads.

    kubectl create clusterrole dumbmonit-read --verb=get,list --resource=nodes,pods,persistentvolumeclaims,events,deployments.apps,statefulsets.apps,daemonsets.apps

  3. Bind the role to the service account.

    kubectl create clusterrolebinding dumbmonit-read --clusterrole=dumbmonit-read --serviceaccount=kube-system:dumbmonit

  4. Create a token that does not expire, then print the token and the cluster CA in base64.

    echo '{"apiVersion":"v1","kind":"Secret","metadata":{"name":"dumbmonit-token","namespace":"kube-system","annotations":{"kubernetes.io/service-account.name":"dumbmonit"}},"type":"kubernetes.io/service-account-token"}' | kubectl apply -f -
kubectl -n kube-system get secret dumbmonit-token -o jsonpath='{.data.token}' | base64 -d
kubectl -n kube-system get secret dumbmonit-token -o jsonpath='{.data.ca\.crt}'

  5. In DumbMonit, enter the API server address (for example https://k3s.lan:6443), paste the token as Service account token and the CA as Cluster CA certificate.

Heads-up. On k3s, run each command as sudo k3s kubectl. The API server certificate only lists its own names and addresses: use one it lists, or tick Accept an unverifiable certificate.

Also in Virtualization and containers