Get Monitoring Report
Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.25 (Messages); Use Case N02 — Get Monitoring report (Functional Block N. Diagnostics)
Overview
The CSMS sends GetMonitoringReportRequest to ask the Charging Station to report which monitors are currently configured for given components / variables. Filtering is by monitoringCriteria (up to 3) and/or by an explicit list of componentVariable[].
The CS first responds with GetMonitoringReportResponse(status), then delivers the actual data via one or more NotifyMonitoringReport messages sharing the same requestId.
Sequence Diagram
CSMS ──── GetMonitoringReportRequest ────▶ Charging Station
(requestId, monitoringCriteria[]?, componentVariable[]?)
CSMS ◀─── GetMonitoringReportResponse ──── Charging Station
(status, statusInfo?)
(then NotifyMonitoringReportRequest messages with same requestId)
Initiator
CSMS → Charging Station
Fields
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| requestId | integer | 1..1 | Required. Id of the request. |
| monitoringCriteria | MonitoringCriterionEnumType | 0..3 | Optional. Filter criteria (max 3). |
| componentVariable | ComponentVariableType | 0..* | Optional. Specific component/variable pairs. |
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| status | GenericDeviceModelStatusEnumType | 1..1 | Required. Whether the CS could accept the request. |
| statusInfo | StatusInfoType | 0..1 | Optional. Detailed status information. |
MonitoringCriterionEnumType values
ThresholdMonitoring, DeltaMonitoring, PeriodicMonitoring.
GenericDeviceModelStatusEnumType values
Accepted, Rejected, NotSupported, EmptyResultSet.
Examples
{
"requestId": 42,
"monitoringCriteria": ["ThresholdMonitoring"],
"componentVariable": [
{ "component": { "name": "EVSE", "evse": { "id": 1 } }, "variable": { "name": "Temperature" } }
]
}{
"status": "Accepted"
}Schema
Source:
schemas/GetMonitoringReportRequest.json,schemas/GetMonitoringReportResponse.json(OCPP 2.0.1 FINAL)