chore: archive observability-service-registry, track pi-map artifacts
- Archive the completed observability-service-registry SDD change into openspec/changes/archive/ (delivered across 5 slices; only jellyfin-service-registry remains active). - Stop ignoring .pi-map.md / .pi-map.index.md so the navigation maps are versioned alongside the code, and add the regenerated map pairs repo-wide.
This commit is contained in:
Developer
@@ -0,0 +1,32 @@
|
||||
# monitoring (index)
|
||||
dir: monitoring
|
||||
|
||||
## role
|
||||
Provides observability, metrics collection, and health-checking capabilities for the application.
|
||||
## parent
|
||||
index: ./.pi-map.index.md
|
||||
map: ./.pi-map.md
|
||||
## children
|
||||
- monitoring/alertmanager
|
||||
index: monitoring/alertmanager/.pi-map.index.md
|
||||
map: monitoring/alertmanager/.pi-map.md
|
||||
- monitoring/alloy
|
||||
index: monitoring/alloy/.pi-map.index.md
|
||||
map: monitoring/alloy/.pi-map.md
|
||||
- monitoring/grafana
|
||||
index: monitoring/grafana/.pi-map.index.md
|
||||
map: monitoring/grafana/.pi-map.md
|
||||
- monitoring/loki
|
||||
index: monitoring/loki/.pi-map.index.md
|
||||
map: monitoring/loki/.pi-map.md
|
||||
- monitoring/prometheus
|
||||
index: monitoring/prometheus/.pi-map.index.md
|
||||
map: monitoring/prometheus/.pi-map.md
|
||||
## files
|
||||
## links
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,18 @@
|
||||
# monitoring
|
||||
dir: monitoring
|
||||
|
||||
index: monitoring/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Provides observability, metrics collection, and health-checking capabilities for the application.
|
||||
## files
|
||||
## arch
|
||||
Directory is currently empty with no files to analyze for architectural patterns.
|
||||
## tags
|
||||
-
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/alertmanager (index)
|
||||
dir: monitoring/alertmanager
|
||||
|
||||
## role
|
||||
Central configuration package for Prometheus alert routing, grouping, and notification delivery within the monitoring stack.
|
||||
## parent
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- alertmanager.yml
|
||||
## links
|
||||
index: monitoring/alertmanager/.pi-map.index.md
|
||||
map: monitoring/alertmanager/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/alertmanager
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
alertmanager, configures, routing, grouping, delivering, prometheus, alerts, email
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/alloy (index)
|
||||
dir: monitoring/alloy
|
||||
|
||||
## role
|
||||
Centralized log collection configuration that scrapes Docker container logs and forwards them to Loki for storage and querying.
|
||||
## parent
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- config.alloy
|
||||
## links
|
||||
index: monitoring/alloy/.pi-map.index.md
|
||||
map: monitoring/alloy/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/alloy
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
docker, loki, discovery, config, configures, alloy, scrape, container
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,21 @@
|
||||
# monitoring/grafana (index)
|
||||
dir: monitoring/grafana
|
||||
|
||||
## role
|
||||
Provides centralized configuration for deploying and securing a Grafana monitoring dashboard instance.
|
||||
## parent
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## children
|
||||
- monitoring/grafana/provisioning
|
||||
index: monitoring/grafana/provisioning/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/.pi-map.md
|
||||
## files
|
||||
- grafana.ini
|
||||
## links
|
||||
index: monitoring/grafana/.pi-map.index.md
|
||||
map: monitoring/grafana/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/grafana
|
||||
dir: monitoring/grafana
|
||||
|
||||
index: monitoring/grafana/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Provides centralized configuration for deploying and securing a Grafana monitoring dashboard instance.
|
||||
## 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.
|
||||
## tags
|
||||
grafana, authentik, configuration, enabling, oauth, authentication, iframe, embedding
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,23 @@
|
||||
# monitoring/grafana/provisioning (index)
|
||||
dir: monitoring/grafana/provisioning
|
||||
|
||||
## role
|
||||
Provides declarative configuration for automatic Grafana dashboard and datasource provisioning without manual UI intervention.
|
||||
## parent
|
||||
index: monitoring/grafana/.pi-map.index.md
|
||||
map: monitoring/grafana/.pi-map.md
|
||||
## children
|
||||
- monitoring/grafana/provisioning/dashboards-json
|
||||
index: monitoring/grafana/provisioning/dashboards-json/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/dashboards-json/.pi-map.md
|
||||
- monitoring/grafana/provisioning/datasources
|
||||
index: monitoring/grafana/provisioning/datasources/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/datasources/.pi-map.md
|
||||
## files
|
||||
## links
|
||||
index: monitoring/grafana/provisioning/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,18 @@
|
||||
# monitoring/grafana/provisioning
|
||||
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.
|
||||
## files
|
||||
## arch
|
||||
Infrastructure-as-code pattern using Grafana's native provisioning system with YAML configuration files organized into subdirectories for datasources and dashboards.
|
||||
## tags
|
||||
-
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,21 @@
|
||||
# monitoring/grafana/provisioning/dashboards-json (index)
|
||||
dir: monitoring/grafana/provisioning/dashboards-json
|
||||
|
||||
## role
|
||||
Provides declarative configuration for automatically provisioning Grafana dashboards from local JSON files.
|
||||
## parent
|
||||
index: monitoring/grafana/provisioning/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/.pi-map.md
|
||||
## children
|
||||
- monitoring/grafana/provisioning/dashboards-json/dashboards
|
||||
index: monitoring/grafana/provisioning/dashboards-json/dashboards/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/dashboards-json/dashboards/.pi-map.md
|
||||
## files
|
||||
- dashboards.yml
|
||||
## links
|
||||
index: monitoring/grafana/provisioning/dashboards-json/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/dashboards-json/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/grafana/provisioning/dashboards-json
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
dashboards, grafana, configures, dashboard, provisioning, automatically, load, update
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,20 @@
|
||||
# monitoring/grafana/provisioning/dashboards-json/dashboards (index)
|
||||
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.
|
||||
## parent
|
||||
index: monitoring/grafana/provisioning/dashboards-json/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/dashboards-json/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- manage-overview.json
|
||||
- node-exporter-overview.json
|
||||
## links
|
||||
index: monitoring/grafana/provisioning/dashboards-json/dashboards/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/dashboards-json/dashboards/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,20 @@
|
||||
# monitoring/grafana/provisioning/dashboards-json/dashboards
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
grafana, overview, node, exporter, manage, dashboard, metrics, prometheus
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/grafana/provisioning/datasources (index)
|
||||
dir: monitoring/grafana/provisioning/datasources
|
||||
|
||||
## role
|
||||
Provisions and configures 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
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- datasources.yml
|
||||
## links
|
||||
index: monitoring/grafana/provisioning/datasources/.pi-map.index.md
|
||||
map: monitoring/grafana/provisioning/datasources/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/grafana/provisioning/datasources
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
grafana, prometheus, loki, datasources, configures, data, sources, monitoring
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/loki (index)
|
||||
dir: monitoring/loki
|
||||
|
||||
## role
|
||||
Provides configuration for deploying and managing the Grafana Loki log aggregation server.
|
||||
## parent
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- loki.yml
|
||||
## links
|
||||
index: monitoring/loki/.pi-map.index.md
|
||||
map: monitoring/loki/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/loki
|
||||
dir: monitoring/loki
|
||||
|
||||
index: monitoring/loki/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Provides configuration for deploying and managing the Grafana Loki log aggregation server.
|
||||
## 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).
|
||||
## tags
|
||||
loki, configures, grafana, log, aggregation, server, local, filesystem
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,24 @@
|
||||
# monitoring/prometheus (index)
|
||||
dir: monitoring/prometheus
|
||||
|
||||
## role
|
||||
Provides configuration for standalone Prometheus deployments to scrape and collect metrics from local infrastructure services and remote nodes.
|
||||
## parent
|
||||
index: monitoring/.pi-map.index.md
|
||||
map: monitoring/.pi-map.md
|
||||
## children
|
||||
- monitoring/prometheus/file-sd
|
||||
index: monitoring/prometheus/file-sd/.pi-map.index.md
|
||||
map: monitoring/prometheus/file-sd/.pi-map.md
|
||||
- monitoring/prometheus/rules
|
||||
index: monitoring/prometheus/rules/.pi-map.index.md
|
||||
map: monitoring/prometheus/rules/.pi-map.md
|
||||
## files
|
||||
- prometheus.standalone.yml
|
||||
## links
|
||||
index: monitoring/prometheus/.pi-map.index.md
|
||||
map: monitoring/prometheus/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/prometheus
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
node, loki, alertmanager, grafana, prometheus.standalone, configures, prometheus, monitoring
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/prometheus/file-sd (index)
|
||||
dir: monitoring/prometheus/file-sd
|
||||
|
||||
## role
|
||||
Provides static target configuration for Prometheus to discover and scrape node_exporter metrics endpoints.
|
||||
## parent
|
||||
index: monitoring/prometheus/.pi-map.index.md
|
||||
map: monitoring/prometheus/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- node_exporter_targets.json
|
||||
## links
|
||||
index: monitoring/prometheus/file-sd/.pi-map.index.md
|
||||
map: monitoring/prometheus/file-sd/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/prometheus/file-sd
|
||||
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.
|
||||
## 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.
|
||||
## tags
|
||||
targets, node, exporter, prometheus, empty, json, intended, define
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/prometheus/rules (index)
|
||||
dir: monitoring/prometheus/rules
|
||||
|
||||
## role
|
||||
Defines Prometheus alerting rules for monitoring backup job failures and observability stack health.
|
||||
## parent
|
||||
index: monitoring/prometheus/.pi-map.index.md
|
||||
map: monitoring/prometheus/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- backup_alerts.yml
|
||||
## links
|
||||
index: monitoring/prometheus/rules/.pi-map.index.md
|
||||
map: monitoring/prometheus/rules/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# monitoring/prometheus/rules
|
||||
dir: monitoring/prometheus/rules
|
||||
|
||||
index: monitoring/prometheus/rules/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines Prometheus alerting rules for monitoring backup job failures and observability stack health.
|
||||
## 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.
|
||||
## tags
|
||||
backup, prometheus, alerts, defines, alerting, rules, job, failures
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
Reference in New Issue
Block a user