Migrating to the Metric Export
The Metric Export replaces four separate exports — templates, daily metrics, raw time series and component time series — with one export on one metric collection. This guide is for everyone who has a workbook, a script or a bookmark built on the previous exports.
Nothing Has to Be Migrated
Every link of the previous exports keeps working and keeps delivering the same columns. They have no removal date. Move a link when you want what the Metric Export adds: a free time range at every step, plant local time, per sensor, turbine and battery level, and the metrics of your organization. The previous links are described in the Legacy Export API.
What Stays
- The previous links, their parameters, their metric ids and their columns.
- The five previous system templates
CAFE0000CAFE,CAFE0001CAFE,CAFE0002CAFE,CAFE0003CAFEandABCD12340001, and the templates your organization created. - The plant information and the event export.
- Your API tokens. A token of the group Metric Export — called Reporting before — reads the previous and the new links alike.
- The separators, the decimal mark, the date format and the language parameter, with the same defaults.
What Changes
| Topic | Previous exports | Metric Export |
|---|---|---|
| Links | four routes, one per kind of export | GET /api/v1/export/series, and GET /api/v1/export/series/template/{uid} for templates |
| Metric ids | energy_grid_daily, raw_grid_power, comp_raw_inverter_energy_ac | one id per metric at every step: plant.grid_feedin, plant.grid_power, inverter.ac |
| Names | the names of the previous export, such as "Energy Production" | the names the reports use, such as "Grid feed-in" |
| Units of energy | kWh in the daily export, Wh in the raw exports | kWh throughout |
| Missing values | 0 in the template and daily export | an empty cell. "No data" and "zero" can be told apart. empty=zero writes 0. |
| Time zone | days and timestamps in UTC | the local time of the plant, with a UTC offset column at steps below a day. tz=utc keeps UTC. |
| Time range | calendar periods in the daily export, a free range in the raw exports | a free range, calendar periods and presets such as previous_month, at every step |
| Steps | daily to yearly, or 5m, 15m, 1h, 1d | 1min, 5min, 15min, 1h, day, week, month, quarter, year |
| Power | offered at every step as an average | offered at 15 minutes or finer. For days and months use the energy metric. |
| Values | value=plain, start_at_zero, use_delta | values=native, cumulative, delta; delta for energy only |
| Components | one component type per request, one plant | any component metrics together, several plants; one column per component |
| Extra columns | "Days in Month" at monthly, "Calendar Week" at weekly resolution | none. Every row is stamped with the start of its interval. |
| Language | English unless language is set | the same; the names follow the metric collection in six languages |
| Too large | 400 with a text | 400 over_budget with the step and the range that would fit |
| Errors | a text | a stable code with params and hint |
Numbers That Can Differ
Most metrics deliver the same numbers as before. Where they differ, the mapping below marks the metric approximate and names the difference. Three differences are general:
- Days are local days. A daily value of the previous export covered a UTC day. The Metric Export covers the local day of the plant, so a day's energy can differ by what the plant produced between local and UTC midnight. The totals over a month agree, apart from the first and the last hours.
- Several plants combined. The Metric Export adds energy and power, averages levels such as temperatures, and recomputes ratios from the plants' totals. States and status codes are shown per plant.
- Battery state of charge and state of health are weighted by the capacity of the containers. A large container counts more than a small one.
Parameters, Previous and New
| Previous | Metric Export |
|---|---|
metrics=energy_grid_daily | metrics=plant.grid_feedin — see the id mapping |
resolution=daily / weekly / monthly / quarterly / yearly | step=day / week / month / quarter / year |
step=5m / 15m / 1h / 1d | step=5min / 15min / 1h / day |
value=use_delta | values=delta |
value=start_at_zero | values=cumulative |
value=plain | for energy values=cumulative, otherwise values=native. The meter reading itself is not exported. |
year, quarter, month, week, day | unchanged |
full_week=true | not needed; a week always covers Monday to Sunday |
start, end with date and time | unchanged. A date alone is enough; an end that is a date includes that day. |
park, portfolio, multi_park_agg | unchanged |
component_type=inverter&components=1043,1044 | components=inverter:1043,inverter:1044 |
page, limit of the component export | lane_page, lane_limit |
multi_component_agg=split | always one column per component |
multi_component_agg=merge | not offered. Use the plant metric, for example plant.inverter_ac_sum. |
separator_csv, separator_decimal, datetime_format, language | unchanged |
| — | new: window, tz, header, empty, offset_column, precision, format=json |
Moving One Link
- Open the previous link's metrics on Data Export ▸ Metrics. A bookmark of the previous Raw Data tab does this by itself; otherwise search the picker for the previous id.
- Choose plants, time range and step, and check the preview against the file you have.
- Under Column headers, choose Ids (for scripts) if a script or a workbook reads the file.
- Copy the API URL and replace the previous link.
- In the script or workbook, adjust the column names and, where the mapping says so, the unit.
You can also send a previous id to the new link unchanged. It is translated, and a note names the metric that answered — see Ids of the previous export. This is a quick way to compare; for a lasting link use the new id.
System Templates
Each previous system template has a successor with a new id. The previous ids keep delivering the previous columns on the previous link.
| Previous template | Previous id | New template | New id |
|---|---|---|---|
| Standard Export v1 | CAFE0000CAFE | Standard Export | CAFE1000CAFE |
| Extended Export v1 | CAFE0001CAFE | Extended Export | CAFE1001CAFE |
| Extended Export v2 | CAFE0002CAFE | Extended Export (inverter availability) | CAFE1002CAFE |
| Energy Availability Export | CAFE0003CAFE | Energy Availability Export | CAFE1003CAFE |
| Report Technical v1 | ABCD12340001 | Report Technical | ABCD12340002 |
Three further templates are new: Wind Turbines CAFE1010CAFE, Battery Storage CAFE1020CAFE and Irradiance Sensors CAFE1030CAFE.
What differs from the previous templates:
- The successors export days by default, and offer
day,week,month,quarterandyear. The first four also offer15minand1h. - Columns without a counterpart are left out. They are named below for each template.
- The columns "Days in Month" and "Calendar Week" do not exist.
- The template Wind Turbines has no power column, because power is a 15-minute metric. Export the turbine power on the Metrics tab.
Standard Export CAFE1000CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Logger availability (park) | availability.logger_park | % | native | availability_technical |
| Grid feed-in | plant.grid_feedin | kWh | delta | energy_grid_daily |
| Shutdown loss, direct marketer | plant.shutdown_external | kWh | delta | energy_shutdown_external_daily |
| Shutdown loss, grid operator | plant.shutdown_grid | kWh | delta | energy_shutdown_grid_daily |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | gti_sensor_daily |
| Plant-plane radiation, weather model | plant.rad_weather | kWh/m² | delta | gti_weather_daily |
| Sun hours | availability.sunhours | h | native | sunhours_daily |
Left out: availability_data, availability_sensor, energy_report, gti_report
Extended Export CAFE1001CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Logger availability (park) | availability.logger_park | % | native | availability_technical |
| Grid feed-in | plant.grid_feedin | kWh | delta | energy_grid_daily |
| Shutdown loss, direct marketer | plant.shutdown_external | kWh | delta | energy_shutdown_external_daily |
| Shutdown loss, grid operator | plant.shutdown_grid | kWh | delta | energy_shutdown_grid_daily |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | gti_sensor_daily |
| Plant-plane radiation, weather model | plant.rad_weather | kWh/m² | delta | gti_weather_daily |
| Sun hours | availability.sunhours | h | native | sunhours_daily |
Left out: availability_data, availability_sensor, energy_report, gti_report, energy_radiation_daily
Extended Export (Inverter Availability) CAFE1002CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Logger availability (park) | availability.logger_park | % | native | availability_technical |
| Grid feed-in | plant.grid_feedin | kWh | delta | energy_grid_daily |
| Shutdown loss, direct marketer | plant.shutdown_external | kWh | delta | energy_shutdown_external_daily |
| Shutdown loss, grid operator | plant.shutdown_grid | kWh | delta | energy_shutdown_grid_daily |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | gti_sensor_daily |
| Plant-plane radiation, weather model | plant.rad_weather | kWh/m² | delta | gti_weather_daily |
| Sun hours | availability.sunhours | h | native | sunhours_daily |
| Inverter availability (park) | availability.inverter_park | % | native | availability_inverter |
Left out: availability_data, availability_sensor, energy_report, gti_report, energy_radiation_daily
Energy Availability Export CAFE1003CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Logger availability (park) | availability.logger_park | % | native | availability_technical |
| Inverter availability (park) | availability.inverter_park | % | native | availability_inverter |
| Grid feed-in | plant.grid_feedin | kWh | delta | energy_grid_daily |
| Shutdown loss, direct marketer | plant.shutdown_external | kWh | delta | energy_shutdown_external_daily |
| Shutdown loss, grid operator | plant.shutdown_grid | kWh | delta | energy_shutdown_grid_daily |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | gti_sensor_daily |
| Plant-plane radiation, weather model | plant.rad_weather | kWh/m² | delta | gti_weather_daily |
| Sun hours | availability.sunhours | h | native | sunhours_daily |
Left out: availability_data, availability_sensor, availability_energy, energy_report, gti_report
Report Technical ABCD12340002
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Grid feed-in | plant.grid_feedin | kWh | delta | energy_grid_daily |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | gti_sensor_daily |
| Plant-plane radiation, weather model | plant.rad_weather | kWh/m² | delta | gti_weather_daily |
| Sun hours | availability.sunhours | h | native | sunhours_daily |
| Inverter availability (park) | availability.inverter_park | % | native | availability_inverter |
| Shutdown loss, grid operator | plant.shutdown_grid | kWh | delta | energy_shutdown_grid_daily |
| Shutdown loss, direct marketer | plant.shutdown_external | kWh | delta | energy_shutdown_external_daily |
| Expected production (weather model) | plant.expected_weather | kWh | delta | production_target_weather |
| Expected production (pyranometer) | plant.expected_pyranometer | kWh | delta | production_target_sensor |
| Performance ratio (weather model) | plant.pr_weather | % | native | pr_weather |
| Performance ratio (pyranometer) | plant.pr_pyranometer | % | native | pr_sensor |
| Specific yield | plant.specific_yield | kWh/kWp | native | specific_yield |
Left out: energy_radiation_daily, availability_energy, availability_data, availability_sensor, energy_report, gti_report, gti_report_eff, pr_report, irradiance_actual, irradiance_weather_usage_percent, irradiance_sensor_weather_diff_percent, production_target_actual, production_target_actual_corrected, pr_actual, pr_actual_corrected, report_pr_actual_corrected, non_compensable_losses
The columns left out of Report Technical are calculated columns and the targets of the yield report. ABCD12340001 keeps delivering them.
Wind Turbines CAFE1010CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Turbine production, sum | plant.turbine_energy_sum | kWh | delta | — |
| Production per turbine | turbine.energy_ac | kWh | delta | — |
| Nacelle wind speed per turbine | turbine.wind_speed | m/s | native | — |
| Time running per turbine | turbine.time_running | s | native | — |
| Curtailment energy, grid operator (park's method) | plant.curtailment_grid_settled | kWh | delta | — |
Battery Storage CAFE1020CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Charged energy (AC) | battery.energy_in_ac | kWh | delta | — |
| Discharged energy (AC) | battery.energy_out_ac | kWh | delta | — |
| State of charge | battery.soc | % | native | — |
| State of health | battery.soh | % | native | — |
| Cycle count | battery.cycle_count | — | native | — |
Irradiance Sensors CAFE1030CAFE
| Column | Metric | Unit | Values | Previous id |
|---|---|---|---|---|
| Irradiance per sensor | sensor.irradiance | W/m² | native | — |
| Irradiation per sensor | sensor.irradiation | kWh/m² | delta | — |
| Plant-plane radiation, pyranometer | plant.rad_pyranometer | kWh/m² | delta | — |
Your Own Templates
A template your organization created before the Metric Export is a Legacy template. Its link keeps working. Convert to new template on the Templates tab creates a new template from it and leaves the legacy template as it is — see Legacy templates and conversion. Columns built on a MiroxQL formula of your organization have no counterpart; define the figure under Metrics and add it to the new template.
Id Mapping
The tables list every id of the previous exports with the metric that answers for it.
- Values is the value mode that comes closest to the previous number. It is the mode used when you send the previous id to the new link.
- Match is exact when the number is the same, and approximate when it is the same quantity read in a better way. Difference says what differs.
- Unit shows a change as
Wh → kWh.
Two Ids That Are Easy to Confuse
string.power and gak.power are energies in kWh: the energy per string and per combiner box. The power metrics are string.dc_power and gak.dc_power.
Daily Metrics
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
energy_grid_daily | Energy Production | plant.grid_feedin | Grid feed-in | kWh | delta | exact | Days follow the plant's local calendar instead of UTC |
energy_ac_daily | AC Production | plant.inverter_ac_sum | Inverter AC production, sum | kWh | delta | approximate | The sum of the inverters instead of the logger's AC total |
energy_inverter_daily | Inverter Production | plant.inverter_ac_sum | Inverter AC production, sum | kWh | delta | exact | Days follow the plant's local calendar instead of UTC |
gti_sensor_daily | GTI Sensor | plant.rad_pyranometer | Plant-plane radiation, pyranometer | kWh/m² | delta | approximate | The cleaned plant value instead of the plain average of the sensors |
gti_weather_daily | GTI Weather | plant.rad_weather | Plant-plane radiation, weather model | kWh/m² | delta | approximate | The plant's weather-model irradiation instead of the forecast values |
sunhours_daily | Sunhours | availability.sunhours | Sun hours | h | native | exact | — |
temperature_ambient_avg | Ambient Temperature | plant.temperature_ambient | Ambient temperature, site sensor | °C | native | exact | — |
temperature_module_avg | Module Temperature | plant.temperature_module | Module temperature, site sensor | °C | native | exact | — |
wind_speed_avg | Wind Speed | plant.wind_speed | Wind speed, site sensor | m/s | native | exact | — |
wind_direction_avg | Wind Direction | plant.wind_direction | Wind direction, site sensor | ° | native | exact | — |
humidity_avg | Humidity | plant.humidity | Humidity, site sensor | % | native | exact | — |
availability_inverter | Availability Inverter | availability.inverter_park | Inverter availability (park) | % | native | approximate | The share of daylight intervals in which the inverters produced |
availability_technical | Availability Technical | availability.logger_park | Logger availability (park) | % | native | approximate | The share of intervals in which the loggers reported |
battery_energy_in_daily | Battery Energy Charged | battery.energy_in | Charged energy | kWh | delta | approximate | Falls back to further sources where the containers report no DC energy |
battery_energy_out_daily | Battery Energy Discharged | battery.energy_out | Discharged energy | kWh | delta | approximate | Falls back to further sources where the containers report no DC energy |
battery_soc_avg | Battery State of Charge | battery.soc | State of charge | % | native | approximate | Weighted by the capacity of the containers |
battery_soh_avg | Battery State of Health | battery.soh | State of health | % | native | approximate | Weighted by the capacity of the containers |
battery_energy_charged_avg | Battery Stored Energy | battery.energy_stored | Stored energy | kWh | native | exact | — |
temperature_battery_avg | Battery Temperature | battery.temperature | Battery temperature | °C | native | exact | — |
energy_inverter_dc_daily | Inverter DC Production | inverter.dc | DC input | kWh | delta | approximate | One column per component instead of one plant value |
energy_gak_daily | GAK Production | gak.energy_sum | DC energy, sum of combiner boxes | kWh | delta | exact | — |
energy_string_daily | String Production | string.energy_sum | DC energy, sum of strings | kWh | delta | exact | — |
energy_grid_consumed_daily | Grid Consumption | plant.grid_consumption | Grid consumption | kWh | delta | exact | — |
energy_grid_out_daily | Grid Feed-out | plant.grid_energy_out | Grid feed-out | kWh | delta | exact | — |
energy_inverter_consumed_daily | Inverter Consumption | inverter.consumed | Own consumption per inverter | kWh | delta | approximate | One column per component instead of one plant value |
energy_grid_reactive_daily | Grid Reactive Energy | plant.grid_reactive | Grid reactive energy | kVArh | delta | exact | — |
energy_grid_apparent_daily | Grid Apparent Energy | plant.grid_apparent | Grid apparent energy | kVAh | delta | exact | — |
energy_shutdown_grid_daily | Energy Shutdown by grid | plant.shutdown_grid | Shutdown loss, grid operator | kWh | delta | exact | Days follow the plant's local calendar instead of UTC |
energy_shutdown_external_daily | Energy Shutdown by external | plant.shutdown_external | Shutdown loss, direct marketer | kWh | delta | exact | Days follow the plant's local calendar instead of UTC |
energy_loss_daily | Curtailment Losses | plant.shutdown_total | Shutdown loss, total | kWh | delta | exact | Days follow the plant's local calendar instead of UTC |
energy_grid_simulation_daily | Grid Simulation Energy | plant.twin_grid_simulation | Twin simulated energy at the grid connection | kWh | delta | exact | — |
energy_grid_loss_daily | Technical Loss Energy | plant.twin_grid_loss | Twin loss energy at the grid connection | kWh | delta | exact | — |
temperature_inverter_avg | Inverter Temperature | inverter.temperature | Temperature per inverter | °C | native | approximate | One column per component instead of one plant value |
temperature_gak_avg | GAK Temperature | gak.temperature | Temperature per combiner box | °C | native | approximate | One column per component instead of one plant value |
frequency_avg | Grid Frequency | inverter.frequency | Grid frequency | Hz | native | approximate | One column per component instead of one plant value |
power_factor_avg | Power Factor | inverter.power_factor | Power factor | cos φ | native | approximate | One column per component instead of one plant value |
irradiation_energy_daily | Irradiation Energy | sensor.irradiation | Irradiation per sensor | kWh/m² | delta | approximate | One column per sensor instead of their average |
energy_inverter_simulation_daily | Inverter Simulation Energy | inverter.twin_simulation | Twin simulated energy per inverter | kWh | delta | approximate | One column per component instead of one plant value |
energy_inverter_loss_daily | Inverter Loss Energy | inverter.twin_loss | Twin loss energy per inverter | kWh | delta | approximate | One column per component instead of one plant value |
energy_gak_simulation_daily | GAK Simulation Energy | gak.twin_simulation | Twin simulated energy per combiner box | kWh | delta | approximate | One column per component instead of one plant value |
energy_gak_loss_daily | GAK Loss Energy | gak.twin_loss | Twin loss energy per combiner box | kWh | delta | approximate | One column per component instead of one plant value |
energy_string_simulation_daily | String Simulation Energy | string.twin_simulation | Twin simulated energy per string | kWh | delta | approximate | One column per component instead of one plant value |
energy_string_loss_daily | String Loss Energy | string.twin_loss | Twin loss energy per string | kWh | delta | approximate | One column per component instead of one plant value |
Raw Metrics: Grid and Plant Power
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
raw_grid_energy_total | Energy Production | plant.grid_feedin | Grid feed-in | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_energy_out_total | Grid Consumption | plant.grid_consumption | Grid consumption | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_power | Grid Power | plant.grid_power | Grid feed-in power | W | native | exact | — |
raw_grid_power_apparent | Grid Power Apparent | plant.grid_power_apparent | Grid apparent power | VA | native | exact | — |
raw_grid_power_reactive | Grid Power Reactive | plant.grid_power_reactive | Grid reactive power | VAr → var | native | exact | — |
raw_grid_energy_out_total_feed | Grid Feed-out | plant.grid_energy_out | Grid feed-out | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_energy_total_reactive | Grid Reactive Energy | plant.grid_reactive | Grid reactive energy | VArh → kVArh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_energy_total_apparent | Grid Apparent Energy | plant.grid_apparent | Grid apparent energy | VAh → kVAh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_energy_total_reactive_capacitive | Grid Energy Reactive Capacitive Total | plant.grid_reactive_capacitive | Grid reactive energy, capacitive | VArh → kVArh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_energy_total_reactive_inductive | Grid Energy Reactive Inductive Total | plant.grid_reactive_inductive | Grid reactive energy, inductive | VArh → kVArh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_energy_ac_total | AC Production | plant.inverter_ac_sum | Inverter AC production, sum | Wh → kWh | cumulative | approximate | The sum of the inverters instead of the logger's AC total |
raw_power_ac | AC Power | plant.inverter_power_sum | Inverter AC power, sum | W | native | approximate | The sum of the inverters instead of the logger's AC power |
raw_power_ac_reactive | AC Power Reactive | inverter.reactive | Reactive power per inverter | VAr → var | native | approximate | One column per inverter instead of the logger's plant total |
raw_frequency_grid | Grid Frequency Deprecated | plant.frequency_grid | Grid frequency | Hz | native | exact | — |
raw_grid_power_simulation | Grid Power Simulation | plant.twin_grid_simulation_power | Twin simulated power at the grid connection | W | native | exact | — |
raw_grid_energy_total_simulation | Grid Simulation Energy | plant.twin_grid_simulation | Twin simulated energy at the grid connection | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_power_loss_twin | Grid Power Loss Twin | plant.twin_grid_loss_power | Twin loss power at the grid connection | W | native | exact | — |
raw_grid_energy_total_loss | Technical Loss Energy | plant.twin_grid_loss | Twin loss energy at the grid connection | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_grid_prrc | Grid PRRC | plant.twin_grid_prrc | Twin PRRC at the grid connection | % | native | approximate | A percentage instead of a factor |
raw_grid_sim_err | Grid Simulation Error | plant.twin_grid_sim_err | Twin simulation error at the grid connection | % | native | approximate | A percentage instead of a factor |
Raw Metrics: Inverters, Combiner Boxes and Strings
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
raw_inverter_energy_ac_total | Inverter Production | plant.inverter_ac_sum | Inverter AC production, sum | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_inverter_energy_dc_total | Inverter DC Production | inverter.dc | DC input | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_inverter_power_ac | Inverter AC Power | plant.inverter_power_sum | Inverter AC power, sum | W | native | approximate | The sum of the inverters |
raw_inverter_energy_consumed_total | Inverter Consumption | inverter.consumed | Own consumption per inverter | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_inverter_power_dc | Inverter DC Power | inverter.dc_power | DC power per inverter | W | native | approximate | One column per component instead of one plant value |
raw_inverter_power_reactive | Inverter Reactive Power | inverter.reactive | Reactive power per inverter | VAr → var | native | approximate | One column per component instead of one plant value |
raw_inverter_power_limit | Inverter Power Limit | inverter.limit | Power limit per inverter | W | native | approximate | One column per component instead of one plant value |
raw_inverter_voltage_ac | Inverter AC Voltage | inverter.voltage_ac | AC voltage per inverter | V | native | approximate | One column per component instead of one plant value |
raw_inverter_voltage_dc | Inverter DC Voltage | inverter.voltage_dc | DC voltage per inverter | V | native | approximate | One column per component instead of one plant value |
raw_inverter_current_ac | Inverter AC Current | inverter.current_ac | AC current per inverter | A | native | approximate | One column per component instead of one plant value |
raw_inverter_current_dc | Inverter DC Current | inverter.current_dc | DC current per inverter | A | native | approximate | One column per component instead of one plant value |
raw_inverter_temperature | Inverter Temperature | inverter.temperature | Temperature per inverter | °C | native | approximate | One column per component instead of one plant value |
raw_inverter_frequency | Grid Frequency | inverter.frequency | Grid frequency | Hz | native | approximate | One column per component instead of one plant value |
raw_inverter_cos | Power Factor | inverter.power_factor | Power factor | cos φ | native | approximate | One column per component instead of one plant value |
raw_inverter_max_power | Inverter Max Power | inverter.max_power | Maximum power per inverter | W | native | approximate | One column per component instead of one plant value |
raw_inverter_resistance_iso | Inverter Isolation Resistance | inverter.insulation | Insulation resistance per inverter | kΩ → Ω | native | approximate | One column per component instead of one plant value |
raw_inverter_voltage_ac_phase_l1_l2 | Inverter AC Voltage L1-L2 | inverter.voltage_phases | Phase voltages per inverter | V | native | approximate | One column per inverter and phase pair |
raw_inverter_voltage_ac_phase_l2_l3 | Inverter AC Voltage L2-L3 | inverter.voltage_phases | Phase voltages per inverter | V | native | approximate | One column per inverter and phase pair |
raw_inverter_voltage_ac_phase_l3_l1 | Inverter AC Voltage L3-L1 | inverter.voltage_phases | Phase voltages per inverter | V | native | approximate | One column per inverter and phase pair |
raw_inverter_current_ac_phase_l1 | Inverter AC Current L1 | inverter.current_phases | Phase currents per inverter | A | native | approximate | One column per inverter and phase |
raw_inverter_current_ac_phase_l2 | Inverter AC Current L2 | inverter.current_phases | Phase currents per inverter | A | native | approximate | One column per inverter and phase |
raw_inverter_current_ac_phase_l3 | Inverter AC Current L3 | inverter.current_phases | Phase currents per inverter | A | native | approximate | One column per inverter and phase |
raw_gak_energy_total | GAK Production | gak.energy_sum | DC energy, sum of combiner boxes | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_gak_power | GAK Power | gak.power_sum | DC power, sum of combiner boxes | W | native | exact | — |
raw_gak_voltage | GAK Voltage | gak.voltage | Voltage per combiner box | V | native | approximate | One column per component instead of one plant value |
raw_gak_current | GAK Current | gak.current | Current per combiner box | A | native | approximate | One column per component instead of one plant value |
raw_gak_temperature | GAK Temperature | gak.temperature | Temperature per combiner box | °C | native | approximate | One column per component instead of one plant value |
raw_string_energy_total | String Production | string.energy_sum | DC energy, sum of strings | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_string_power | String Power | string.power_sum | DC power, sum of strings | W | native | exact | — |
raw_string_voltage | String Voltage | string.voltage | Voltage per string | V | native | approximate | One column per component instead of one plant value |
raw_string_current | String Current | string.current | Current per string | A | native | approximate | One column per component instead of one plant value |
raw_string_shadow_factor | String Shadow Factor | string.shadow_factor | Shadow factor per string | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_inverter_power_ac_simulation | Inverter AC Power Simulation | inverter.twin_simulation_power | Twin simulated power per inverter | W | native | approximate | One column per component instead of one plant value |
raw_gak_power_simulation | GAK Power Simulation | gak.twin_simulation_power | Twin simulated power per combiner box | W | native | approximate | One column per component instead of one plant value |
raw_string_power_simulation | String Power Simulation | string.twin_simulation_power | Twin simulated power per string | W | native | approximate | One column per component instead of one plant value |
raw_inverter_energy_ac_total_simulation | Inverter Simulation Energy | inverter.twin_simulation | Twin simulated energy per inverter | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_gak_energy_total_simulation | GAK Simulation Energy | gak.twin_simulation | Twin simulated energy per combiner box | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_string_energy_total_simulation | String Simulation Energy | string.twin_simulation | Twin simulated energy per string | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_inverter_power_loss_twin | Inverter Power Loss Twin | inverter.twin_loss_power | Twin loss power per inverter | W | native | approximate | One column per component instead of one plant value |
raw_gak_power_loss_twin | GAK Power Loss Twin | gak.twin_loss_power | Twin loss power per combiner box | W | native | approximate | One column per component instead of one plant value |
raw_string_power_loss_twin | String Power Loss Twin | string.twin_loss_power | Twin loss power per string | W | native | approximate | One column per component instead of one plant value |
raw_inverter_energy_total_loss | Inverter Loss Energy | inverter.twin_loss | Twin loss energy per inverter | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_gak_energy_total_loss | GAK Loss Energy | gak.twin_loss | Twin loss energy per combiner box | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_string_energy_total_loss | String Loss Energy | string.twin_loss | Twin loss energy per string | Wh → kWh | cumulative | approximate | One column per component instead of one plant value |
raw_inverter_prrc | Inverter PRRC | inverter.twin_prrc | Twin PRRC per inverter | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_inverter_sim_err | Inverter Simulation Error | inverter.twin_sim_err | Twin simulation error per inverter | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_gak_prrc | GAK PRRC | gak.twin_prrc | Twin PRRC per combiner box | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_gak_sim_err | GAK Simulation Error | gak.twin_sim_err | Twin simulation error per combiner box | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_string_prrc | String PRRC | string.twin_prrc | Twin PRRC per string | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
raw_string_sim_err | String Simulation Error | string.twin_sim_err | Twin simulation error per string | % | native | approximate | One column per component instead of one plant value; a percentage instead of a factor |
Raw Metrics: Battery
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
raw_battery_environment_temperature | Battery Ambient Temperature | battery.environment_temperature | Battery ambient temperature | °C | native | exact | — |
raw_battery_environment_humidity | Battery Ambient Humidity | battery.environment_humidity | Battery ambient humidity | % | native | exact | — |
raw_battery_box_power_dc | Battery Box Power DC | battery_box.power_dc | DC power per container | W | native | approximate | One column per component instead of one plant value |
raw_battery_box_voltage_dc | Battery Box Voltage DC | battery_box.voltage_dc | DC voltage per container | V | native | approximate | One column per component instead of one plant value |
raw_battery_box_current_dc | Battery Box Current DC | battery_box.current_dc | DC current per container | A | native | approximate | One column per component instead of one plant value |
raw_battery_box_power_ac | Battery Box Power AC | battery_box.power_ac | AC power per container | W | native | approximate | One column per component instead of one plant value |
raw_battery_box_power_ac_reactive | Battery Box Reactive Power AC | battery_box.power_reactive | Reactive power per container | VAr → var | native | approximate | One column per component instead of one plant value |
raw_battery_box_voltage_ac | Battery Box Voltage AC | battery_box.voltage_ac | AC voltage per container | V | native | approximate | One column per component instead of one plant value |
raw_battery_box_current_ac | Battery Box Current AC | battery_box.current_ac | AC current per container | A | native | approximate | One column per component instead of one plant value |
raw_battery_box_frequency | Battery Box Frequency | battery_box.frequency | AC frequency per container | Hz | native | approximate | One column per component instead of one plant value |
raw_battery_box_soc | Battery State of Charge | battery_box.soc | State of charge per container | % | native | approximate | One column per component instead of one plant value |
raw_battery_box_soh | Battery State of Health | battery_box.soh | State of health per container | % | native | approximate | One column per component instead of one plant value |
raw_battery_box_temperature | Battery Temperature | battery_box.temperature | Temperature per container | °C | native | approximate | One column per component instead of one plant value |
raw_battery_box_energy_nominal | Battery Nameplate Energy | battery_box.energy_nominal | Nominal energy per container | Wh → kWh | native | approximate | One column per component instead of one plant value |
raw_battery_box_energy_usable | Battery Usable Energy Max | battery_box.energy_usable | Usable energy per container | Wh → kWh | native | approximate | One column per component instead of one plant value |
raw_battery_box_energy_charged | Battery Currently Stored Energy | battery_box.energy_stored | Stored energy per container | Wh → kWh | native | approximate | One column per component instead of one plant value |
raw_battery_box_power_dc_in | Battery Charge Power | battery_box.power_dc | DC power per container | W | native | approximate | The signed DC power (+ = charging) instead of the charging part alone; one column per component instead of the plant sum |
raw_battery_box_power_dc_out | Battery Discharge Power | battery_box.power_dc | DC power per container | W | native | approximate | The signed DC power (+ = charging) instead of the discharging part alone; one column per component instead of the plant sum |
raw_battery_storage_power_dc_in | Battery Storage Charge Power | battery_storage.power_dc | DC power per rack | W | native | approximate | The signed DC power (+ = charging) instead of the charging part alone; one column per component instead of the plant sum |
raw_battery_storage_power_dc_out | Battery Storage Discharge Power | battery_storage.power_dc | DC power per rack | W | native | approximate | The signed DC power (+ = charging) instead of the discharging part alone; one column per component instead of the plant sum |
raw_battery_box_energy_dc_in_total | Battery Charge Energy | battery_box.energy_dc_in | DC energy charged per container | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_box_energy_dc_out_total | Battery Discharge Energy | battery_box.energy_dc_out | DC energy discharged per container | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_box_energy_ac_in_total | Battery Box AC Charge Energy | battery_box.energy_ac_in | AC energy charged per container | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_box_energy_ac_out_total | Battery Box AC Discharge Energy | battery_box.energy_ac_out | AC energy discharged per container | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_storage_soc_avg | Battery Storage SoC | battery_storage.soc | State of charge per rack | % | native | approximate | One column per component instead of one plant value |
raw_battery_storage_soh_avg | Battery Storage SoH | battery_storage.soh | State of health per rack | % | native | approximate | One column per component instead of one plant value |
raw_battery_storage_temperature_avg | Battery Storage Temperature | battery_storage.temperature | Temperature per rack | °C | native | approximate | One column per component instead of one plant value |
raw_battery_storage_energy_charged | Battery Storage Stored Energy | battery_storage.energy_stored | Stored energy per rack | Wh → kWh | native | approximate | One column per component instead of one plant value |
raw_battery_storage_cell_voltage_avg | Battery Storage Cell Voltage Sum | battery_storage.cell_voltage | Cell voltage sum per rack | V | native | approximate | One column per component instead of one plant value |
raw_battery_storage_comm_quality_avg | Battery Storage Comm Quality | battery_storage.comm_quality | Communication quality per rack | % | native | approximate | One column per component instead of one plant value |
raw_battery_storage_energy_dc_in_total | Battery Storage Charge Energy | battery_storage.energy_dc_in | DC energy charged per rack | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_storage_energy_dc_out_total | Battery Storage Discharge Energy | battery_storage.energy_dc_out | DC energy discharged per rack | Wh → kWh | cumulative | approximate | The previous value was the meter reading itself |
raw_battery_module_soc_avg | Battery Module SoC | battery_module.soc | State of charge per module | % | native | approximate | One column per component instead of one plant value |
raw_battery_module_soh_avg | Battery Module SoH | battery_module.soh | State of health per module | % | native | approximate | One column per component instead of one plant value |
raw_battery_module_temperature_avg | Battery Module Temperature | battery_module.temperature | Temperature per module | °C | native | approximate | One column per component instead of one plant value |
raw_battery_module_cell_voltage_avg | Battery Module Cell Voltage Sum | battery_module.cell_voltage | Cell voltage sum per module | V | native | approximate | One column per component instead of one plant value |
raw_battery_module_energy_charged | Battery Module Stored Energy | battery_module.energy_stored | Stored energy per module | Wh → kWh | native | approximate | One column per component instead of one plant value |
raw_battery_module_comm_quality_avg | Battery Module Comm Quality | battery_module.comm_quality | Communication quality per module | % | native | approximate | One column per component instead of one plant value |
raw_battery_cell_voltage_avg | Battery Cell Voltage Avg | battery_cell.voltage | Cell voltage per cell | V | native | approximate | One column per component instead of one plant value |
raw_battery_cell_voltage_min | Battery Cell Voltage Min | battery_box.cell_voltage_min | Lowest cell voltage per container | V | native | approximate | The lowest cell voltage each container reports, one column per container |
raw_battery_cell_voltage_max | Battery Cell Voltage Max | battery.cell_voltage_max | Highest cell voltage | V | native | approximate | The highest value the containers report |
raw_battery_cell_temperature_avg | Battery Cell Temperature Avg | battery_cell.temperature | Temperature per cell | °C | native | approximate | One column per component instead of one plant value |
raw_battery_cell_temperature_max | Battery Cell Temperature Max | battery.cell_temperature_max | Highest cell temperature | °C | native | approximate | The highest value the containers report |
raw_battery_setpoint_external | Battery Setpoint by External | battery.setpoints | Setpoints received | % | native | exact | — |
raw_battery_setpoint_external_w | Battery Setpoint by External (W) | battery.setpoint_external_w | Marketer setpoint (W) | W | native | exact | — |
raw_battery_setpoint_applied | Battery Setpoint (Applied) | battery.setpoint_applied | Applied setpoint (%) | % | native | exact | — |
raw_battery_setpoint_applied_w | Battery Setpoint (Applied, W) | battery.setpoint_applied_w | Applied setpoint (W) | W | native | exact | — |
raw_battery_max_power_charge_by_grid | Battery Charge Limit (Grid) | battery.max_power_charge_by_grid | Grid operator charge limit (%) | % | native | exact | — |
raw_battery_max_power_charge_by_grid_w | Battery Charge Limit (Grid, W) | battery.max_power_charge_by_grid_w | Grid operator charge limit (W) | W | native | exact | — |
raw_battery_max_power_discharge_by_grid | Battery Discharge Limit (Grid) | battery.max_power_discharge_by_grid | Grid operator discharge limit (%) | % | native | exact | — |
raw_battery_max_power_discharge_by_grid_w | Battery Discharge Limit (Grid, W) | battery.max_power_discharge_by_grid_w | Grid operator discharge limit (W) | W | native | exact | — |
raw_battery_setpoint_local_w | Battery Setpoint by Local | battery.setpoint_local_w | Local setpoint (W) | W | native | exact | — |
Raw Metrics: Limits, Curtailment, Sensors, Network and Alarms
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
raw_max_power_by_grid | Power Limit by Grid | plant.limit_grid | Power limit by grid operator | W → % | native | approximate | A percentage of the installed power |
raw_max_power_by_external | Power Limit by External | plant.limit_marketer | Power limit by direct marketer | W → % | native | approximate | The limit as the plant reports it, in percent or in watt |
raw_max_power_by_external_w | Power Limit by External | plant.limit_marketer | Power limit by direct marketer | W → % | native | approximate | The limit as the plant reports it, in percent or in watt |
raw_control_connection_grid | Grid Control Connection | infrastructure.control_connection_grid | Control connection, grid operator | — | native | exact | — |
raw_control_connection_external | External Control Connection | infrastructure.control_connection_external | Control connection, direct marketer | — | native | exact | — |
raw_control_interface_ready | Control Interface Ready | infrastructure.control_interface_ready | Control interface ready | — | native | exact | — |
raw_max_power_source | Max Power Source | plant.max_power_source | Active power limit source | — | native | exact | — |
raw_energy_shutdown_grid_total | Energy Shutdown by grid | plant.shutdown_grid | Shutdown loss, grid operator | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_energy_shutdown_external_total | Energy Shutdown by external | plant.shutdown_external | Shutdown loss, direct marketer | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_energy_shutdown_total | Energy Shutdown Total | plant.shutdown_total | Shutdown loss, total | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_energy_loss_total | Curtailment Losses | plant.shutdown_total | Shutdown loss, total | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_grid_pyranometer | Curtailment Grid by Pyranometer | plant.curtailment_grid_ref_pyranometer_power | Curtailment power, grid operator — pyranometer, unsettled | W | native | exact | — |
raw_curtailment_grid_satellite | Curtailment Grid by Satellite | plant.curtailment_grid_ref_satellite_power | Curtailment power, grid operator — satellite, unsettled | W | native | exact | — |
raw_curtailment_grid_weather | Curtailment Grid by Weather | plant.curtailment_grid_ref_weather_power | Curtailment power, grid operator — weather model, unsettled | W | native | exact | — |
raw_curtailment_grid_fixed | Curtailment Grid by Fixed | plant.curtailment_grid_ref_fixed_power | Curtailment power, grid operator — fixed reference, unsettled | W | native | exact | — |
raw_curtailment_marketer_pyranometer | Curtailment Marketer by Pyranometer | plant.curtailment_marketer_ref_pyranometer_power | Curtailment power, direct marketer — pyranometer, unsettled | W | native | exact | — |
raw_curtailment_marketer_satellite | Curtailment Marketer by Satellite | plant.curtailment_marketer_ref_satellite_power | Curtailment power, direct marketer — satellite, unsettled | W | native | exact | — |
raw_curtailment_marketer_weather | Curtailment Marketer by Weather | plant.curtailment_marketer_ref_weather_power | Curtailment power, direct marketer — weather model, unsettled | W | native | exact | — |
raw_curtailment_marketer_fixed | Curtailment Marketer by Fixed | plant.curtailment_marketer_ref_fixed_power | Curtailment power, direct marketer — fixed reference, unsettled | W | native | exact | — |
raw_curtailment_grid_pyranometer_energy | Curtailment Grid by Pyranometer | plant.curtailment_grid_ref_pyranometer | Curtailment energy, grid operator — pyranometer, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_grid_satellite_energy | Curtailment Grid by Satellite | plant.curtailment_grid_ref_satellite | Curtailment energy, grid operator — satellite, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_grid_weather_energy | Curtailment Grid by Weather | plant.curtailment_grid_ref_weather | Curtailment energy, grid operator — weather model, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_grid_fixed_energy | Curtailment Grid by Fixed | plant.curtailment_grid_ref_fixed | Curtailment energy, grid operator — fixed reference, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_marketer_pyranometer_energy | Curtailment Marketer by Pyranometer | plant.curtailment_marketer_ref_pyranometer | Curtailment energy, direct marketer — pyranometer, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_marketer_satellite_energy | Curtailment Marketer by Satellite | plant.curtailment_marketer_ref_satellite | Curtailment energy, direct marketer — satellite, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_marketer_weather_energy | Curtailment Marketer by Weather | plant.curtailment_marketer_ref_weather | Curtailment energy, direct marketer — weather model, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_curtailment_marketer_fixed_energy | Curtailment Marketer by Fixed | plant.curtailment_marketer_ref_fixed | Curtailment energy, direct marketer — fixed reference, unsettled | Wh → kWh | cumulative | approximate | The previous value plain was a running total from the start of the range |
raw_network_latency | Network Latency | infrastructure.network_latency | Network latency | ms | native | exact | — |
raw_network_packet_loss | Packet Loss | infrastructure.network_packet_loss | Packet loss | % | native | exact | — |
raw_network_ping_success | Ping Success | infrastructure.network_ping_success | Ping success | ratio 0..1 | native | exact | — |
raw_network_connection_status | Connection Status | infrastructure.network_connection_status | Connection status | ratio 0..1 | native | exact | — |
raw_alarm_door_open | Alarm: gate/door open | infrastructure.alarm_door_open | Alarm: gate or door open | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_triggered | Alarm: intrusion alarm raised | infrastructure.alarm_triggered | Alarm: intrusion alarm raised | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_fault | Alarm: alarm system fault | infrastructure.alarm_fault | Alarm: alarm system fault | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_cabinet_ups_alarm | Alarm: cabinet UPS alarm | infrastructure.alarm_cabinet_ups_alarm | Alarm: cabinet UPS fault | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_cabinet_ups_on_battery | Alarm: cabinet on UPS battery | infrastructure.alarm_cabinet_ups_on_battery | Alarm: cabinet on UPS battery | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_cabinet_heating_breaker_tripped | Alarm: cabinet heating breaker tripped | infrastructure.alarm_cabinet_heating_breaker_tripped | Alarm: cabinet heating breaker tripped | — | native | approximate | The state at the start of each 15-minute interval |
raw_alarm_cabinet_main_switch_off | Alarm: cabinet main switch off | infrastructure.alarm_cabinet_main_switch_off | Alarm: cabinet main switch off | — | native | approximate | The state at the start of each 15-minute interval |
raw_solar_radiation | Solar Radiation | sensor.irradiance | Irradiance per sensor | W/m² | native | approximate | One column per sensor instead of their average |
raw_irradiation_energy_total | Irradiation Energy | sensor.irradiation | Irradiation per sensor | Wh/m² → kWh/m² | cumulative | approximate | One column per sensor instead of their average; the previous value was the meter reading itself |
raw_ambient_temperature | Ambient Temperature | plant.temperature_ambient | Ambient temperature, site sensor | °C | native | exact | — |
raw_module_temperature | Module Temperature | plant.temperature_module | Module temperature, site sensor | °C | native | exact | — |
raw_wind_speed | Wind Speed | plant.wind_speed | Wind speed, site sensor | m/s | native | exact | — |
raw_wind_direction | Wind Direction | plant.wind_direction | Wind direction, site sensor | ° | native | exact | — |
raw_humidity | Humidity | plant.humidity | Humidity, site sensor | % | native | exact | — |
raw_availability_technical | Technical Availability | availability.logger_park | Logger availability (park) | % | native | approximate | The share of intervals in which the loggers reported |
raw_availability_inverter | Inverter Availability | availability.inverter_park | Inverter availability (park) | % | native | approximate | The share of daylight intervals in which the inverters produced |
raw_curtailment_grid_nacelle | Curtailment Grid by Power Curve | plant.curtailment_grid_spitz_wind_power | Curtailment power, grid operator — Spitz Wind | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_grid_windref | Curtailment Grid by Reference Wind Speed | plant.curtailment_grid_spitz_wind_light_power | Curtailment power, grid operator — Spitz Wind light | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_grid_windfixed | Curtailment Grid by Flat Rate (Wind) | plant.curtailment_grid_pauschal_wind_power | Curtailment power, grid operator — Pauschal Wind | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_nacelle | Curtailment Marketer by Power Curve | plant.curtailment_marketer_spitz_wind_power | Curtailment power, direct marketer — Spitz Wind | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_windref | Curtailment Marketer by Reference Wind Speed | plant.curtailment_marketer_spitz_wind_light_power | Curtailment power, direct marketer — Spitz Wind light | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_windfixed | Curtailment Marketer by Flat Rate (Wind) | plant.curtailment_marketer_pauschal_wind_power | Curtailment power, direct marketer — Pauschal Wind | W | native | approximate | The settled curtailment of this wind method |
raw_curtailment_grid_nacelle_energy | Curtailment Grid by Power Curve | plant.curtailment_grid_spitz_wind | Curtailment energy, grid operator — Spitz Wind | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
raw_curtailment_grid_windref_energy | Curtailment Grid by Reference Wind Speed | plant.curtailment_grid_spitz_wind_light | Curtailment energy, grid operator — Spitz Wind light | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
raw_curtailment_grid_windfixed_energy | Curtailment Grid by Flat Rate (Wind) | plant.curtailment_grid_pauschal_wind | Curtailment energy, grid operator — Pauschal Wind | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_nacelle_energy | Curtailment Marketer by Power Curve | plant.curtailment_marketer_spitz_wind | Curtailment energy, direct marketer — Spitz Wind | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_windref_energy | Curtailment Marketer by Reference Wind Speed | plant.curtailment_marketer_spitz_wind_light | Curtailment energy, direct marketer — Spitz Wind light | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
raw_curtailment_marketer_windfixed_energy | Curtailment Marketer by Flat Rate (Wind) | plant.curtailment_marketer_pauschal_wind | Curtailment energy, direct marketer — Pauschal Wind | Wh → kWh | cumulative | approximate | The settled curtailment of this wind method |
Component Metrics
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
comp_raw_inverter_energy_ac | Inverter Production | inverter.ac | AC production per inverter | Wh → kWh | delta | exact | — |
comp_raw_inverter_energy_dc | Inverter DC Production | inverter.dc | DC input | Wh → kWh | delta | exact | — |
comp_raw_string_energy | Production | string.power | DC energy per string | Wh → kWh | delta | exact | — |
comp_raw_gak_energy | GAK Production | gak.power | DC energy per combiner box | Wh → kWh | delta | exact | — |
comp_raw_inverter_energy_simulation | Inverter Simulation Energy | inverter.twin_simulation | Twin simulated energy per inverter | Wh → kWh | delta | exact | — |
comp_raw_inverter_energy_loss | Inverter Loss Energy | inverter.twin_loss | Twin loss energy per inverter | Wh → kWh | delta | exact | — |
comp_raw_gak_energy_simulation | GAK Simulation Energy | gak.twin_simulation | Twin simulated energy per combiner box | Wh → kWh | delta | exact | — |
comp_raw_gak_energy_loss | GAK Loss Energy | gak.twin_loss | Twin loss energy per combiner box | Wh → kWh | delta | exact | — |
comp_raw_string_energy_simulation | Simulation Energy | string.twin_simulation | Twin simulated energy per string | Wh → kWh | delta | exact | — |
comp_raw_string_energy_loss | Loss Energy | string.twin_loss | Twin loss energy per string | Wh → kWh | delta | exact | — |
comp_raw_inverter_prrc | Inverter PRRC | inverter.twin_prrc | Twin PRRC per inverter | % | native | approximate | A percentage instead of a factor |
comp_raw_inverter_sim_err | Inverter Simulation Error | inverter.twin_sim_err | Twin simulation error per inverter | % | native | approximate | A percentage instead of a factor |
comp_raw_gak_prrc | GAK PRRC | gak.twin_prrc | Twin PRRC per combiner box | % | native | approximate | A percentage instead of a factor |
comp_raw_gak_sim_err | GAK Simulation Error | gak.twin_sim_err | Twin simulation error per combiner box | % | native | approximate | A percentage instead of a factor |
comp_raw_string_prrc | PRRC | string.twin_prrc | Twin PRRC per string | % | native | approximate | A percentage instead of a factor |
comp_raw_string_sim_err | Simulation Error | string.twin_sim_err | Twin simulation error per string | % | native | approximate | A percentage instead of a factor |
comp_raw_inverter_power_ac | Inverter AC Power | inverter.ac_power | AC power per inverter | W | native | exact | — |
comp_raw_inverter_power_dc | Inverter DC Power | inverter.dc_power | DC power per inverter | W | native | exact | — |
comp_raw_inverter_voltage_ac | Inverter AC Voltage | inverter.voltage_ac | AC voltage per inverter | V | native | exact | — |
comp_raw_inverter_voltage_dc | Inverter DC Voltage | inverter.voltage_dc | DC voltage per inverter | V | native | exact | — |
comp_raw_inverter_temperature | Inverter Temperature | inverter.temperature | Temperature per inverter | °C | native | exact | — |
comp_raw_inverter_resistance_iso | Inverter Isolation Resistance | inverter.insulation | Insulation resistance per inverter | kΩ → Ω | native | exact | — |
comp_raw_inverter_vendor_status | Inverter Status Code | inverter.vendor_status | Status code per inverter | — | native | approximate | The code at the start of each 15-minute interval |
comp_raw_gak_power | GAK Power | gak.dc_power | DC power per combiner box | W | native | exact | — |
comp_raw_gak_voltage | GAK Voltage | gak.voltage | Voltage per combiner box | V | native | exact | — |
comp_raw_gak_current | GAK Current | gak.current | Current per combiner box | A | native | exact | — |
comp_raw_gak_temperature | GAK Temperature | gak.temperature | Temperature per combiner box | °C | native | exact | — |
comp_raw_string_power | Power | string.dc_power | DC power per string | W | native | exact | — |
comp_raw_string_voltage | Voltage | string.voltage | Voltage per string | V | native | exact | — |
comp_raw_string_current | Current | string.current | Current per string | A | native | exact | — |
comp_raw_string_shadow_factor | Shadow Factor | string.shadow_factor | Shadow factor per string | % | native | approximate | A percentage instead of a factor |
comp_raw_battery_box_energy_charged | Battery Box Stored Energy | battery_box.energy_stored | Stored energy per container | Wh → kWh | native | exact | — |
comp_raw_battery_storage_soc | Battery Storage SoC | battery_storage.soc | State of charge per rack | % | native | exact | — |
comp_raw_battery_storage_power_dc | Battery Storage DC Power | battery_storage.power_dc | DC power per rack | W | native | approximate | The sum of the rack instead of its average |
comp_raw_battery_storage_energy_charged | Battery Storage Stored Energy | battery_storage.energy_stored | Stored energy per rack | Wh → kWh | native | exact | — |
comp_raw_battery_module_temperature | Battery Module Temperature | battery_module.temperature | Temperature per module | °C | native | exact | — |
comp_raw_battery_cell_voltage | Battery Cell Voltage | battery_cell.voltage | Cell voltage per cell | V | native | exact | — |
comp_raw_battery_cell_temperature | Battery Cell Temperature | battery_cell.temperature | Temperature per cell | °C | native | exact | — |
comp_raw_battery_environment_temperature | Battery Environment Temperature | battery.environment_temperature | Battery ambient temperature | °C | native | approximate | The plant average instead of one column per sensor |
comp_raw_alarm_door_open | Alarm: gate/door open | infrastructure.alarm_door_open | Alarm: gate or door open | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_triggered | Alarm: intrusion alarm raised | infrastructure.alarm_triggered | Alarm: intrusion alarm raised | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_fault | Alarm: alarm system fault | infrastructure.alarm_fault | Alarm: alarm system fault | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_cabinet_ups_alarm | Alarm: cabinet UPS alarm | infrastructure.alarm_cabinet_ups_alarm | Alarm: cabinet UPS fault | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_cabinet_ups_on_battery | Alarm: cabinet on UPS battery | infrastructure.alarm_cabinet_ups_on_battery | Alarm: cabinet on UPS battery | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_cabinet_heating_breaker_tripped | Alarm: cabinet heating breaker tripped | infrastructure.alarm_cabinet_heating_breaker_tripped | Alarm: cabinet heating breaker tripped | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
comp_raw_alarm_cabinet_main_switch_off | Alarm: cabinet main switch off | infrastructure.alarm_cabinet_main_switch_off | Alarm: cabinet main switch off | — | native | approximate | The state at the start of each 15-minute interval; the worst of the plant's alarm systems instead of one column per system |
Calculated Metrics
| Previous id | Previous name | Metric | Name | Unit | Values | Match | Difference |
|---|---|---|---|---|---|---|---|
pr_weather | Performance Ratio by GTI Weather | plant.pr_weather | Performance ratio (weather model) | % | native | approximate | The cleaned performance ratio of the trailing week |
pr_sensor | Performance Ratio by GTI Sensor | plant.pr_pyranometer | Performance ratio (pyranometer) | % | native | approximate | The cleaned performance ratio of the trailing week |
specific_yield | Specific Yield | plant.specific_yield | Specific yield | kWh/kWp | native | approximate | Grid feed-in divided by the installed peak power |
production_target_weather | Production Target based on GTI Weather | plant.expected_weather | Expected production (weather model) | kWh | delta | approximate | The expected production, capped and scaled with the performance ratio |
production_target_sensor | Production Target based on GTI Sensor | plant.expected_pyranometer | Expected production (pyranometer) | kWh | delta | approximate | The expected production, capped and scaled with the performance ratio |
Ids Without a Counterpart
These ids are not part of the metric collection. They keep working on the previous links. Sent to the new link, they answer 400 legacy_metric_id with the previous link that delivers them.
| Reason | Ids |
|---|---|
| A momentary value, not a time series | power_grid_now |
| A target of the plant's yield report, not a measurement | energy_report, gti_report, gti_report_eff, pr_report, raw_power_report, raw_energy_report_total |
| A calculated column of the previous export | irradiance_actual, non_compensable_losses, irradiance_weather_usage_percent, irradiance_sensor_weather_diff_percent, production_target_actual, production_target_actual_corrected, pr_actual, pr_actual_corrected, report_pr_actual_corrected |
| A model series that is no longer written | model_energy_dc_daily, model_energy_ac_daily, model_energy_grid_daily, clearsky_energy_dc_daily, clearsky_energy_ac_daily, clearsky_energy_grid_daily, raw_model_power_dc, raw_model_power_ac, raw_model_power_grid, raw_model_energy_dc_total, raw_model_energy_ac_total, raw_model_energy_grid_total, raw_model_energy_grid_in_total, raw_model_energy_grid_out_total, raw_clearsky_power_dc, raw_clearsky_power_ac, raw_clearsky_power_grid, raw_clearsky_energy_dc_total, raw_clearsky_energy_ac_total, raw_clearsky_energy_grid_total, raw_clearsky_energy_grid_in_total, raw_clearsky_energy_grid_out_total |
| Defined in a way the collection does not reproduce, or no longer measured | energy_forecast_daily, availability_data, availability_sensor, availability_energy, availability_network, availability_grid, raw_availability_data, raw_availability_sensor, raw_availability_network, raw_availability_grid, energy_radiation_daily, energy_ac_reactive_daily, raw_power_ac_apparent, raw_energy_ac_reactive_total, raw_inverter_current_ac_phase, raw_power_max, raw_solar_ghi_reference, raw_solar_ghi_reference_energy, raw_energy_radiation_total, raw_power_radiation, solar_radiation_daily, raw_power_loss, raw_max_power_by_local, raw_battery_box_cell_voltage, comp_raw_battery_storage_voltage_dc, comp_raw_battery_storage_current_dc |
For the availability figures of the previous export (availability_data, availability_sensor, availability_energy, availability_network, availability_grid), the collection offers the availability metrics of the reports under the level Metrics, such as availability.logger_park, availability.inverter_park, availability.connectivity and availability.financial. They answer similar questions but are defined differently, so they are not offered as counterparts.
Targets of the Yield Report
energy_report, gti_report and pr_report are the monthly targets of the plant's yield report: the production, the irradiation and the performance ratio the plant is expected to reach. The previous export spread a month's target evenly over its days. They are targets, not measurements, so the measured metrics Production (resolved) (plant.production_reported) and Plane-of-array irradiation, resolved (plant.rad_reported) are not their counterparts.
The targets are planned as metrics of the collection. Until they are part of it, the answer to these ids names the planned metric in hint.pending, and the previous links keep delivering the targets.
Weather Forecast
The weather forecast values of the previous export (raw_weather_…) are not part of the Metric Export. The collection offers the current weather at the plant under the level Weather, and the plant's own weather-model irradiation. The table names the metric that comes closest. The numbers come from a different source, so they are not the same. The previous links keep delivering the forecast values.
| Previous id | Closest metric | Name |
|---|---|---|
raw_weather_gti | plant.rad_weather_power | Plant-plane irradiance, weather model |
raw_weather_gti_energy | plant.rad_weather | Plant-plane radiation, weather model |
raw_weather_gti_direct | weather.dni_power | Direct normal irradiance (W/m²) |
raw_weather_ghi_direct | weather.dni_power | Direct normal irradiance (W/m²) |
raw_weather_gti_clearsky | — | — |
raw_weather_ghi_direct_clearsky | — | — |
raw_weather_gti_direct_clearsky | — | — |
raw_weather_lightning_potential | — | — |
raw_weather_code | — | — |
raw_weather_shortwave_radiation | weather.ghi_power | Global horizontal irradiance (W/m²) |
raw_weather_diffuse_radiation | weather.dhi_power | Diffuse horizontal irradiance (W/m²) |
raw_weather_dni | weather.dni_power | Direct normal irradiance (W/m²) |
raw_weather_terrestrial_radiation | weather.terrestrial_power | Extraterrestrial irradiance (W/m²) |
raw_weather_temperature_2m | weather.temperature | Air temperature (2 m) |
raw_weather_wind_speed_10m | weather.wind_speed | Wind speed (10 m) |
raw_weather_wind_direction_10m | weather.wind_direction | Wind direction (10 m) |
raw_weather_wind_gusts_10m | weather.wind_gusts | Wind gusts (10 m) |
raw_weather_humidity | weather.humidity | Relative humidity (2 m) |
raw_weather_cloud_cover | weather.clouds | Cloud cover |
raw_weather_precipitation | weather.precipitation | Precipitation |
raw_weather_rain | weather.rain | Rain |
raw_weather_snowfall | weather.snowfall | Snowfall |
raw_weather_dew_point_2m | weather.dew_point | Dew point (2 m) |
raw_weather_apparent_temperature | weather.apparent_temperature | Apparent temperature |
raw_weather_snow_depth | weather.snow_depth | Snow depth |
raw_weather_visibility | weather.visibility | Visibility |
raw_weather_temperature_80m | weather.temperature_80m | Air temperature (80 m) |
raw_weather_temperature_120m | weather.temperature_120m | Air temperature (120 m) |
raw_weather_temperature_180m | weather.temperature_180m | Air temperature (180 m) |
raw_weather_wind_speed_80m | weather.wind_speed_80m | Wind speed (80 m) |
raw_weather_wind_speed_120m | weather.wind_speed_120m | Wind speed (120 m) |
raw_weather_wind_speed_180m | weather.wind_speed_180m | Wind speed (180 m) |
raw_weather_wind_direction_80m | weather.wind_direction_80m | Wind direction (80 m) |
raw_weather_wind_direction_120m | weather.wind_direction_120m | Wind direction (120 m) |
raw_weather_wind_direction_180m | weather.wind_direction_180m | Wind direction (180 m) |
raw_weather_daily_shortwave_radiation_sum | weather.ghi_power | Global horizontal irradiance (W/m²) |
raw_weather_daily_precipitation_sum | weather.precipitation | Precipitation |
raw_weather_daily_rain_sum | weather.rain | Rain |
raw_weather_daily_showers_sum | weather.precipitation | Precipitation |
raw_weather_daily_snowfall_sum | weather.snowfall | Snowfall |
raw_weather_daily_precipitation_hours | weather.precipitation | Precipitation |
raw_weather_daily_weather_code | — | — |
raw_weather_daily_temperature_2m_max | weather.temperature | Air temperature (2 m) |
raw_weather_daily_wind_speed_10m_max | weather.wind_speed | Wind speed (10 m) |
raw_weather_daily_wind_gusts_10m_max | weather.wind_gusts | Wind gusts (10 m) |
raw_weather_daily_wind_direction_10m_dominant | weather.wind_direction | Wind direction (10 m) |
Related Features
- Metric Export — the Data Export page
- Metric Export API — every parameter of the new links
- Legacy Export API — the previous links
- MiroxQL Formulas — the formula API
- Data Export FAQ