Skip to Content

Industry Vocabulary Reference

Energy & Utilities

Energy and utilities fields cover grid assets, outages, demand response, markets, maintenance, and emissions workflows. They describe recorded activity without authorizing changes to operational systems.

v2026.03.1623 enum categories2.2 schema8 subdomains23 standards

Back to industry coverage library

This page shows selected examples and categories. Download the JSON for the complete vocabulary, including every field, permitted value, and policy pattern in this catalog.

Download vocabulary JSONOpen industry SDK quickstartStart free for 60 days 

How to use this reference

  1. Start with the core file if you need the cross-industry governance baseline.
  2. Choose an industry file for its workflow fields and permitted values.
  3. Match the OTel attributes to the policy paths your rules use, then verify the recorded fields in a test session.

Catalog context

Start with a bounded workflow such as outage review or maintenance planning. Record the requested action, responsible operator, and confirmed result.

Risk note: Preserve operational safety and access controls outside the tracing system. Assess critical-infrastructure requirements against the affected assets and intended use of the AI system.

Vocabulary file

  • Download filename: 08_vertical_energy_utilities.json
  • Kind: vertical

OTel namespaces

energy

Referenced standards

These references explain the catalog's context. A listed standard does not establish that a configured application meets its requirements.

  • IEC 61968, Application Integration at Electric Utilities, System Interfaces for Distribution Management
  • IEC 61970, Energy Management System Application Program Interface (EMS-API), Common Information Model (CIM)
  • IEC 61850, Communication Networks and Systems for Power Utility Automation
  • IEC 61400-25, Wind Turbines, Communications for Monitoring and Control
  • IEC 62351, Power Systems Management and Associated Information Exchange, Data and Communications Security
  • NERC CIP v7, Critical Infrastructure Protection Standards (CIP-002 through CIP-014)
  • NERC FAC-001/FAC-002, Facility Connection and Planning Standards
  • NERC EOP-004, Event Reporting
  • OpenADR 2.0b, Open Automated Demand Response (OpenADR Alliance)
  • IEEE 1547-2018, Standard for Interconnection and Interoperability of DERs with Electric Power Systems
  • FERC Order 2222, Participation of Distributed Energy Resource Aggregations in Organized Energy Markets (2020)
  • FERC Order 881, Managing Transmission Line Ratings (2021)
  • FERC Order 3052, Cybersecurity Incentives (2024)
  • ENTSO-E Network Codes, EU transmission network operational standards
  • EU Electricity Directive 2019/944, Internal market for electricity
  • EU Renewable Energy Directive III (RED III) 2023/2413, 42.5% renewable target by 2030
  • EU ETS (Emissions Trading System), EU Allowance Registry under EU ETS Directive 2003/87/EC (as amended)
  • EPA 40 CFR Part 75, Continuous Emissions Monitoring Systems (CEMS)
  • EPA Clean Power Plan / Good Neighbor Rule (2024 revisions)
  • API RP 1173, Pipeline Safety Management Systems
  • PHMSA 49 CFR Part 192/195, Pipeline Safety Regulations
  • AWWA Cybersecurity Guidance, Water sector OT security
  • EPA EPCRA Section 313, Toxic Release Inventory reporting

Source references

Subdomains

SubdomainCategoriesSample attributes
Grid Asset & Outage Management (IEC CIM)4energy.asset.operational_status, energy.switching.state, energy.outage.lifecycle_state
Demand Response & OpenADR3energy.demand_response.event_status, energy.demand_response.curtailment_type, energy.vpp.dispatch_state
NERC CIP Critical Infrastructure Protection3energy.nerc_cip.standard, energy.nerc_cip.bcs_impact_level, energy.nerc_cip.evidence_type
Renewable Energy & DER Management3energy.renewable.asset_type, energy.battery_storage.operation_mode, energy.renewable.forecast_confidence
Energy Market Operations & Settlement3energy.market.product_type, energy.market.bid_offer_status, energy.market.congestion_method
Emissions Monitoring & Environmental Compliance3energy.cems.data_quality_flag, energy.eu_ets.compliance_status, energy.ghg.emission_scope
Pipeline Integrity & Oil and Gas Operations2energy.pipeline.integrity_threat_category, energy.pipeline.anomaly_severity
Water & Wastewater Operations2energy.water.treatment_process_state, energy.water.quality_compliance_status

