Metrics Widget
The Metrics Tile widget embeds any Grafana panel directly in your dashboard using an iframe. No code required — just paste the Grafana panel URL. Useful for KPI tiles, time-series charts, and status indicators from BizFirstObserve.
How It Works
WorkDesk renders the Metrics Tile as an <iframe> with the Grafana panel URL as its src. Grafana handles its own authentication (anonymous access or SSO-shared session). The panel refreshes on its own Grafana-configured interval.
Configuring the Metrics Widget
When adding a Metrics Tile, the configuration form asks for:
| Field | Required? | Description |
|---|---|---|
| Grafana Panel URL | Required | The full embed URL from Grafana's Share → Embed panel. Must be from your organization's Grafana instance. |
| Widget Title | Optional | Override label shown above the iframe. If blank, uses the Grafana panel title. |
| Height | Optional | iframe height in pixels. Default: 200px. Increase for chart panels. |
Getting the Grafana Panel URL
Open the Panel in Grafana
Navigate to the dashboard panel in BizFirstObserve (Grafana). Click the panel title → Share.
Go to the "Embed" Tab
In the Share dialog, click the Embed tab. Copy the URL from the <iframe src="..."> tag — this is the URL to paste in the Metrics Tile config.
Enable Anonymous Access or SSO
The Grafana instance must allow anonymous access for the panel, OR the employee's BizFirstAI SSO session must be shared with Grafana (configured by your platform admin).
Widget Config JSON
// MetricsTile widget configuration
{
"id": "w-metrics-1",
"type": "MetricsTile",
"col": 0, "row": 1,
"w": 2, "h": 1,
"config": {
"grafanaUrl": "https://grafana.acme.com/d-solo/abc123/approval-metrics?orgId=1&panelId=4&from=now-30d&to=now&theme=dark",
"title": "Approval Rate (30 days)",
"height": 220
}
}The Grafana URL must be from a domain in the WorkDesk Content Security Policy allowlist. Ask your IT admin to add your Grafana domain to the CSP. Also ensure Grafana is served via HTTPS — HTTP iframes are blocked by modern browsers.