Panel Macros And Time Ranges

GrafanaSight panel macros show Grafana-rendered snapshots inside Confluence pages. They are useful for runbooks, post-incident reports, release readiness pages, and operational reviews where one panel tells the story better than a link.

Add A Panel Macro From A Grafana URL

Use a Grafana panel URL from a dashboard or solo panel view. GrafanaSight recognizes supported Grafana Cloud dashboard and panel links and can convert them into macros.

Recommended manual workflow:

1. Open the target Grafana dashboard.
2. Choose the panel and time range you want readers to see.
3. Copy the panel URL.
4. Edit the Confluence page.
5. Paste one Grafana URL.
6. Press Enter.
7. Confirm that Confluence converts the single URL into a GrafanaSight macro.
8. Repeat one URL at a time for additional panels.

Pasting one URL at a time is more reliable than bulk-pasting multiple Grafana links, because Confluence may otherwise keep them as generic smart links.

Detailed And Compact Panels

Use detailed panels for primary operational signals. Use compact panels for dense pages, executive summaries, or multi-service comparison pages.

GrafanaSight renders detailed snapshots at a larger size and compact snapshots at a smaller size. Both keep the panel tied to the source dashboard, panel ID, time range, and template variables in the URL.

Time Ranges

GrafanaSight supports common relative presets such as:

• Last 15 minutes.
• Last 1 hour.
• Last 6 hours.
• Last 24 hours.
• Last 7 days.
• Last 30 days.

When a Grafana URL includes an absolute time range, GrafanaSight can use that range too. If the link and macro configuration do not provide a time range, the panel defaults to a recent operational window.

Template Variables

Grafana dashboard variables that appear in the URL are passed through to the render request when they use Grafana’s var- parameter format. This keeps service, datasource, region, project, or environment filters aligned with the source dashboard link.

Caching And Fallbacks

Panel rendering depends on Grafana Cloud returning an image for the selected panel. GrafanaSight caches panel image data when it is small enough to store safely. If live rendering later fails but a cached snapshot is available, GrafanaSight can show the cached image with stale context instead of leaving the runbook empty.

Authoring Tips

• Prefer a small number of high-signal panels over a wall of screenshots.
• Give each macro enough page context so readers know what action the metric supports.
• Use compact macros for supporting context and detailed macros for the signal that drives decisions.
• Refresh the page macros after large Grafana changes or after first inserting several macros.