ceph/monitoring/ceph-mixin
Aashish Sharma 3063c8a4fb
Merge pull request #48783 from rhcs-dashboard/fix-grafana-stat-panel
mgr/dashboard: Replace vonage-status-panel with native grafana stat panel


Reviewed-by: Nizamudeen A <nia@redhat.com>
2023-02-08 18:34:30 +05:30
..
dashboards Merge pull request #48843 from rhcs-dashboard/expose_slow_ops 2022-12-20 12:25:32 +01:00
dashboards_out Merge pull request #48783 from rhcs-dashboard/fix-grafana-stat-panel 2023-02-08 18:34:30 +05:30
tests_alerts Merge pull request #48843 from rhcs-dashboard/expose_slow_ops 2022-12-20 12:25:32 +01:00
tests_dashboards monitoring/ceph-mixin: add RGW host to label info 2022-09-06 16:19:19 +02:00
.gitignore
.pylintrc
alerts.jsonnet prometheus: add multicluster support to alerts 2022-08-17 12:08:56 +02:00
alerts.libsonnet ceph-mixin: fix config inheritance 2022-08-18 16:21:36 +02:00
CMakeLists.txt ceph-mixin: fix PATH issues with jsonnet-bundler 2022-08-18 13:43:34 +02:00
config.libsonnet ceph-mixin: fix CephNodeNetworkPacket alerts 2022-08-23 15:26:52 +02:00
dashboards.jsonnet
dashboards.libsonnet ceph-mixin: refactor the structure of _config and utils 2022-05-16 15:26:56 +02:00
jsonnet-bundler-build.sh
jsonnetfile.json
jsonnetfile.lock.json monitoring/ceph-mixin: add RGW host to label info 2022-09-06 16:19:19 +02:00
lint-jsonnet.sh
Makefile ceph-mixin: fix makefile dashboards dependency 2022-05-16 15:26:55 +02:00
mixin.libsonnet ceph-mixin: refactor the structure of _config and utils 2022-05-16 15:26:56 +02:00
prometheus_alerts.libsonnet mgr/prometheus: expose daemon health metrics 2022-12-20 09:44:49 +01:00
prometheus_alerts.yml Merge pull request #48843 from rhcs-dashboard/expose_slow_ops 2022-12-20 12:25:32 +01:00
README.md doc/monitoring: add min vers of apps in mon stack 2022-09-05 07:36:52 +10:00
requirements-alerts.txt
requirements-grafonnet.txt
requirements-lint.txt
test-jsonnet.sh prometheus: add multicluster support to alerts 2022-08-17 12:08:56 +02:00
tox.ini *: s/whitelist_externals/allowlist_externals/ 2022-12-08 15:07:00 +08:00

Prometheus Monitoring Mixin for Ceph

A set of Grafana dashboards and Prometheus alerts for Ceph.

All the Grafana dashboards are already generated in the dashboards_out directory and alerts in the prometheus_alerts.yml file.

You can use the Grafana dashboards and alerts with Jsonnet like any other prometheus mixin. You can find more resources about mixins in general on monitoring.mixins.dev.

Grafana dashboards for Ceph

In dashboards_out you can find a collection of Grafana dashboards for Ceph Monitoring.

These dashboards are based on metrics collected from prometheus scraping the prometheus mgr plugin and the node_exporter (0.17.0).

-grafana 8.3.5 -grafana-piechart-panel 1.6.2 -grafana-status-panel 1.0.11

Requirements

Prometheus alerts

In prometheus_alerts.libsonnet you'll find a set of Prometheus alert rules that should provide a decent set of default alerts for a Ceph cluster. After building them with jsonnet put this file in place according to your Prometheus configuration (wherever the rules configuration stanza points).

Multi-cluster support

Ceph-mixin supports dashboards and alerts across multiple clusters. To enable this feature you need to configure the following in config.libsonnnet:

showMultiCluster: true,
clusterLabel: '<your cluster label>',

-prometheus v2.33.4

SNMP

Ceph provides a MIB (CEPH-PROMETHEUS-ALERT-MIB.txt) to support sending Prometheus alerts to an SNMP management platform. The translation from Prometheus alert to SNMP trap requires the Prometheus alert to contain an OID that maps to a definition within the MIB. When making changes to the Prometheus alert rules file, developers should include any necessary changes to the MIB.

-alertmanager 0.16.2

Building from Jsonnet

  • Install jsonnet (at least v0.18.0)
    • By installing the package jsonnet in most of the distro and golang-github-google-jsonnet in fedora
  • Install jsonnet-bundler

To rebuild all the generated files, you can run tox -egrafonnet-fix.

The jsonnet code located in this directory depends on some Jsonnet third party libraries. To update those libraries you can run jb update and then update the generated files using tox -egrafonnet-fix.