Erich Blume
4f0476a851
## Summary Fixes the Facebook crawler spider trap that's been generating infinite recursive URLs like `/how-to/tutorials/tutorials/how-to/explanation/...` for several days. **Root cause:** Quartz SPA mode + nginx `try_files` fallback to `index.html` meant any fabricated URL returned the root HTML shell with HTTP 200. Crawlers followed relative links from those fake URLs, creating infinite recursion. **Fix:** - Disable Quartz SPA mode (`enableSPA: false`) — all pages are now fully static HTML - Replace nginx SPA fallback with `=404` + Quartz's static `404.html` - Remove `robots.txt` exclusions (no longer needed) **Docs cleanup (Obsidian.nvim compat no longer needed):** - Delete hand-curated category index files (`tutorials.md`, `reference.md`, `how-to.md`, `explanation.md`) — Quartz auto-generates folder pages - Delete `postgresql-storage.md` (redirect stub) and `migrate-forgejo-from-brew.md` (stale history) - Drop `docs-check-index` and `docs-check-filenames` prek hooks - Rewrite `docs-check-links` to allow path-based wiki-links (`[[path/to/file]]`) and only error on true ambiguity - Add `ai-docs` doc tree listing to replace index files for AI context - Add natural cross-links from reference cards to fix orphan docs ## Deployment and Testing - [ ] Merge and let the build pipeline run - [ ] Verify docs.eblu.me serves pages correctly with full page loads - [ ] Verify non-existent URLs return 404 - [ ] Monitor crawler traffic — should drop to near zero for fabricated URLs Reviewed-on: #290
70 lines
2.3 KiB
Markdown
70 lines
2.3 KiB
Markdown
---
|
|
title: Grafana
|
|
modified: 2026-02-28
|
|
tags:
|
|
- service
|
|
- observability
|
|
---
|
|
|
|
# Grafana
|
|
|
|
Dashboards and visualization for BlumeOps observability.
|
|
|
|
## Quick Reference
|
|
|
|
| Property | Value |
|
|
|----------|-------|
|
|
| **URL** | https://grafana.ops.eblu.me |
|
|
| **Tailscale URL** | https://grafana.tail8d86e.ts.net |
|
|
| **Namespace** | `monitoring` |
|
|
| **Deployment** | Kustomize (`argocd/manifests/grafana/`) |
|
|
| **Image** | `registry.ops.eblu.me/blumeops/grafana` |
|
|
| **Sidecar Image** | `registry.ops.eblu.me/blumeops/grafana-sidecar` |
|
|
|
|
## Authentication
|
|
|
|
Grafana supports two login methods:
|
|
|
|
- **SSO via [[authentik]]** — OIDC login through Authentik (`auth.generic_oauth`). Users click "Sign in with Authentik", authenticate at Authentik, and are redirected back as Admin.
|
|
- **Local admin** — break-glass login using the password from 1Password ("Grafana (blumeops)"). Always available if Authentik is down.
|
|
|
|
The OIDC client secret is injected via [[external-secrets]] (`grafana-authentik-oauth` secret in monitoring namespace).
|
|
|
|
## Datasources
|
|
|
|
| Name | Type | Target |
|
|
|------|------|--------|
|
|
| Prometheus | prometheus | `prometheus.monitoring.svc.cluster.local:9090` |
|
|
| Loki | loki | `loki.monitoring.svc.cluster.local:3100` |
|
|
| Tempo | tempo | `tempo.monitoring.svc.cluster.local:3200` |
|
|
| TeslaMate | postgres | `blumeops-pg-rw.databases.svc.cluster.local:5432` |
|
|
|
|
## Dashboard Provisioning
|
|
|
|
Dashboards are ConfigMaps with label `grafana_dashboard: "1"`.
|
|
|
|
Location: `argocd/manifests/grafana-config/dashboards/`
|
|
|
|
Optional annotation: `grafana_folder: "FolderName"`
|
|
|
|
## Key Dashboards
|
|
|
|
- macOS System - Host metrics for indri
|
|
- Minikube - Kubernetes cluster overview
|
|
- Borgmatic Backups - Backup status and trends
|
|
- Services Health - HTTP probe results
|
|
- Docs APM - Request rate, latency, cache for docs.eblu.me
|
|
- Fly.io Proxy Health - Aggregate proxy health across all upstream services
|
|
- TeslaMate (18 dashboards) - Vehicle data
|
|
|
|
## Related
|
|
|
|
- [[build-grafana-container]] - Home-built container image
|
|
- [[build-grafana-sidecar]] - Home-built sidecar container
|
|
- [[kustomize-grafana-deployment]] - Kustomize manifest structure
|
|
- [[authentik]] - OIDC identity provider for SSO
|
|
- [[migrate-grafana-to-authentik]] - How SSO was migrated from Dex to Authentik
|
|
- [[prometheus]] - Metrics datasource
|
|
- [[loki]] - Logs datasource
|
|
- [[tempo]] - Traces datasource
|
|
- [[alloy|Alloy]] - Data collector
|