docs: add Grafana Cloud dashboard provisioning learnings

[FSM1]

Summary

• Documents key gotchas discovered while setting up Grafana Cloud dashboard auto-provisioning via CI
• Covers: Admin role requirement, trailing slash 301, empty 403 body, __inputs substitution, GH Actions environment: scoping

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added comprehensive guidance on provisioning Grafana dashboards to Grafana Cloud during staging deployments, including troubleshooting tips for common issues such as RBAC configuration, URL formatting, and datasource substitution.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 54369041-6423-4854-a315-b74f17d1dc15

📥 Commits

Reviewing files that changed from the base of the PR and between a6fe4c4 and bb499cf.

📒 Files selected for processing (1)

• .learnings/2026-03-07-grafana-cloud-dashboard-provisioning.md

---

Walkthrough

A new learning documentation file is added capturing operational insights and diagnostic guidance for auto-provisioning Grafana dashboards to Grafana Cloud, including RBAC requirements, URL normalization, datasource placeholder substitution, and token validation techniques.

Changes

Cohort / File(s)	Summary
Grafana Cloud Provisioning Documentation .learnings/2026-03-07-grafana-cloud-dashboard-provisioning.md	New document recording operational learnings: Admin RBAC requirement for Grafana Cloud, 301 redirect handling, datasource placeholder substitution via jq walk(), token validation, and staging environment configuration for GitHub Actions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• fix: auto-provision Grafana dashboard on staging deploy #282 — Implements the provision-dashboard job and dashboard JSON transformations that this learning document describes and provides operational guidance for.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the main change: addition of documentation about Grafana Cloud dashboard provisioning learnings, which directly matches the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/grafana-cloud-learnings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}