docs: generate Prometheus-driven monitoring docs and Mermaid diagrams

2026-04-13 16:47:26 +10:00
parent 72cda2dc92
commit 26b7b461a3
7 changed files with 706 additions and 0 deletions
@@ -0,0 +1,17 @@
+flowchart TB
+  Declared[Declared architecture\n(Compose + docs)]
+  Runtime[Observed runtime\n(Prometheus inventory)]
+  Declared --> Runtime
+
+  subgraph Monitoring["Prometheus observed jobs"]
+    job_container_updates["container-updates"]
+    job_kuma["kuma"]
+    job_node["node"]
+    job_pihole["pihole"]
+    job_prometheus["prometheus"]
+    job_proxmox_storage["proxmox-storage"]
+    job_telegraf["telegraf"]
+    job_traefik["traefik"]
+  end
+
+  Runtime --> Monitoring
@@ -0,0 +1,90 @@
+flowchart LR
+  Prom[Prometheus]
+
+  classDef scrape stroke-dasharray: 5 5;
+  subgraph host_docker_update_exporter["Host: docker-update-exporter"]
+    container_updates_docker_update_exporter_9105["container-updates\ndocker-update-exporter:9105"]
+  end
+  subgraph host_kuma_lan_ddnsgeek_com["Host: kuma.lan.ddnsgeek.com"]
+    kuma_kuma_lan_ddnsgeek_com["kuma\nkuma.lan.ddnsgeek.com"]
+  end
+  subgraph host_monitor_kuma["Host: monitor-kuma"]
+    kuma_monitor_kuma_3001["kuma\nmonitor-kuma:3001"]
+  end
+  subgraph host_nix_cache["Host: nix-cache"]
+    node_nix_cache_9100["node\nnix-cache:9100"]
+  end
+  subgraph host_node_exporter["Host: node-exporter"]
+    node_node_exporter_9100["node\nnode-exporter:9100"]
+  end
+  subgraph host_pbs_sweet_home["Host: pbs.sweet.home"]
+    node_pbs_sweet_home_9100["node\npbs.sweet.home:9100"]
+    proxmox_storage_pbs_sweet_home_9102["proxmox-storage\npbs.sweet.home:9102"]
+  end
+  subgraph host_pihole["Host: pihole"]
+    node_pihole_9100["node\npihole:9100"]
+  end
+  subgraph host_pihole_exporter["Host: pihole-exporter"]
+    pihole_pihole_exporter_9617["pihole\npihole-exporter:9617"]
+  end
+  subgraph host_prometheus["Host: prometheus"]
+    prometheus_prometheus_9090["prometheus\nprometheus:9090"]
+  end
+  subgraph host_pve_sweet_home["Host: pve.sweet.home"]
+    node_pve_sweet_home_9100["node\npve.sweet.home:9100"]
+    proxmox_storage_pve_sweet_home_9101["proxmox-storage\npve.sweet.home:9101"]
+  end
+  subgraph host_raspberrypi_tail13f623_ts_net["Host: raspberrypi.tail13f623.ts.net"]
+    container_updates_raspberrypi_tail13f623_ts_net_9105["container-updates\nraspberrypi.tail13f623.ts.net:9105"]
+    node_raspberrypi_tail13f623_ts_net_9100["node\nraspberrypi.tail13f623.ts.net:9100"]
+    telegraf_raspberrypi_tail13f623_ts_net_9273["telegraf\nraspberrypi.tail13f623.ts.net:9273"]
+    traefik_raspberrypi_tail13f623_ts_net_8080["traefik\nraspberrypi.tail13f623.ts.net:8080"]
+  end
+  subgraph host_server["Host: server"]
+    node_server_9100["node\nserver:9100"]
+  end
+  subgraph host_telegraf["Host: telegraf"]
+    telegraf_telegraf_9273["telegraf\ntelegraf:9273"]
+  end
+  subgraph host_traefik_lan_ddnsgeek_com["Host: traefik.lan.ddnsgeek.com"]
+    traefik_traefik_lan_ddnsgeek_com_8080["traefik\ntraefik.lan.ddnsgeek.com:8080"]
+  end
+
+  Prom -. scrape .-> container_updates_docker_update_exporter_9105
+  class container_updates_docker_update_exporter_9105 scrape;
+  Prom -. scrape .-> container_updates_raspberrypi_tail13f623_ts_net_9105
+  class container_updates_raspberrypi_tail13f623_ts_net_9105 scrape;
+  Prom -. scrape .-> kuma_kuma_lan_ddnsgeek_com
+  class kuma_kuma_lan_ddnsgeek_com scrape;
+  Prom -. scrape .-> kuma_monitor_kuma_3001
+  class kuma_monitor_kuma_3001 scrape;
+  Prom -. scrape .-> node_nix_cache_9100
+  class node_nix_cache_9100 scrape;
+  Prom -. scrape .-> node_node_exporter_9100
+  class node_node_exporter_9100 scrape;
+  Prom -. scrape .-> node_pbs_sweet_home_9100
+  class node_pbs_sweet_home_9100 scrape;
+  Prom -. scrape .-> node_pihole_9100
+  class node_pihole_9100 scrape;
+  Prom -. scrape .-> node_pve_sweet_home_9100
+  class node_pve_sweet_home_9100 scrape;
+  Prom -. scrape .-> node_raspberrypi_tail13f623_ts_net_9100
+  class node_raspberrypi_tail13f623_ts_net_9100 scrape;
+  Prom -. scrape .-> node_server_9100
+  class node_server_9100 scrape;
+  Prom -. scrape .-> pihole_pihole_exporter_9617
+  class pihole_pihole_exporter_9617 scrape;
+  Prom -. scrape .-> prometheus_prometheus_9090
+  class prometheus_prometheus_9090 scrape;
+  Prom -. scrape .-> proxmox_storage_pbs_sweet_home_9102
+  class proxmox_storage_pbs_sweet_home_9102 scrape;
+  Prom -. scrape .-> proxmox_storage_pve_sweet_home_9101
+  class proxmox_storage_pve_sweet_home_9101 scrape;
+  Prom -. scrape .-> telegraf_raspberrypi_tail13f623_ts_net_9273
+  class telegraf_raspberrypi_tail13f623_ts_net_9273 scrape;
+  Prom -. scrape .-> telegraf_telegraf_9273
+  class telegraf_telegraf_9273 scrape;
+  Prom -. scrape .-> traefik_raspberrypi_tail13f623_ts_net_8080
+  class traefik_raspberrypi_tail13f623_ts_net_8080 scrape;
+  Prom -. scrape .-> traefik_traefik_lan_ddnsgeek_com_8080
+  class traefik_traefik_lan_ddnsgeek_com_8080 scrape;