chore: regenerate stale .pi-map.md / .pi-map.index.md project maps

Project map had drifted: claimed recharts unused (was used), ObservabilityPage.tsx
exists (refactored to service-tabs/), missed JellyfinNowPlayingWidget +
authentik/backups service types. Regenerate to reflect post-change reality:
new Qbittorrent/LineSeriesChart/Prometheus{Gauge,Mean}Widget files,
service_data.py/qbittorrent_store.py, canonical prometheus-charting +
service-storage specs, archived changes.
This commit is contained in:
Developer
2026-07-09 14:05:56 +00:00
parent 98f17f6e5d
commit ec7ebd7013
189 changed files with 1215 additions and 428 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring
## role
Provides observability, metrics collection, and health-checking capabilities for the application.
No files found in this directory; package is empty or contains no analyzable source files.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
+2 -2
View File
@@ -4,10 +4,10 @@ dir: monitoring
index: monitoring/.pi-map.index.md
## role
Provides observability, metrics collection, and health-checking capabilities for the application.
No files found in this directory; package is empty or contains no analyzable source files.
## files
## arch
Directory is currently empty with no files to analyze for architectural patterns.
N/A - empty directory with no files to analyze.
## tags
-
## symbols
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring/alertmanager
## role
Central configuration package for Prometheus alert routing, grouping, and notification delivery within the monitoring stack.
Manages alert routing, grouping, and notification delivery for Prometheus-generated alerts via email and webhook channels.
## parent
index: monitoring/.pi-map.index.md
map: monitoring/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/alertmanager
index: monitoring/alertmanager/.pi-map.index.md
## role
Central configuration package for Prometheus alert routing, grouping, and notification delivery within the monitoring stack.
Manages alert routing, grouping, and notification delivery for Prometheus-generated alerts via email and webhook channels.
## files
- alertmanager.yml | Configures Alertmanager for routing, grouping, and delivering Prometheus alerts via email and webhook with support for critical alert escalation and inhibition rules. | dep: Alertmanager, SMTP server, webhook endpoint, environment variables (SMTP_HOST, SMTP_PORT, SMTP_FROM_ADDRESS, SMTP_USERNAME, SMTP_PASSWORD, ALERT_EMAIL_TO, ALERTMANAGER_WEBHOOK_URL)
## arch
Declarative YAML configuration utilizing a hierarchical routing tree with receiver-based notification patterns (email, webhook) and alert inhibition rules to prevent notification storms.
Declarative YAML configuration implementing rule-based routing, alert grouping, inhibition policies, and critical escalation patterns.
## tags
alertmanager, configures, routing, grouping, delivering, prometheus, alerts, email
## symbols
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring/alloy
## role
Centralized log collection configuration that scrapes Docker container logs and forwards them to Loki for storage and querying.
Centralized configuration for collecting and forwarding container logs to the monitoring system's log aggregation backend.
## parent
index: monitoring/.pi-map.index.md
map: monitoring/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/alloy
index: monitoring/alloy/.pi-map.index.md
## role
Centralized log collection configuration that scrapes Docker container logs and forwards them to Loki for storage and querying.
Centralized configuration for collecting and forwarding container logs to the monitoring system's log aggregation backend.
## files
- config.alloy | Configures Alloy to scrape Docker container logs and forward them to a local Loki instance | dep: docker, loki, discovery.docker, discovery.relabel, loki.source.docker, loki.write
## arch
Declarative agent-based collection pattern using Grafana Alloy's discovery and pipeline stages to discover containers, tail their logs, and stream them to a local Loki destination.
Declarative agent-based collection pattern using Grafana Alloy's pipeline architecture to scrape Docker logs and ship them to Loki.
## tags
docker, loki, discovery, config, configures, alloy, scrape, container
## symbols
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring/grafana
## role
Provides centralized configuration for deploying and securing a Grafana monitoring dashboard instance.
Provides centralized Grafana configuration enabling OAuth-based authentication, iframe embedding, and role-based access control for the monitoring dashboard.
## parent
index: monitoring/.pi-map.index.md
map: monitoring/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/grafana
index: monitoring/grafana/.pi-map.index.md
## role
Provides centralized configuration for deploying and securing a Grafana monitoring dashboard instance.
Provides centralized Grafana configuration enabling OAuth-based authentication, iframe embedding, and role-based access control for the monitoring dashboard.
## files
- grafana.ini | Grafana configuration file enabling OAuth authentication via Authentik, iframe embedding support, and role-based access control via group membership | dep: Authentik, Grafana, environment variables (GF_AUTH_GENERIC_OAUTH_*)
## arch
Declarative infrastructure configuration utilizing file-based static settings for OAuth2 (Authentik), role-based access control (RBAC), and UI embedding parameters.
Infrastructure-as-code pattern using a declarative INI configuration file to externalize service-level settings for authentication and authorization.
## tags
grafana, authentik, configuration, enabling, oauth, authentication, iframe, embedding
## symbols
@@ -2,7 +2,7 @@
dir: monitoring/grafana/provisioning
## role
Provides declarative configuration for automatic Grafana dashboard and datasource provisioning without manual UI intervention.
Contains Grafana dashboard provisioning configurations for automatically loading dashboards in the monitoring stack.
## parent
index: monitoring/grafana/.pi-map.index.md
map: monitoring/grafana/.pi-map.md
+2 -2
View File
@@ -4,10 +4,10 @@ dir: monitoring/grafana/provisioning
index: monitoring/grafana/provisioning/.pi-map.index.md
## role
Provides declarative configuration for automatic Grafana dashboard and datasource provisioning without manual UI intervention.
Contains Grafana dashboard provisioning configurations for automatically loading dashboards in the monitoring stack.
## files
## arch
Infrastructure-as-code pattern using Grafana's native provisioning system with YAML configuration files organized into subdirectories for datasources and dashboards.
Follows Grafana's declarative provisioning pattern with structured directories for dashboards and datasources.
## tags
-
## symbols
@@ -2,7 +2,7 @@
dir: monitoring/grafana/provisioning/dashboards-json
## role
Provides declarative configuration for automatically provisioning Grafana dashboards from local JSON files.
Configures automated provisioning of Grafana dashboards from JSON files in the monitoring stack.
## parent
index: monitoring/grafana/provisioning/.pi-map.index.md
map: monitoring/grafana/provisioning/.pi-map.md
@@ -4,11 +4,11 @@ dir: monitoring/grafana/provisioning/dashboards-json
index: monitoring/grafana/provisioning/dashboards-json/.pi-map.index.md
## role
Provides declarative configuration for automatically provisioning Grafana dashboards from local JSON files.
Configures automated provisioning of Grafana dashboards from JSON files in the monitoring stack.
## files
- dashboards.yml | Configures Grafana dashboard provisioning to automatically load and update dashboards from a JSON file directory | dep: Grafana, provisioning system, file system
## arch
Uses Grafana's file-based provisioning system to load dashboard definitions from a configured directory path.
Declarative configuration pattern using Grafana's file-based provisioning system with YAML configuration pointing to a JSON dashboard directory.
## tags
dashboards, grafana, configures, dashboard, provisioning, automatically, load, update
## symbols
@@ -2,7 +2,7 @@
dir: monitoring/grafana/provisioning/dashboards-json/dashboards
## role
This directory stores pre-built Grafana dashboard JSON definitions for monitoring the "manage" service and host-level system metrics via node-exporter.
Provides pre-configured Grafana dashboard JSON definitions for visualizing service and system-level infrastructure metrics.
## parent
index: monitoring/grafana/provisioning/dashboards-json/.pi-map.index.md
map: monitoring/grafana/provisioning/dashboards-json/.pi-map.md
@@ -4,12 +4,12 @@ dir: monitoring/grafana/provisioning/dashboards-json/dashboards
index: monitoring/grafana/provisioning/dashboards-json/dashboards/.pi-map.index.md
## role
This directory stores pre-built Grafana dashboard JSON definitions for monitoring the "manage" service and host-level system metrics via node-exporter.
Provides pre-configured Grafana dashboard JSON definitions for visualizing service and system-level infrastructure metrics.
## files
- manage-overview.json | Grafana dashboard configuration for monitoring a "manage" service with metrics and logs visualization | dep: prometheus, loki, grafana
- node-exporter-overview.json | Grafana dashboard JSON for visualizing node-exporter system metrics (CPU, memory, disk, network) | dep: Grafana, Prometheus, node-exporter
## arch
It follows Grafana's infrastructure-as-code provisioning pattern, using static JSON files to declaratively define dashboard layouts, queries, and visualizations that are automatically loaded by Grafana at startup.
Declarative infrastructure-as-code pattern using static JSON dashboard configurations consumed by Grafana's provisioning system.
## tags
grafana, overview, node, exporter, manage, dashboard, metrics, prometheus
## symbols
@@ -2,7 +2,7 @@
dir: monitoring/grafana/provisioning/datasources
## role
Provisions and configures Grafana data source connections to Prometheus and Loki monitoring backends.
Provisions Grafana data source connections to Prometheus and Loki monitoring backends.
## parent
index: monitoring/grafana/provisioning/.pi-map.index.md
map: monitoring/grafana/provisioning/.pi-map.md
@@ -4,11 +4,11 @@ dir: monitoring/grafana/provisioning/datasources
index: monitoring/grafana/provisioning/datasources/.pi-map.index.md
## role
Provisions and configures Grafana data source connections to Prometheus and Loki monitoring backends.
Provisions Grafana data source connections to Prometheus and Loki monitoring backends.
## files
- datasources.yml | Configures Grafana data sources for Prometheus and Loki monitoring backends | dep: Grafana, Prometheus, Loki
## arch
Declarative Infrastructure-as-Code (IaC) using Grafana's native YAML provisioning system for automated data source setup.
Declarative Infrastructure-as-Code pattern using Grafana's native YAML provisioning system for automated data source configuration.
## tags
grafana, prometheus, loki, datasources, configures, data, sources, monitoring
## symbols
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring/loki
## role
Provides configuration for deploying and managing the Grafana Loki log aggregation server.
Provides configuration for Grafana Loki, the centralized log aggregation server in the project's monitoring stack.
## parent
index: monitoring/.pi-map.index.md
map: monitoring/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/loki
index: monitoring/loki/.pi-map.index.md
## role
Provides configuration for deploying and managing the Grafana Loki log aggregation server.
Provides configuration for Grafana Loki, the centralized log aggregation server in the project's monitoring stack.
## files
- loki.yml | Configures Grafana Loki log aggregation server with local filesystem storage and 30-day retention | dep: loki, tsdb, filesystem storage, inmemory ring kvstore
## arch
Single-file declarative configuration defining Loki's storage backend (local filesystem) and data retention policy (30-day table).
Uses a declarative YAML configuration pattern utilizing local filesystem storage with a 30-day log retention policy.
## tags
loki, configures, grafana, log, aggregation, server, local, filesystem
## symbols
+1 -1
View File
@@ -2,7 +2,7 @@
dir: monitoring/prometheus
## role
Provides configuration for standalone Prometheus deployments to scrape and collect metrics from local infrastructure services and remote nodes.
Provides Prometheus server configuration for scraping metrics from infrastructure components and remote nodes using standalone deployment.
## parent
index: monitoring/.pi-map.index.md
map: monitoring/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/prometheus
index: monitoring/prometheus/.pi-map.index.md
## role
Provides configuration for standalone Prometheus deployments to scrape and collect metrics from local infrastructure services and remote nodes.
Provides Prometheus server configuration for scraping metrics from infrastructure components and remote nodes using standalone deployment.
## files
- prometheus.standalone.yml | Configures Prometheus monitoring server to scrape metrics from itself, node exporters, Loki, Alertmanager, Grafana, and remote nodes via file-based service discovery | dep: alertmanager, node-exporter, loki, grafana, file-sd
## arch
Uses a declarative static YAML configuration pattern leveraging file-based service discovery for dynamic remote target management.
Declarative monitoring configuration using static targets and file-based service discovery patterns for federated metrics collection.
## tags
node, loki, alertmanager, grafana, prometheus.standalone, configures, prometheus, monitoring
## symbols
@@ -2,7 +2,7 @@
dir: monitoring/prometheus/file-sd
## role
Provides static target configuration for Prometheus to discover and scrape node_exporter metrics endpoints.
Provides file-based service discovery configuration for Prometheus node_exporter scrape targets.
## parent
index: monitoring/prometheus/.pi-map.index.md
map: monitoring/prometheus/.pi-map.md
+2 -2
View File
@@ -4,11 +4,11 @@ dir: monitoring/prometheus/file-sd
index: monitoring/prometheus/file-sd/.pi-map.index.md
## role
Provides static target configuration for Prometheus to discover and scrape node_exporter metrics endpoints.
Provides file-based service discovery configuration for Prometheus node_exporter scrape targets.
## files
- node_exporter_targets.json | Empty JSON file intended to define scrape targets for Prometheus node_exporter | dep: Prometheus, node_exporter
## arch
Uses the Prometheus file-based service discovery (file_sd) pattern with JSON-formatted target definitions.
Static file service discovery pattern using Prometheus file_sd_config mechanism with JSON-formatted target definitions.
## tags
targets, node, exporter, prometheus, empty, json, intended, define
## symbols
+1 -1
View File
@@ -8,7 +8,7 @@ Defines Prometheus alerting rules for monitoring backup job failures and observa
## files
- backup_alerts.yml | Defines Prometheus alerting rules for backup job failures and observability stack health monitoring. | dep: Prometheus, Alertmanager, Grafana, manage_backup_runs_total metric, manage_backup_runs_last_success_timestamp metric, up metric
## arch
Configuration-as-code pattern using declarative YAML rule files consumed directly by the Prometheus alerting engine.
Declarative Infrastructure-as-Code using YAML-based Prometheus alerting rule definitions.
## tags
backup, prometheus, alerts, defines, alerting, rules, job, failures
## symbols