SchemaPower ManagementOperations

Publish Power Breach Alert

View as Markdown

Power Management Agent → Infra Agent + ISVs (breach alert)

Direction: Publish (send)

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

ParameterDescription
identifierUnique 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

NameTypeRequiredDescription
specversionstringYesMUST be “1.0.2” — version of the CloudEvents specification. Must be 1.0.2.
idstring (uuid)YesMUST be a UUIDv4 — globally unique identifier for this event instance.
sourcestringYesStable 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
typeanyYesMust be grid.powerbreach.alert.v1.
timestring (date-time)YesMUST be an ISO 8601 timestamp — time the event was created.
datacontenttypestringYesMUST be “application/json” — media type of the data payload. Must be application/json.
subjectstringYesResource subject identifying the domain object (e.g., loadtarget, powerstate, powerbreach).
correlationidstring (uuid)NoCloudEvents 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.
traceparentstringYesREQUIRED per W3C Trace Context and CloudEvents Distributed Tracing Extension. Format: version-traceid-parentid-flags.
tracestatestringNoOPTIONAL per W3C Trace Context. Carries vendor-specific contextual information across tracing systems.
dataJwsCompactSerialization or PowerBreachAlertDataYesWIRE FORMAT: JWS compact serialization string (type: string). PLAINTEXT CONTENT: After JWS verification, the payload conforms to PowerBreachAlertData schema (type: object).
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}