nixos-homelab-monitoring

Observability stack on top of nixos-homelab: Grafana, long-term metrics storage, and the exporters/collectors that feed it, for both cluster and host-level monitoring.

For the full list of module options, see docs/options.md.

Setup

{
  inputs = {
    ...
    homelab-monitoring = {
      url = "github:nixos-homelab/monitoring";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    ...
  };
}

{ inputs, ... }:
{
  imports = [
    inputs.homelab-monitoring.nixosModules.grafana
    inputs.homelab-monitoring.nixosModules.mimir
  ];
  config = {
    homelab.grafana.enable = true;
    homelab.mimir.enable = true;
  };
}

Modules

• grafana: dashboards, provisioned with datasources for Mimir.
• mimir: long-term Prometheus-compatible metrics storage.
• alloy: the Grafana Alloy agent that scrapes and forwards metrics/logs, with a per-service integrations allow-list like homepage's.
• node-exporter: host-level metrics (CPU, memory, disk, network).
• smartctl-exporter: disk S.M.A.R.T. health metrics.
• zfs-exporter: ZFS pool metrics.
• metrics-server: standard Kubernetes metrics-server, for kubectl top and autoscaling.