add grafana provisioning

README.md

@@ -242,6 +242,55 @@ docker compose -f docker-compose.yml up -d
 docker compose logs -f app
 ```
 
+## Grafana Provisioning
+
+当前仓库支持通过 Grafana provisioning 自动加载 SQLite datasource 和 repo 内的 dashboard 导出文件。
+
+需要保留的文件路径如下：
+
+- `grafana/provisioning/datasources/locationrecorder.yaml`
+- `grafana/provisioning/datasources/poorecorder.yaml`
+- `grafana/provisioning/dashboards/provider.yaml`
+- `grafana/dashboards/locationrecorder.json`
+- `grafana/dashboards/poorecorder.json`
+
+这些文件的职责分别是：
+
+- `grafana/provisioning/datasources/locationrecorder.yaml`：声明 `locationrecorder` SQLite datasource，并指向 `/data/home-automation/locationRecorder.db`
+- `grafana/provisioning/datasources/poorecorder.yaml`：声明 `poorecorder` SQLite datasource，并指向 `/data/home-automation/pooRecorder.db`
+- `grafana/provisioning/dashboards/provider.yaml`：告诉 Grafana 从 `/var/lib/grafana/dashboards` 扫描并加载 dashboard JSON
+- `grafana/dashboards/locationrecorder.json`：location recorder dashboard 导出文件，内容本身不需要在 compose 中改写
+- `grafana/dashboards/poorecorder.json`：poo recorder dashboard 导出文件，内容本身不需要在 compose 中改写
+
+当前 `docker-compose.yml` 中，Grafana service 需要挂载以下目录：
+
+- `./grafana/provisioning -> /etc/grafana/provisioning:ro`
+- `./grafana/dashboards -> /var/lib/grafana/dashboards:ro`
+
+同时保留现有 named volume `homeautomation_grafana_storage:/var/lib/grafana` 作为 Grafana 运行态数据存储。
+
+一键启动前，至少需要以下文件已经存在：
+
+- `grafana/provisioning/datasources/locationrecorder.yaml`
+- `grafana/provisioning/datasources/poorecorder.yaml`
+- `grafana/provisioning/dashboards/provider.yaml`
+- `grafana/dashboards/locationrecorder.json`
+- `grafana/dashboards/poorecorder.json`
+
+启动方式：
+
+```bash
+docker compose up -d
+```
+
+启动后会发生的事情：
+
+- Grafana 容器会安装 `frser-sqlite-datasource` 插件
+- Grafana 会读取 `/etc/grafana/provisioning/datasources/` 下的 datasource YAML
+- Grafana 会读取 `/etc/grafana/provisioning/dashboards/provider.yaml`
+- Grafana 会从 `/var/lib/grafana/dashboards/` 自动导入两个 dashboard JSON
+- 现有 Grafana named volume 继续负责保存 Grafana 运行态数据，不会覆盖 repo 内的 dashboard 与 provisioning 文件
+
 ## Container Image CI
 
 项目提供了一个 release image workflow：