first version of the knowledge base :)

70 - Tools/grafana/grafana.md

@@ -0,0 +1,63 @@
+---
+title: Grafana
+description: Tool overview for Grafana as a dashboarding and observability interface
+tags:
+  - grafana
+  - monitoring
+  - dashboards
+category: tools
+created: 2026-03-14
+updated: 2026-03-14
+---
+
+# Grafana
+
+## Summary
+
+Grafana is a visualization and observability platform used to build dashboards, explore metrics, and manage alerting workflows across multiple data sources. In self-hosted environments, it is commonly paired with Prometheus to make infrastructure and service health easier to understand.
+
+## Why it matters
+
+Metrics data is more useful when operators can navigate it quickly during incidents and routine reviews. Grafana helps turn raw monitoring data into operational context that supports troubleshooting, reporting, and change validation.
+
+## Core concepts
+
+- Data sources such as Prometheus, Loki, or other backends
+- Dashboards and panels for visualization
+- Variables for reusable filtered views
+- Alerting and notification integration
+- Role-based access to shared observability data
+
+## Practical usage
+
+Grafana commonly fits into infrastructure as:
+
+```text
+Prometheus and other data sources -> Grafana dashboards and alerts -> operators
+```
+
+Typical uses:
+
+- Infrastructure overview dashboards
+- Service-specific health views
+- Incident triage and post-change validation
+
+## Best practices
+
+- Keep dashboards tied to operational questions
+- Build separate views for platform health and service health
+- Use variables and naming conventions consistently
+- Protect Grafana access and treat it as part of the observability platform
+
+## Pitfalls
+
+- Creating dashboards that look impressive but answer no real question
+- Treating dashboards as enough without proper alerts
+- Allowing panel sprawl and inconsistent naming
+- Failing to back up dashboard definitions and provisioning config
+
+## References
+
+- [Grafana documentation](https://grafana.com/docs/grafana/latest/)
+- [Grafana dashboards](https://grafana.com/docs/grafana/latest/dashboards/)
+- [Grafana alerting](https://grafana.com/docs/grafana/latest/alerting/)