Implementation examples

  • Grid Asset & Outage Management (IEC CIM): Grid Asset Operational Status. AI energy management agent monitors all BES asset statuses via CIM. 'Forced_outage' on a high-impact asset triggers automatic NERC EOP-004 assessment, initiates restoration workflow, and escalates to grid operations HITL. AI agent may not autonomously re-energise a 'de_energized' asset, crew clearance confirmation required. (Nerc Eop 004: NERC EOP-004, Disturbance reporting: 'forced_outage' on BES elements meeting reporting thresholds must be reported to NERC and regional entity)
  • Grid Asset & Outage Management (IEC CIM): Switching Equipment State. AI distribution management agent executes fault isolation switching sequences. Each switching step is logged with the pre- and post-state. OPA policy blocks AI from closing a 'grounded' switch, crew clearance confirmation from safety system is required first. (Nerc Cip 010: NERC CIP-010, Configuration change management: autonomous AI switching on BES Cyber Systems requires approved change documentation)
  • Grid Asset & Outage Management (IEC CIM): Outage Lifecycle State. AI outage management agent receives outage reports from AMI (Advanced Metering Infrastructure), customer calls, and SCADA alarms. Agent correlates reports, confirms outage boundary, and dispatches crew. OPA policy enforces that 'fully_restored' state requires meter-verified restoration confirmation, not just switch state change.
  • Grid Asset & Outage Management (IEC CIM): Protection Relay Operation Status. AI grid monitoring agent detects relay operation from SCADA and classifies status. 'Reclose_failed_lockout' triggers immediate crew dispatch. 'Protection_inhibited_ai_action' is a critical flag indicating an AI agent has interfered with protection, requires immediate HITL escalation and is a NERC compliance event. (Nerc Prc 023: NERC PRC-023, Transmission relay loadability: relay settings affected by AI optimisation must comply with NERC PRC-023 loadability criteria)

Control ideas

These patterns describe possible controls, not active rules. Confirm applicability, implement the control, and test its effect on the application.

Require operator approval before grid switching

Hold a proposed switching action until an authorized system operator approves it. Keep the authorization with the request to change a bulk electric system asset's energized state.

Regulatory basis: Utility-defined switching authorization and operating procedures.

Enforce nerc cip evidence generation for bcs actions

Require that every AI agent action on a BES Cyber System automatically generates a tagged compliance evidence record linking the action to the applicable NERC CIP standard and requirement ID. Enables automated audit evidence package assembly for NERC Regional Entity compliance audits.

Regulatory basis: NERC CIP-007-6 R4, Log management: access logs must be reviewed within 35 days for high/medium impact BCS; NERC CIP-010-4 R1, Baseline configuration documentation; NERC CIP-013-2 R2, Supply chain risk assessment documentation

Enforce before the action

Pass the request and your business action to this function. The core SDK checks policy before the action runs and again before its result is released. A deny or review decision means the action never runs.

import { Veriproof } from '@veriproof/sdk-core';
import type { GovernedResult, IndustryFact, JsonValue } from '@veriproof/sdk-core';

const veriproof = Veriproof.fromEnv();

