ENTSO-E Grid Data
The entsoe subagent reads electricity generation, wind/solar and load forecasts, and physical cross-border flows from the ENTSO-E Transparency Platform. Since 6.2.2
It derives domestic generation carbon intensity and renewable and low-carbon shares from configurable emission factors.
It runs on Windows and UNIX-like systems and can monitor multiple bidding zones from one agent.
How It Works
The agent connects over HTTPS to web-api.tp.entsoe.eu, verifies the server certificate and host name, and uses an API token for authentication.
For each zone it requests actual generation per production type, day-ahead wind/solar and load forecasts for the next 48 hours, and physical flows in both directions for each configured border.
Generation and flow requests use the Lookback window; the parser selects values for the latest fully elapsed interval and carries forward unchanged values within a time series.
All DCI requests read cached data.
Generation, forecasts, and flows are updated separately, so a successful generation update does not imply a successful forecast or flow update.
A failed update leaves that data set’s old values available without a cache expiry limit.
Use ENTSOE.DataAge(zone) to inspect the served generation interval’s age; it does not report the last successful HTTP request or the age of forecasts and flows.
The parser can carry the final published value forward beyond a document’s period end, so a small DataAge does not prove that the publisher supplied fresh data.
Carbon intensity is the sum of each production type’s MW multiplied by its emission factor, divided by qualifying total generation.
Storage and negative generation are excluded from this total.
Renewable share includes the renewable category; low-carbon share includes renewable and nuclear.
Imports are reported separately and do not affect these generation-based calculations.
Enabling Collection
-
Obtain an ENTSO-E Transparency Platform API token with access to the required data.
-
Make sure the agent host can reach
web-api.tp.entsoe.euover HTTPS. -
Load the subagent and configure the token and zones in
nxagentd.conf:SubAgent = entsoe [ENTSOE] Token = your_api_token Zones = LV,LT,EE -
Restart the agent, then query the
ENTSOE.Zoneslist and a metric such asENTSOE.TotalGeneration(LV). -
Create DCIs with origin NetXMS Agent. Use
ENTSOE.Generation(zone,type)for per-type generation, or a table DCI forENTSOE.Generation(zone).
Missing tokens or an empty configured-zone list leave the subagent loaded but inactive and generate a warning in the agent log.
Configuration
| Parameter | Default | Description |
|---|---|---|
|
Empty |
API token. Collection is inactive when it is empty. |
|
Empty |
Comma-separated bidding-zone names resolved against the built-in catalog and optional catalog overrides. Unknown names are logged and ignored; explicit zone sections can add zones separately. |
|
Unset |
Path to a CSV file that adds or replaces built-in zone definitions. |
|
Unset |
Path to a file overriding production-type emission factors and categories. |
|
|
Emission factor in gCO2eq/kWh for production codes without a mapping. Such codes use category |
|
|
Seconds of generation and flow history requested at each poll. |
|
|
Target polling cycle in seconds, minimum 60. Zones are polled sequentially. If a full cycle takes longer than this interval, the next starts after a 1-second wait. |
|
|
Timeout in seconds for each HTTPS request. |
Zones and Borders
Zone names are matched without case or separators, so SE4, SE-4, and SE_4 match the same zone.
Zones selects zones from the catalog, including their border lists.
For a custom zone or to replace a catalog zone, add an explicit section:
[ENTSOE/Zone/LV]
EIC = 10YLV-1001A00074
Border = EE
Border = LT:10YLT-1001A0008Q
| Parameter | Default | Description |
|---|---|---|
|
Required |
Zone EIC code. A section without an EIC is ignored. |
|
None |
Repeatable neighbour specification: |
An explicit section replaces a same-named selected catalog zone completely, including its border list. It does not inherit catalog borders. With no borders, generation and forecasts can still be collected, but no flow snapshot is created.
The optional ZoneCatalog file uses one zone per line:
# NAME,EIC,neighbour1,neighbour2,...
LV,10YLV-1001A00074,EE,LT
Entries add or replace catalog definitions; they do not select zones for monitoring.
Select them with Zones, or define explicit sections.
Blank lines and lines beginning with # are ignored.
Emission Factors
The EmissionFactors file uses one override per line:
# Production code = gCO2eq/kWh, category
B04 = 490, fossil
B16 = 45, renewable
Categories are renewable, nuclear, fossil, storage, and other, matched case-insensitively.
Omitting the category, or using an unknown category, assigns other.
Use the uppercase production codes shown below.
Blank lines and lines beginning with # are ignored.
Overrides leave other built-in mappings unchanged.
| Code | Production type | gCO2eq/kWh | Category |
|---|---|---|---|
|
Biomass |
230 |
|
|
Fossil Brown coal/Lignite |
1050 |
|
|
Fossil Coal-derived gas |
820 |
|
|
Fossil Gas |
490 |
|
|
Fossil Hard coal |
820 |
|
|
Fossil Oil |
650 |
|
|
Fossil Oil shale |
900 |
|
|
Fossil Peat |
1000 |
|
|
Geothermal |
38 |
|
|
Hydro Pumped Storage |
0 |
|
|
Hydro Run-of-river and poundage |
24 |
|
|
Hydro Water Reservoir |
24 |
|
|
Marine |
17 |
|
|
Nuclear |
12 |
|
|
Other renewable |
230 |
|
|
Solar |
45 |
|
|
Waste |
700 |
|
|
Wind Offshore |
12 |
|
|
Wind Onshore |
11 |
|
|
Other |
500 |
|
These values are the subagent’s calculation assumptions and can be changed for your reporting requirements.
The ENTSOE.Generation table shows the category used for each production type.
Metrics, Lists, and Tables
Provided by the entsoe subagent, which reads the ENTSO-E Transparency Platform and caches each configured zone’s generation, forecast, and cross-border flows.
All scalar metrics take a configured zone name; ENTSOE.Generation also takes a production-type code.
Unknown zones return no such instance.
Scalar metrics and tables return a collection error before their first successful update.
Failed updates leave previous data available without an expiry limit; ENTSOE.DataAge describes the served generation interval, not the time of the last HTTP request.
Metrics
ENTSOE.CarbonIntensity(zone)
Generation-weighted emission factor in grams of CO2 equivalent per kWh. Uses nonnegative domestic generation, excluding types classified as storage. It does not include imported power in the calculation. Returns 0 when the qualifying generation total is 0.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
ENTSOE.DataAge(zone)
Seconds between current agent time and the start of the generation interval served by the cached snapshot. This is not the age of the last poll or of the forecasts or flow data. When generation types have different interval timestamps, the newest timestamp is used. The parser can carry a final value beyond its published period and assign it a recent interval timestamp, so this metric alone does not prove publication freshness.
Data Type |
Integer 64 |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
ENTSOE.Generation(zone,type)
Generation in MW for the specified production type (for example B16 for solar).
Code matching is case-insensitive.
Once a generation snapshot exists, an absent production type returns 0, including an unrecognized code.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
type |
String |
ENTSO-E production-type code, for example |
ENTSOE.LowCarbonShare(zone)
Percentage of qualifying domestic generation classified as renewable or nuclear. Storage and negative generation are excluded from the total; returns 0 when the total is 0.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
ENTSOE.NetImport(zone)
Net import in MW across the configured borders: import minus export, summed over available border data. Positive means net import; negative means net export. If only one direction is available for a border, the missing direction is treated as 0. Borders with no usable data in either direction are omitted. Without any successful flow snapshot this metric returns an error.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
ENTSOE.RenewableShare(zone)
Percentage of qualifying domestic generation classified as renewable. Storage and negative generation are excluded from the total; returns 0 when the total is 0.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
ENTSOE.TotalGeneration(zone)
Domestic generation total in MW, excluding storage and negative generation. This is also the denominator of the carbon intensity and generation-share calculations.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
Lists
ENTSOE.Zones
Names of configured zones. Available even when the API token is missing and the poller is inactive.
Data Type |
List |
Platforms |
Windows, UNIX-like systems |
ENTSOE.GenerationTypes(zone)
Production-type codes in the current generation snapshot. Returns an empty list before the first successful generation update.
Data Type |
List |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
Tables
ENTSOE.Generation(zone) (Table)
Generation by production type. This table takes one argument; the scalar metric of the same name takes two.
Data Type |
Table |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
| Column | Type | Description |
|---|---|---|
|
String |
Production-type code (instance key) |
|
String |
Production-type name |
|
String |
|
|
Float |
Raw generation in MW, including any negative value returned by the API |
|
Float |
Generation divided by the non-storage total, multiplied by 100; 0 for storage or a zero total |
ENTSOE.CrossBorderFlows(zone)
Latest available physical flows for the configured borders. A border is included only when at least one direction has usable data; an unavailable direction is reported as 0.
Data Type |
Table |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
| Column | Type | Description |
|---|---|---|
|
String |
Neighbour name (instance key) |
|
Float |
Import from neighbour in MW |
|
Float |
Export to neighbour in MW |
|
Float |
Import minus export in MW |
ENTSOE.Forecast(zone)
Wind, solar, and load forecasts merged by target time and sorted chronologically. The poller requests the next 48 hours; returned points follow the API document. Unavailable forecast fields are empty, rather than zero. WIND combines offshore and onshore wind.
Data Type |
Table |
Platforms |
Windows, UNIX-like systems |
| Argument | Type | Description |
|---|---|---|
zone |
String |
Configured bidding-zone name; matching ignores case and separators such as |
| Column | Type | Description |
|---|---|---|
|
Integer 64 |
Target time as UNIX timestamp (instance key) |
|
Float |
Wind generation forecast in MW |
|
Float |
Solar generation forecast in MW |
|
Float |
Load forecast in MW |
Troubleshooting
-
Subagent loads but metrics have no data — check
Tokenand the zone list.ENTSOE.Zoneslists configured zones even when the poller is inactive. Before the first successful update, scalar metrics and tables fail;ENTSOE.GenerationTypes(zone)returns an empty list. -
Unknown zone — check its catalog name or add an explicit section with
EIC. Zone names in metric arguments must refer to a configured zone. -
Generation works, but net import fails — check that borders are configured and that flow data is available. A custom zone section does not inherit catalog borders.
-
Old data — each data set retains its previous snapshot when its request or parsing fails. Check API responses, data availability, request timeouts, and the served generation interval with
ENTSOE.DataAge. -
Factor or catalog file cannot be opened — the agent logs a warning and continues with the defaults already loaded.
Enable agent debug tag entsoe at level 5 for HTTP errors, API acknowledgement reasons, and parsing errors; level 6 also logs generation updates.