[Developers]

Outage Management Domain

When a gas leak alarm arrives alongside three correlated pressure drop signals, the system should not wait for a human to connect the dots. The Outage Management domain analyses individual alarms and alarm clusters to de

Category: Api DomainsLast Updated: Feb 24, 2026
api-domainsgeospatial

Overview#

When a gas leak alarm arrives alongside three correlated pressure drop signals, the system should not wait for a human to connect the dots. The Outage Management domain analyses individual alarms and alarm clusters to detect outage conditions automatically, assigns confidence scores, and escalates dangerous events directly to the PSAP. Every status transition is preserved in an immutable audit trail, giving operations teams full accountability from detection through restoration.

Key Features#

  • Telemetry alarm analysis with confidence scoring for outage detection
  • Correlated alarm cluster pattern matching for high-confidence detection
  • Three outage types: planned, unplanned, and emergency
  • Ten outage cause classifications including storm, equipment failure, vegetation, and overload
  • Eight-stage status lifecycle from detection through closure
  • Immutable status history audit trail with customer impact snapshots at each transition
  • PSAP escalation for gas leak, water quality violation, and flow reversal alarms
  • Outage statistics dashboard showing active, emergency, and restored-today counts
  • Auto-generated outage numbers for tracking
  • Crew assignment and work order linking

Use Cases#

Relevant sectors include critical infrastructure, public safety communications, and utility operations.

  • Automatically detecting outages from telemetry alarm analysis and correlated alarm patterns
  • Tracking outages through their full lifecycle from detection to closure with audit trail
  • Escalating emergency utility events to PSAP for gas, water, and electric incidents
  • Monitoring outage statistics and customer impact across the service territory

Integration#

The Outage Management domain integrates with PSAP Utility Bridge for emergency event classification, Utility Telemetry for alarm data and severity analysis, Organization Configuration for automation flags, and Work Orders for linking restoration activities to outage records.

Open Standards#

  • OPC UA (IEC 62541): Telemetry alarms and sensor readings are ingested from SCADA systems via OPC UA REST gateways, with the adapter mapping OPC UA StatusCodes, alarm severity values (1, 1000), and data type hints to the platform's normalised alarm model.
  • NENA i3 / NG9-1-1 (NENA-STA-021): Emergency outage events (gas leak, water quality violation, flow reversal) are escalated to the Public Safety Answering Point via the PSAP Utility Bridge, which conforms to the NENA i3 NG9-1-1 standard for inter-agency incident exchange.
  • GraphQL (June 2018 specification): All outage lifecycle operations, queries, mutations, and status-history retrieval, are exposed through a typed GraphQL API backed by the Strawberry framework.
  • WGS 84 (EPSG:4326): Outage geolocation data (centre latitude/longitude and affected radius in metres) is stored and exchanged in WGS 84 decimal-degree coordinates, consistent with the platform's shared coordinate reference system.
  • OAuth 2.0 / JWT (RFC 6749 / RFC 7519): Every GraphQL resolver is protected by the platform's IsAuthenticated permission class, which validates bearer tokens issued as JWTs under the OAuth 2.0 authorisation framework.
  • ISO 8601: All datetime fields, including estimated and actual restoration times, status-change timestamps, and auto-detection timestamps, are serialised in ISO 8601 format.
  • RFC 4122 (UUID): Outage record identifiers and status-history row identifiers are generated as version-4 UUIDs, ensuring globally unique, collision-resistant keys across tenants.

Last Reviewed: 2026-02-24 Last Updated: 2026-04-14

Ready to Build?

Get started with our APIs or contact our integration team for support.

Outage Management Domain | Knogin Developers | Argus Command Center