Using Grafana as an External Read Platform
Mirox provisions a ready-to-use Grafana for your data and connects it for you, so you can open a full charting workspace for any plant in one click — no separate Grafana login, install, or data-source setup. This guide walks you through reaching Grafana and reading your data; for what the embedding does behind the scenes, see Graph Visualization.
When to Use Grafana
Use Grafana when you want to explore the raw measurements behind the headline numbers — power curves, energy counters, weather inputs, and component-level signals — at whatever time range and resolution you choose.
- For computed performance roll-ups (production, losses, availability, specific yield), use the in-platform KPI views instead — Grafana plots the raw series, not pre-aggregated KPIs.
- To pull data out as CSV or JSON for spreadsheets and reports, use the Metrics Export API.
- To query or build your own calculated series programmatically, use MiroxQL or the export API.
Reads the Raw Metrics
The provisioned Grafana runs on the same raw collected metrics the platform records from your plants — high-frequency, multi-dimensional series — not the cleaned, daily-aggregated export metrics. That is exactly why it is the right tool for inspecting a signal in detail.
Where Grafana Is Provisioned
Grafana is provisioned per portfolio. When you create a portfolio, its dashboards are set up automatically and become reachable straight away — you do not wait for a background sync, and you do not configure a data source.
Each plant you have access to is reachable through its portfolio's dashboard, scoped to that plant. You only ever see charts for the plants your role grants you; visibility follows the same permission rules as the rest of the platform.
Available in Production
The Grafana link is active in the production environment. If you are working in a non-production environment, the link is shown but disabled.
Opening Grafana for a Plant
Grafana opens from the plant's navigation, scoped to the plant you have selected.
- Open the plant you want to chart.
Open in Mirox: service.mirox.io/#/monitor/solar/0/production - In the Site section of the sidebar, click Grafana.
- Grafana opens in a new browser tab, already signed in through your Mirox session and already showing the plant's overview dashboard.
No Second Login
Your Mirox session carries through to Grafana — there is no separate username, password, server URL, or token to enter before you can chart a plant.
Reading Your Data
The dashboard opens on the plant's overview view and gives you the standard Grafana toolkit applied to your plant metrics:
- Pick a time range — choose any window, then zoom and pan to the moment of interest.
- Adjust the resolution — view fine-grained raw samples for a power curve or coarser aggregates for long-term trends.
- Read exact values — hover or click a series to read the value at a point in time.
- Compare signals — plot metrics with different units (for example power against irradiance) together.
The dashboard arrives pre-scoped to the plant you opened it for, so production and the key signals for that installation are already in view.
Build Your Own Panels
Because these are standard Grafana dashboards, you can also add panels, change time ranges, and use Grafana's native tools on top of the provisioned views. The full set of purpose-built renewable-energy dashboards, and the trade-offs of using standard Grafana, are covered in Graph Visualization.
Distinction From Related Surfaces
It is easy to confuse the places metric data shows up in Mirox. Each serves a different need:
| Surface | What it shows | When to use it |
|---|---|---|
| Provisioned Grafana | Raw and aggregated time-series in interactive charts, pre-connected to your plants | Investigating a signal in detail inside Mirox, with nothing to set up |
| MiroxQL | The same raw metrics, queried and combined into your own calculated series | Programmatic or custom queries against your data |
| Metrics Export API | Cleaned, daily-aggregated metrics as CSV or JSON | Pulling data out for spreadsheets, reports, or external tools |
Related Documentation
- Graph Visualization — how the embedded Grafana surface works and which dashboards are provided
- Metrics Export API — export-ready, aggregated metrics for reporting
- MiroxQL Query Language — query your raw data and define custom calculated metrics