https://github.com/sapcc/kubernetes-oomkill-exporter

Exporter parses kernel log for oomkilled pods
https://github.com/sapcc/kubernetes-oomkill-exporter

exporter kubernetes metrics oomkill prometheus prometheus-exporter prometheus-metrics

Last synced: 8 months ago
JSON representation

Exporter parses kernel log for oomkilled pods

• Host: GitHub
• URL: https://github.com/sapcc/kubernetes-oomkill-exporter
• Owner: sapcc
• License: apache-2.0
• Created: 2018-11-30T14:05:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-03-31T15:05:31.000Z (about 1 year ago)
• Last Synced: 2025-04-02T09:07:18.063Z (about 1 year ago)
• Topics: exporter, kubernetes, metrics, oomkill, prometheus, prometheus-exporter, prometheus-metrics
• Language: Makefile
• Homepage:
• Size: 10.3 MB
• Stars: 64
• Watchers: 49
• Forks: 13
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# kubernetes-oomkill-exporter

[![Contributions](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](https://github.com/sapcc/kubernetes-oomkill-exporter)

[![License](https://img.shields.io/badge/license-Apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)

----

`kubernetes-oomkill-exporter` is parsing kernel log for killed pods, collects information like namespace from ~~docker~~ containerd and exposes them in a Prometheus metric. It can be deployed as a `DaemonSet` to run on every node in your cluster, see [here for an example](yaml/oomkill-exporter.yaml). Exported metric is called `klog_pod_oomkill` and counts the amount of oomkills of a certain pod.

A Prometheus query for alerting could look something like this:

```

sum by(namespace, pod_name) (changes(klog_pod_oomkill[30m])) > 2

```

Note: Recent versions of `kubernetes-oomkill-exporter` (`>=0.5.0`) are only working with nodes running containerd as container runtime. If you are using docker please use a version prior than that.

## License

This project is licensed under the Apache2 License - see the [LICENSE](LICENSE) file for details