Subscribe Power Breach Alert

Infra Agent and ISVs subscribe to breach alerts

Direction: Subscribe (receive)

Channel

grid/v1/poweragent/{identifier}/powerbreach

Power Management Agent publishes breach alerts when measured power exceeds the active load target. Breach lifecycle: active → escalated → resolved. All events in a single breach share the same breach_id.

MQTT QoS: 2

Parameters

Parameter	Description
`identifier`	Unique identifier of the ISV, power agent, or infrastructure agent.

Message: Power Breach Alert

Content Type: application/cloudevents+json

Power Management Agent publishes breach alert with shed hints.

Payload

Name	Type	Required	Description
`specversion`	string	Yes	MUST be “1.0.2” — version of the CloudEvents specification. Must be `1.0.2`.
`id`	string (uuid)	Yes	MUST be a UUIDv4 — globally unique identifier for this event instance.
`source`	string	Yes	Stable URI identifying the publisher. Format: //grid/v1/<role>/<identifier>. Examples: - //grid/v1/isv/acme-energy - //grid/v1/poweragent/dps-prod - //grid/v1/infra/ima-prod
`type`	any	Yes	Must be `grid.powerbreach.alert.v1`.
`time`	string (date-time)	Yes	MUST be an ISO 8601 timestamp — time the event was created.
`datacontenttype`	string	Yes	MUST be “application/json” — media type of the data payload. Must be `application/json`.
`subject`	string	Yes	Resource subject identifying the domain object (e.g., loadtarget, powerstate, powerbreach).
`correlationid`	string (uuid)	No	CloudEvents extension attribute. UUIDv4 correlation identifier. Generated by the ISV on grid.loadtarget.set.v1. Echoed by the Power Management Agent in status events for correlation.
`traceparent`	string	Yes	REQUIRED per W3C Trace Context and CloudEvents Distributed Tracing Extension. Format: version-traceid-parentid-flags.
`tracestate`	string	No	OPTIONAL per W3C Trace Context. Carries vendor-specific contextual information across tracing systems.
`data`	JwsCompactSerialization or PowerBreachAlertData	Yes	WIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerBreachAlertData schema (type: object).

Example payload

1 {
2   "specversion": "1.0.2",
3   "id": "550e8400-e29b-41d4-a716-446655440000",
4   "source": "string",
5   "type": "grid.powerbreach.alert.v1",
6   "time": "2026-05-14T12:00:00Z",
7   "datacontenttype": "application/json",
8   "subject": "string",
9   "correlationid": "550e8400-e29b-41d4-a716-446655440000",
10   "traceparent": "string",
11   "tracestate": "string",
12   "data": "string"
13 }