aboutsummaryrefslogtreecommitdiffstats
path: root/modules/dashboards.nix
diff options
context:
space:
mode:
Diffstat (limited to 'modules/dashboards.nix')
-rw-r--r--modules/dashboards.nix75
1 files changed, 75 insertions, 0 deletions
diff --git a/modules/dashboards.nix b/modules/dashboards.nix
new file mode 100644
index 0000000..125e3e2
--- /dev/null
+++ b/modules/dashboards.nix
@@ -0,0 +1,75 @@
+# Grafana dashboards, built into a form file-provisioning can actually use.
+#
+# Returns an attrset of { name = derivation; }, where each derivation is a single
+# dashboard JSON file. modules/server.nix drops these into /etc/grafana-dashboards.
+{ lib, runCommand, fetchurl, jq, dsUid }:
+
+let
+ # Dashboards exported from grafana.com carry an `__inputs` block and reference their
+ # datasource as "''${DS_PROMETHEUS}". That placeholder is only substituted by Grafana's
+ # interactive *import* flow -- file provisioning never runs it, so the uid stays
+ # literal and every panel fails to resolve a datasource. Substitute at build time.
+ #
+ # A dashboard-level `datasource`-type template variable (lowercase, e.g.
+ # "''${ds_prometheus}") is a different mechanism and resolves fine on its own; this
+ # only touches names declared in __inputs.
+ fixupProgram = ''
+ def dsuid($pluginId):
+ if $pluginId == "prometheus" then $prom
+ elif $pluginId == "loki" then $loki
+ else "" end;
+
+ def subst($name; $uid):
+ walk(if type == "string" then gsub("\\$\\{" + $name + "\\}"; $uid) else . end);
+
+ reduce (.__inputs // [])[] as $i (.; subst($i.name; dsuid($i.pluginId)))
+ | del(.__inputs, .__requires)
+ # Provisioned dashboards must not carry an id, or Grafana rejects them on collision
+ # with whatever already occupies that id in its database.
+ | .id = null
+ '';
+
+ fixup = name: src: runCommand "grafana-dashboard-${name}.json"
+ { nativeBuildInputs = [ jq ]; }
+ ''
+ jq --arg prom ${lib.escapeShellArg dsUid.prometheus} \
+ --arg loki ${lib.escapeShellArg dsUid.loki} \
+ ${lib.escapeShellArg fixupProgram} < ${src} > "$out"
+ '';
+
+ fromGrafanaCom = { name, id, rev, hash }:
+ fixup name (fetchurl {
+ url = "https://grafana.com/api/dashboards/${toString id}/revisions/${toString rev}/download";
+ inherit hash;
+ });
+in
+{
+ # https://grafana.com/grafana/dashboards/1860
+ node-exporter-full = fromGrafanaCom {
+ name = "node-exporter-full";
+ id = 1860;
+ rev = 45;
+ hash = "sha256-GExrdAnzBtp1Ul13cvcZRbEM6iOtFrXXjEaY6g6lGYY=";
+ };
+
+ # https://grafana.com/grafana/dashboards/22604
+ smartctl-exporter = fromGrafanaCom {
+ name = "smartctl-exporter";
+ id = 22604;
+ rev = 2;
+ hash = "sha256-ci8WE23fZ+ltEKFoUdNNVXsUIV0jqtas79ia2lYIo88=";
+ };
+
+ # Dashboard 15362 ("ZFS Pool Metrics") used to fill this slot. It is an *InfluxDB*
+ # dashboard -- its queries are InfluxQL against a `zpool_stats` measurement -- so it
+ # can never render against Prometheus, however it is provisioned. This is a
+ # Prometheus-native replacement built on the metrics we actually export: node
+ # exporter's zfs collector plus the ZFS textfile collector.
+ # Generated by dashboards/gen_zfs.py.
+ zfs-pools = fixup "zfs-pools" ../dashboards/zfs-pools.json;
+
+ # CrystalDiskInfo-style per-drive SMART view. Generated by dashboards/gen_smart.py.
+ # The Good/Caution/Bad verdict and the per-drive row titles both come from the
+ # recording rules in rules/smartctl.yml, so this one needs those loaded to be useful.
+ drive-health = fixup "drive-health" ../dashboards/smart.json;
+}