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. 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

  1. Obtain an ENTSO-E Transparency Platform API token with access to the required data.

  2. Make sure the agent host can reach web-api.tp.entsoe.eu over HTTPS.

  3. Load the subagent and configure the token and zones in nxagentd.conf:

    SubAgent = entsoe
    
    [ENTSOE]
    Token = your_api_token
    Zones = LV,LT,EE
  4. Restart the agent, then query the ENTSOE.Zones list and a metric such as ENTSOE.TotalGeneration(LV).

  5. Create DCIs with origin NetXMS Agent. Use ENTSOE.Generation(zone,type) for per-type generation, or a table DCI for ENTSOE.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

Table 1. [ENTSOE] section parameters
Parameter Default Description

Token

Empty

API token. Collection is inactive when it is empty.

Zones

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.

ZoneCatalog

Unset

Path to a CSV file that adds or replaces built-in zone definitions.

EmissionFactors

Unset

Path to a file overriding production-type emission factors and categories.

DefaultFactor

500

Emission factor in gCO2eq/kWh for production codes without a mapping. Such codes use category other and generate a warning once per code. This does not replace the built-in B20 factor.

Lookback

10800

Seconds of generation and flow history requested at each poll.

PollInterval

900

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.

RequestTimeout

30

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
Table 2. [ENTSOE/Zone/name] section parameters
Parameter Default Description

EIC

Required

Zone EIC code. A section without an EIC is ignored.

Border

None

Repeatable neighbour specification: NAME resolves its EIC from the catalog; NAME:EIC supplies it explicitly. An unresolved bare name is skipped.

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.

Table 3. Built-in emission factors and classifications
Code Production type gCO2eq/kWh Category

B01

Biomass

230

renewable

B02

Fossil Brown coal/Lignite

1050

fossil

B03

Fossil Coal-derived gas

820

fossil

B04

Fossil Gas

490

fossil

B05

Fossil Hard coal

820

fossil

B06

Fossil Oil

650

fossil

B07

Fossil Oil shale

900

fossil

B08

Fossil Peat

1000

fossil

B09

Geothermal

38

renewable

B10

Hydro Pumped Storage

0

storage

B11

Hydro Run-of-river and poundage

24

renewable

B12

Hydro Water Reservoir

24

renewable

B13

Marine

17

renewable

B14

Nuclear

12

nuclear

B15

Other renewable

230

renewable

B16

Solar

45

renewable

B17

Waste

700

fossil

B18

Wind Offshore

12

renewable

B19

Wind Onshore

11

renewable

B20

Other

500

other

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

Table 4. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 5. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 6. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

type

String

ENTSO-E production-type code, for example B16

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

Table 7. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 8. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 9. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 10. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 11. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

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

Table 12. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

Table 13. Columns
Column Type Description

CODE

String

Production-type code (instance key)

NAME

String

Production-type name

CATEGORY

String

renewable, nuclear, fossil, storage, or other, using the configured factor classification

MW

Float

Raw generation in MW, including any negative value returned by the API

SHARE

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

Table 14. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

Table 15. Columns
Column Type Description

NEIGHBOUR

String

Neighbour name (instance key)

IMPORT

Float

Import from neighbour in MW

EXPORT

Float

Export to neighbour in MW

NET

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

Table 16. Arguments
Argument Type Description

zone

String

Configured bidding-zone name; matching ignores case and separators such as - and _

Table 17. Columns
Column Type Description

TIME

Integer 64

Target time as UNIX timestamp (instance key)

WIND

Float

Wind generation forecast in MW

SOLAR

Float

Solar generation forecast in MW

LOAD

Float

Load forecast in MW

Troubleshooting

  • Subagent loads but metrics have no data — check Token and the zone list. ENTSOE.Zones lists 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.