New to KubeDB? Please start here.
Monitoring HanaDB with Prometheus Operator
This guide deploys a HanaDB with the prometheus.io/operator agent so the
Prometheus Operator discovers it through a
ServiceMonitor.
Note: The YAML files used in this tutorial are stored in docs/examples/hanadb/monitoring folder in the GitHub repository kubedb/docs.
Before You Begin
- Install the KubeDB Provisioner and Ops-manager operators following the steps here.
- Install the Prometheus Operator and
note the label its
Prometheususes to selectServiceMonitors (oftenrelease: prometheus):
$ kubectl get prometheus -n monitoring -o jsonpath='{.items[0].spec.serviceMonitorSelector}'; echo
{}
An empty
serviceMonitorSelector({}) means this Prometheus selects allServiceMonitors in the namespaces it watches. If your Prometheus uses a non-empty selector, setspec.monitor.prometheus.serviceMonitor.labelsto match it (therelease: prometheuslabel below is a common convention for the kube-prometheus-stack chart).
Deploy a HanaDB with Prometheus Operator Monitoring
apiVersion: kubedb.com/v1alpha2
kind: HanaDB
metadata:
name: hanadb-prometheus-operator
namespace: demo
spec:
version: "2.0.82"
replicas: 1
storageType: Durable
storage:
storageClassName: local-path
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 64Gi
deletionPolicy: WipeOut
monitor:
agent: prometheus.io/operator
prometheus:
exporter:
port: 9668
serviceMonitor:
labels:
release: prometheus
interval: 10s
$ kubectl apply -f https://github.com/kubedb/docs/raw/v2026.6.19/docs/examples/hanadb/monitoring/prometheus-operator.yaml
hanadb.kubedb.com/hanadb-prometheus-operator created
Wait until the database is Ready.
Verify the ServiceMonitor
KubeDB creates a ServiceMonitor carrying the release: prometheus label so the operator’s Prometheus
selects it:
$ kubectl get servicemonitor -n demo -l app.kubernetes.io/instance=hanadb-prometheus-operator
NAME AGE
hanadb-prometheus-operator-stats 17m
$ kubectl get servicemonitor -n demo hanadb-prometheus-operator-stats \
-o jsonpath='port={.spec.endpoints[0].port} interval={.spec.endpoints[0].interval}{"\n"}selector={.spec.selector.matchLabels}{"\n"}'
port=metrics interval=10s
selector={"app.kubernetes.io/instance":"hanadb-prometheus-operator","app.kubernetes.io/managed-by":"kubedb.com","app.kubernetes.io/name":"hanadbs.kubedb.com","kubedb.com/role":"stats"}
Once Prometheus reloads, the HanaDB target appears in its Status → Targets page.
Cleaning Up
$ kubectl delete hanadb.kubedb.com -n demo hanadb-prometheus-operator
$ kubectl delete ns demo
Next Steps
- Monitor with builtin Prometheus.
- Review the HanaDB CRD.