# Workshop Grafana To Elastic

> Workshop skill for metrics adoption on Elastic Observability Serverless (existing customers): bulk-convert Grafana/PromQL metric dashboard JSON into Kibana dashboards and rules via grafana-migrate; pair with Elastic Agent Skills for refinement.

- Skill: `elastic/workshop-grafana-to-elastic` (Agent Skill)
- Install (CLI): `npx skillmds@latest add elastic/workshop-grafana-to-elastic`
- Raw SKILL.md: https://api.skillmd.com/api/skills/elastic/workshop-grafana-to-elastic/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: elastic (https://skillmd.com/u/elastic)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/elastic/workshop-grafana-to-elastic

---


# Adopt PromQL metric views → Elastic (workshop)

## When to use

**Metrics adoption** practice for existing Elastic customers: **Grafana**/PromQL exports in `assets/grafana/` (**20** dashboards)
and **`assets/grafana/alerts/`** (unified alert rules for **`--fetch-alerts`**)
→ **[observability-migration-platform](https://github.com/elastic/observability-migration-platform)** **`grafana-migrate`**
→ **`build/mig-grafana/`** + Kibana upload (**`--native-promql`**), then **`tools/publish_grafana_alert_drafts_kibana.py`** for **Rules**.

**Telemetry:** OpenTelemetry SDK → Grafana Alloy → Elastic **mOTLP**. Restart: **`./scripts/start_workshop_otel.sh`**.

## Run (Instruqt)

```bash
bash /root/workshop/scripts/migrate_grafana_dashboards_to_serverless.sh
```

Waits for OTLP (or starts **`start_workshop_otel.sh`**), runs **`grafana-migrate`** with **`--upload --ensure-data-views --fetch-alerts`**, then publishes rules. Output: **`build/mig-grafana/dashboards/yaml/`** (or **`yaml/`**), **`dashboards/migration_report.json`**, **`alerts/alert_comparison_results.json`** (legacy flat paths still work).

Set **`WORKSHOP_MIG_ES_VALIDATE=1`** to add live ES\|QL validation before upload.

## Optional — laptop + Cursor

1. Clone workshop repo; **`./scripts/install_workshop_mig_to_kbn.sh`**
2. On VM: `grep -E '^export (KIBANA_URL|ES_URL|ES_API_KEY)=' ~/.bashrc` — paste into laptop terminal
3. Run the same migrate script from repo root, or invoke **`grafana-migrate`** directly (see **`scripts/migrate_grafana_dashboards_to_serverless.sh`**)

## Safety

- Never commit API keys.
- Validate panels against **real** metric names and labels in your Serverless project.