export async function runProtectedAction<TInput extends JsonValue, TValue>(
  request: TInput,
  action: (input: TInput, signal: AbortSignal) => Promise<TValue>,
): Promise<GovernedResult<TValue, TInput>> {
  // Catalog values for this vertical. Replace them with facts from the current workflow.
  const industry: IndustryFact[] = [
    { attribute: "energy.asset.operational_status", policyInput: "energy_asset_operational_status", value: "in_service" },
    { attribute: "energy.switching.state", policyInput: "energy_switching_state", value: "closed" },
    { attribute: "energy.outage.lifecycle_state", policyInput: "energy_outage_lifecycle_state", value: "reported" },
  ];

  // Policy runs before action() and again before the result is released.
  // A deny or review decision means action() never runs.
  return veriproof.govern(
    "energy.utilities.evaluate",
    request,
    ({ input, signal }) => action(input, signal),
    { industry },
  );
}
  • Replace the sample values with facts from the current workflow. Rules read them under input.snapshot.industry.
  • Test both permitted and blocked actions. Confirm that a blocked action never reaches your business function.
  • Only completed, completed_with_warning, and transformed results carry a released value.

For review decisions, follow the Human Review guide to configure continuation. Observe remains available when you need to record activity without enforcing a decision.

Set up the Energy & Utilities example. See the API reference for TypeScript, Python, or .NET.

Start your Developer evaluation

Try a simulator to see a governed decision in context. To connect your own workflow, verify your work email and start Developer free for 60 days. You can also review the relevant controls with our team.

Live demo → Start free for 60 days → Request coverage workshop → 

Selected vocabulary categories

GridAssetOperationalStatus

IEC CIM 61970 operational status of a grid asset (generator, transformer, transmission line, substation bus). These values map directly to IEC CIM OperationalLimitSet and Equipment.inService semantics. AI grid management agents must use these values when reading or setting asset status via EMS APIs.

Workflow area: Grid Asset & Outage Management (IEC CIM)

OTel attribute
energy.asset.operational_status
Permitted values
  • in_service
  • out_of_service
  • de_energized
  • planned_outage
  • forced_outage
  • under_maintenance
  • commissioning
  • decommissioned

SwitchingEquipmentState

IEC CIM 61970 / IEC 61850 state of a switching device (circuit breaker, disconnector, load break switch). AI grid switching agents must log every state transition. Autonomous switching on BES assets without HITL authorisation is a NERC CIP-010 change management violation.

Workflow area: Grid Asset & Outage Management (IEC CIM)

OTel attribute
energy.switching.state
Permitted values
  • closed
  • open
  • grounded
  • locked_open
  • locked_closed
  • transiting
  • unknown
  • fault_interrupt

OutageLifecycleState

Outage Management System (OMS) lifecycle state for a grid outage event. AI outage management agents track outages from initial report through restoration confirmation. Maps to IEC CIM 61968 Outage and PlannedOutage class state semantics.

Workflow area: Grid Asset & Outage Management (IEC CIM)

OTel attribute
energy.outage.lifecycle_state
First 8 permitted values
  • reported
  • confirmed
  • crew_en_route
  • crew_on_site
  • isolating
  • restoring
  • partially_restored
  • fully_restored

ProtectionRelayOperationStatus

Status of a protection relay operation as logged by AI grid monitoring agents. Protection relay events are among the highest-priority signals for grid operators, AI agents must never suppress or delay relay operation notifications.

Workflow area: Grid Asset & Outage Management (IEC CIM)

OTel attribute
energy.protection.relay_operation_status
First 8 permitted values
  • normal_no_operation
  • pickup_condition
  • trip_initiated
  • trip_confirmed
  • reclose_initiated
  • reclose_successful
  • reclose_failed_lockout
  • protection_inhibited_ai_action

DemandResponseEventStatus

OpenADR 2.0b demand response event status. These values map to OpenADR 2.0b oadrRequestEvent and oadrCreatedEvent response states. AI DR orchestration agents (VTN role) must use these values to track event lifecycle.

Workflow area: Demand Response & OpenADR

OTel attribute
energy.demand_response.event_status
First 8 permitted values
  • pending
  • active
  • cancelled
  • completed
  • opt_out_received
  • non_compliance_detected
  • far
  • near

DRResourceCurtailmentType

Type of demand response curtailment or dispatch action requested of a resource. AI DR dispatch agents use this to select the correct control action for each asset type.

Workflow area: Demand Response & OpenADR

