https://github.com/ceph/ceph-mixins
A set of Grafana dashboards and Prometheus alerts for Ceph.
https://github.com/ceph/ceph-mixins
ceph ceph-grafana-dashboards jsonnet kubernetes-mix prometheus-alerts prometheus-mixins
Last synced: 3 months ago
JSON representation
A set of Grafana dashboards and Prometheus alerts for Ceph.
- Host: GitHub
- URL: https://github.com/ceph/ceph-mixins
- Owner: ceph
- License: lgpl-2.1
- Created: 2019-03-12T14:05:38.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-29T19:30:29.000Z (about 2 years ago)
- Last Synced: 2024-12-29T19:06:17.200Z (5 months ago)
- Topics: ceph, ceph-grafana-dashboards, jsonnet, kubernetes-mix, prometheus-alerts, prometheus-mixins
- Language: Jsonnet
- Homepage:
- Size: 165 KB
- Stars: 20
- Watchers: 13
- Forks: 15
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Prometheus Monitoring Mixin for Ceph
A set of Prometheus alerts for Ceph.
The scope of this project is to provide Ceph specific Prometheus rule files using Prometheus Mixins.
## Prerequisites
* Jsonnet [[Install Jsonnet]](https://github.com/google/jsonnet#building-jsonnet)
[Jsonnet](https://jsonnet.org/learning/getting_started.html) is a data templating language for app and tool developers.
The mixin project uses Jsonnet to provide reusable and configurable configs for Grafana Dashboards and Prometheus Alerts.
* Jsonnet-bundler [[Install Jsonnet-bundler]](https://github.com/jsonnet-bundler/jsonnet-bundler#install)
[Jsonnet-bundler](https://github.com/jsonnet-bundler/jsonnet-bundler) is a package manager for jsonnet.
* Promtool
1. [Download](https://golang.org/dl/) Go (>=1.11) and [install](https://golang.org/doc/install) it on your system.
2. Setup the [GOPATH](http://www.g33knotes.org/2014/07/60-second-count-down-to-go.html) environment.
3. Run `$ go get -d github.com/prometheus/prometheus/cmd/promtool`
## How to use?
### Manually generate configs and rules
You can clone this repository and manually generate Grafana Dashboard configs and Prometheus Rules files, and apply it according to your setup.
```
$ git clone https://github.com/ceph/ceph-mixins.git
$ cd ceph-mixins
```
**To get dependencies**
`$ jb install`
**To generate Prometheus Alert file**
`$ make prometheus_alert_rules.yaml`
**To generate Prometheus Rule file**
`$ make prometheus_rules.yaml`
The **prometheus_alert_rules.yaml** and **prometheus_rules.yaml** files then needs to be passed to your Prometheus Server.
## Background
* [Prometheus Monitoring Mixin design doc](https://docs.google.com/document/d/1A9xvzwqnFVSOZ5fD3blKODXfsat5fg6ZhnKu9LK3lB4/edit#)