node_exporter/docs/node-mixin
Will Bollock 0a17e17718
docs (node/mixin): fix annotation for Skew alert (#2671)
This updates the annotation for the NodeClockSkewDetected mixin alert to
match the new threshold set.

Original discussion was in this PR: https://github.com/prometheus/node_exporter/pull/1480

I spent an embarrassingly large amount of time trying to figure out how
the heck that alert would mean 300s of clock skew. Turns out the
annotation was just left the same after the threshold change.

Signed-off-by: Will Bollock <wbollock@linode.com>
2023-05-11 10:33:10 +02:00
..
alerts docs (node/mixin): fix annotation for Skew alert (#2671) 2023-05-11 10:33:10 +02:00
dashboards Replace mistaken ) with }, resulting in parsable promql 2022-12-13 13:30:42 +01:00
lib docs/node-mixin: add fsMointpointSelector to alerts and dashboards (#2446) 2022-10-20 13:06:31 +02:00
rules mixin: exclude iowait and steal from CPU Utilisation (#2194) 2021-11-04 11:03:27 +01:00
.gitignore
Makefile Fix up mixin tests (#2167) 2021-10-14 11:06:01 +02:00
README.md fix the following markdownlint issues (#2362) 2022-06-28 05:50:06 +02:00
alerts.jsonnet
config.libsonnet docs/node-mixin: add fsMointpointSelector to alerts and dashboards (#2446) 2022-10-20 13:06:31 +02:00
dashboards.jsonnet
jsonnetfile.json Add darwin dashboard to mixin 2022-04-20 15:18:43 +04:00
mixin.libsonnet
rules.jsonnet

README.md

Node Mixin

This is a work in progress. We aim for it to become a good role model for alerts and dashboards eventually, but it is not quite there yet.

The Node Mixin is a set of configurable, reusable, and extensible alerts and dashboards based on the metrics exported by the Node Exporter. The mixin creates recording and alerting rules for Prometheus and suitable dashboard descriptions for Grafana.

To use them, you need to have jsonnet (v0.16+) and jb installed. If you have a working Go development environment, it's easiest to run the following:

go install github.com/google/go-jsonnet/cmd/jsonnet@latest
go install github.com/google/go-jsonnet/cmd/jsonnetfmt@latest
go install github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb@latest

Next, install the dependencies by running the following command in this directory:

jb install

You can then build the Prometheus rules files node_alerts.yaml and node_rules.yaml:

make node_alerts.yaml node_rules.yaml

You can also build a directory dashboard_out with the JSON dashboard files for Grafana:

make dashboards_out

Note that some of the generated dashboards require recording rules specified in the previously generated node_rules.yaml.

For more advanced uses of mixins, see https://github.com/monitoring-mixins/docs.