OTel attribute
energy.demand_response.curtailment_type
First 8 permitted values
  • load_shed_direct_control
  • load_shed_price_signal
  • hvac_setpoint_adjustment
  • ev_charging_curtailment
  • battery_discharge_dispatch
  • der_export_increase
  • interruptible_load_interrupt
  • industrial_process_delay

VPPDispatchState

Operational dispatch state of a Virtual Power Plant (VPP) or DER aggregation managed by an AI dispatch agent. FERC Order 2222 DER aggregations participating in organised markets must maintain accurate dispatch state for market settlement.

Workflow area: Demand Response & OpenADR

OTel attribute
energy.vpp.dispatch_state
First 8 permitted values
  • standby
  • pre_dispatch_forecasting
  • dispatched_charging
  • dispatched_discharging
  • dispatched_curtailing
  • dispatched_exporting
  • ramping
  • at_target

NERCCIPStandard

NERC CIP v7 standard identifier. AI compliance monitoring agents tag every action on a BES Cyber System with the applicable CIP standard(s) for automated audit evidence collection. Used to link AI agent actions to specific CIP requirements in the compliance evidence package.

Workflow area: NERC CIP Critical Infrastructure Protection

OTel attribute
energy.nerc_cip.standard
First 8 permitted values
  • CIP_002_bes_cyber_system_categorization
  • CIP_003_security_management_controls
  • CIP_004_personnel_and_training
  • CIP_005_electronic_security_perimeter
  • CIP_006_physical_security
  • CIP_007_systems_security_management
  • CIP_008_incident_reporting_response
  • CIP_009_recovery_plans

BESCyberSystemImpactLevel

NERC CIP-002-5.1a BES Cyber System impact level classification. Determines the set of CIP requirements applicable to a BCS asset. AI agents must not take configuration or change actions on high or medium impact BCS assets without meeting CIP-010 change management requirements.

Workflow area: NERC CIP Critical Infrastructure Protection

OTel attribute
energy.nerc_cip.bcs_impact_level
Permitted values
  • high_impact
  • medium_impact
  • low_impact
  • not_bes_cyber_system

CIPComplianceEvidenceType

Type of NERC CIP compliance evidence generated by an AI agent action. AI compliance monitoring agents auto-generate evidence packages; this enum classifies the evidence type for the audit record.

Workflow area: NERC CIP Critical Infrastructure Protection

OTel attribute
energy.nerc_cip.evidence_type
First 8 permitted values
  • access_log_review
  • configuration_baseline_snapshot
  • change_management_record
  • vulnerability_assessment
  • patch_application_record
  • incident_response_activation
  • recovery_plan_test_record
  • supply_chain_vendor_assessment

RenewableEnergyAssetType

Classification of a renewable or distributed energy asset type. AI energy management agents use this to select the correct dispatch model, forecasting algorithm, and regulatory compliance profile for each asset.

Workflow area: Renewable Energy & DER Management

OTel attribute
energy.renewable.asset_type
First 8 permitted values
  • solar_pv_utility_scale
  • solar_pv_distributed_rooftop
  • wind_onshore
  • wind_offshore
  • battery_storage_grid_scale
  • battery_storage_behind_meter
  • hydroelectric_large
  • hydroelectric_run_of_river

BatteryStorageOperationMode

Operating mode of a grid-scale or behind-the-meter battery energy storage system (BESS) as managed by an AI dispatch agent. Mode selection drives inverter control commands and market participation eligibility.

Workflow area: Renewable Energy & DER Management

OTel attribute
energy.battery_storage.operation_mode
First 8 permitted values
  • idle
  • charging_grid
  • charging_renewable_only
  • discharging_arbitrage
  • discharging_peak_shaving
  • discharging_frequency_response
  • discharging_voltage_support
  • discharging_backup_power

This page uses the vocabulary JSON distributed with the documentation. Check its version when comparing it with an installed SDK.

Download the vocabulary JSON for offline review or automated comparisons.

Use the SDK reference for configuration and supported APIs. Keep vocabulary selection separate from the compliance team's assessment of applicable requirements.

Last updated on