Skip to main content

Available data

The assistant can answer only from the data in this table. Each person sees only the Plants that their account can access.

Levels and resolutions​

LevelDataResolutionTime range in one questionTool
PortfolioOperation Overview table of each PlantOne row for each Plant for one dayOne dayget_portfolio_dashboard (site_overview)
PortfolioYield for the last 7 daysDaily7 daysget_portfolio_dashboard (last_7_days_yield)
PortfolioDevice status and string health summaryCurrent statusNowget_portfolio_dashboard (devices_status_summary, string_health)
PortfolioAlarm status, as on the Operation Overview screenAlarms in the time rangeUp to 92 daysget_portfolio_dashboard (alarm_status)
PlantYield, PR, availability, irradiationDailyUp to 366 daysget_plant_daily_performance
PlantStored DataHub Plant metric values5 minutes, as storedUp to 31 days, but 1,000 rows allow about 3 days for one metric or 1 day for 3 metricsquery_plant_5min
PlantOther stored daily values, including curtailment, soiling, revenue, temperature-corrected PR, and monthly valuesDaily, as storedUp to 366 days, maximum 1,000 rowsquery_plant_daily
PlantPower, yield, and performance charts1, 5, 15, 30, or 60 minutesOne dayget_plant_chart
PlantLive production and device communication statusCurrent statusNowget_plant_dashboard
PlantDisconnected stringsCurrent statusNowget_plant_dashboard (disconnected_strings)
PlantActive alarms, alarm history, and detailsCurrent alarm state and lifecycle timesThe selected range filters alarm creation time; ten alarms per pagelist_alarms, get_alarm
DeviceDevice IDs, names, types, parents, labels, and attributesNot time-basedNot applicablelist_devices
DeviceNamed device telemetry (exact, case-sensitive keys)1, 5, 15, 30, or 60 minutesOne day, one device, up to 10 metricsquery_device_telemetry
InverterDaily yield, availability, derating loss, operation time, and unavailability, overspill, and soiling lossDailyUp to 366 days, all inverters or selected invertersquery_inverter_daily
StringString analytics, as on the String Analytics screen (for example average current and normalized power)One record for each string for each dayOne day for each questionget_string_daily_analytics
StringStored current (Idc) and voltage (Udc) of each string5, 15, 30, or 60 minutesUp to 7 days, from approximately the last 72 daysquery_string_5min

Resolution and size​

DataUse it forLimit
Daily valuesCandidates for an investigation. They do not show when a fault started.One data point for each Plant, device, or string for each day
Plant time seriesStored values as they are1,000 rows in one answer. Select metric keys from the tool schema.
Chart and device telemetryThe shape of a dayUp to 288 data points for each metric for each day at 5 minutes
String analyticsProcessed daily valuesOne record for each string for each day
String current and voltageWeak strings1,000 records in one answer. A Plant with 114 strings gives about 16,500 records for one day at 5 minutes.

For string current and voltage, start with one inverter at 15 or 60 minutes. Then ask for 5 minutes for a short time range. If a question needs more than 1,000 records, the assistant tells you to make it smaller.

Example questions​

Show the stored 5-minute power and irradiance at [Plant name] from [start time] to [end time] on [date]. Tell me which values are missing.
Show daily yield, PR, and availability at [Plant name] from [start date] to [end date]. State the timezone and tell me which days have missing values.
Show [Plant name] power and irradiance on [date] at 5-minute intervals.
Analyze the string analytics of [Plant name] for [date]. List the weakest strings and tell me how many records you used.
Compare the string analytics of [Plant name] for [date], [date], and [date]. Tell me which weak strings stay weak on all three days.

For a comparison over many days, ask for each day by name. The assistant reads string analytics one day at a time.

Show the current and voltage of the strings of [inverter] at [Plant name] on [date] at 15-minute resolution. Tell me which strings have low current. Then show those strings at 5-minute resolution from [start time] to [end time].
Show daily yield, availability, and soiling loss of each inverter at [Plant name] from [start date] to [end date]. Tell me which inverter has the lowest yield.

Not available​

  • String current and voltage older than approximately 72 days.
  • Inverter loss values at a resolution of less than one day.
  • Work orders.
  • Month and year charts, heat maps, the loss waterfall, and insights charts.
  • DataHub metric values for devices other than the stored string and inverter values above.

Read the answer​

  • A missing value is not zero. For device telemetry, an empty series can also mean a wrong metric key. The assistant states the key that it used.
  • Daily and processed values do not prove a hardware fault. Confirm with a site check or higher-resolution data.
  • A clock time with no zone is Plant time. If you name a zone, such as SG (UTC+8), the assistant states both times.
  • Device telemetry covers one Plant day.