Skip to Content

Industry Vocabulary Reference

Telecommunications & IT Operations

Telecommunications and IT operations fields describe service orders, alarms, incidents, network changes, and service levels. Use them to connect a recorded action with its operational context.

v2026.03.1632 enum categories2.2 schema9 subdomains25 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

Begin with a service workflow whose actions and results you can verify. For network changes, record the requested change, approval, execution result, and recovery outcome.

Risk note: Autonomy levels describe operation; they do not establish legal compliance. Confirm reporting thresholds and deadlines for the operator, service, and jurisdiction.

Vocabulary file

  • Download filename: 05_vertical_telecom_it_operations.json
  • Kind: vertical

OTel namespaces

telecom

Referenced standards

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

  • TM Forum Open API v5.0.1, TMF621 Trouble Ticket Management API v5.0.1 (July 2025 patch)
  • TM Forum Open API v5.0, TMF622 Product Ordering Management API v5.0.0
  • TM Forum Open API v4.0, TMF640 Service Activation & Configuration API
  • TM Forum Open API v5.0, TMF641 Service Ordering Management API v5.0.0
  • TM Forum Open API v5.0, TMF642 Alarm Management API v5.0.0
  • TM Forum Open API v4.1, TMF628 Performance Threshold Management API
  • TM Forum Open API v4.0, TMF688 Event Management API
  • TM Forum Autonomous Networks level framework
  • ITU-T X.733 (1992), Alarm Reporting Function; extended by ITU-T X.736 Security Alarms
  • ITU-T M.3400, TMN Network Management Functions
  • 3GPP TS 28.541, 5G NR Network Resource Model (NRM) for Network Slice Management
  • 3GPP TS 28.530, 5G NRM Concepts and Requirements for Network Slice Management
  • 3GPP TS 28.545, Fault Supervision for Network Slices
  • ITIL 4, IT Service Management (Axelos, 2019, current edition)
  • ITIL 4 Change Enablement Practice Guide (Axelos, 2020)
  • ITIL 4 Incident Management Practice Guide (Axelos, 2020)
  • NIST Cybersecurity Framework (CSF) 2.0 (February 2024)
  • NIST SP 800-61 Rev 3, Incident Response Recommendations and Considerations for Cybersecurity Risk Management (April 2025)
  • ETSI ENI 007, Terminology for Experiential Networked Intelligence
  • ETSI ZSM 002, Zero-touch Network and Service Management Reference Architecture (2019)
  • IEEE 802.1Q, VLANs / Bridged Local Area Networks (for network topology context)
  • NERC CIP v7, Critical Infrastructure Protection (applicable to telco/CNI overlap)
  • EU NIS2 Directive (2022/2555), Network and Information Security for essential entities
  • FCC Part 4, Disruptions to Communications (US outage reporting)
  • Ofcom Network Reporting Code (UK), Communications provider outage notifications

Source references

Subdomains

SubdomainCategoriesSample attributes
Trouble Ticket & Service Assurance5telecom.trouble_ticket.status, telecom.trouble_ticket.severity, telecom.trouble_ticket.type
Product Order & Service Provisioning4telecom.product_order.state, telecom.order_item.action, telecom.service_order.state
Network Alarm & Fault Management4telecom.alarm.severity, telecom.alarm.probable_cause, telecom.alarm.event_type
AIOps & Autonomous Network Operations4telecom.autonomous_network.level, telecom.aiops.action_type, telecom.closed_loop.state
5G Network Slice Management3telecom.network_slice.instance_state, telecom.network_slice.service_type, telecom.network_slice.sla_violation_type
ITIL 4 Change & Problem Management4telecom.itil.change_category, telecom.itil.change_approval_state, telecom.itil.problem_status
Cybersecurity & SOC Operations4telecom.security.event_kind, telecom.security.nis2_incident_severity, telecom.security.automated_response_action
Service Level Management2telecom.sla.compliance_state, telecom.kpi.performance_class
Regulatory Reporting & Outage Notification2telecom.regulatory.nis2_reporting_stage, telecom.regulatory.fcc_outage_reporting_stage

Implementation examples

  • Trouble Ticket & Service Assurance: Trouble Ticket Status. An AI triage agent creates a ticket in 'new' state, acknowledges it moving to 'acknowledged', then routes it to an autonomous remediation agent moving to 'in_progress'. If the automated fix requires a change window, the agent transitions to 'held' until the change is approved. (Eu Nis2 Art23: EU NIS2 Article 23, Incident reporting obligations require ticket state to be machine-readable for regulatory timeline tracking (24h early warning, 72h notification))
  • Trouble Ticket & Service Assurance: Trouble Ticket Severity. AI triage agent assigns severity based on affected service, customer count, and revenue impact. Critical severity tickets trigger automatic NIS2 timeline tracking and human escalation. (Eu Nis2 Art23: Severity 'critical' or 'major' tickets affecting essential service must be assessed for NIS2 Article 23 reportability)
  • Trouble Ticket & Service Assurance: Trouble Ticket Type. Security_incident type tickets are routed to the SOC AI agent chain and subject to NIS2/NIST CSF 2.0 incident handling procedures. Problem type tickets engage the problem management AI agent for root cause analysis across related incidents.
  • Trouble Ticket & Service Assurance: Incident Priority. AI incident management agent assigns priority on ticket creation. P1/P2 incidents trigger HITL escalation workflow; P3/P4 permit autonomous runbook execution. (Itil4: ITIL 4 Incident Management Practice, priority matrix based on urgency × impact)

Control ideas

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

Require approval for network remediation

Require human approval for remediation in domains at autonomy level 2 or below. At higher levels, allow automatic execution only for approved runbooks.

Regulatory basis: Operator-defined approval control using TM Forum Autonomous Networks levels as context.

Enforce nis2 incident notification sla

Block an incident from being marked closed or downgraded in severity if NIS2 Article 23 reporting obligations for a significant incident have not been completed. Ensures AI SOC agents cannot bypass regulatory notification timelines.

Regulatory basis: EU NIS2 Directive (2022/2555) Article 23, 24h early warning, 72h incident notification mandatory for essential entity significant incidents

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: "telecom.trouble_ticket.status", policyInput: "telecom_trouble_ticket_status", value: "new" },
    { attribute: "telecom.trouble_ticket.severity", policyInput: "telecom_trouble_ticket_severity", value: "critical" },
    { attribute: "telecom.trouble_ticket.type", policyInput: "telecom_trouble_ticket_type", value: "trouble_report" },
  ];

  // Policy runs before action() and again before the result is released.
  // A deny or review decision means action() never runs.
  return veriproof.govern(
    "telecom.it.operations.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 Telecommunications & IT Operations 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

TroubleTicketStatus

The lifecycle state of a trouble ticket per TM Forum TMF621 v5.0.1. These are the exact status values defined in the TMF621 TroubleTicket resource statusType enum. AI triage and routing agents must use these exact values when setting or reading ticket status via the TMF621 API.

Workflow area: Trouble Ticket & Service Assurance

OTel attribute
telecom.trouble_ticket.status
Permitted values
  • new
  • acknowledged
  • in_progress
  • pending
  • held
  • resolved
  • closed
  • cancelled

TroubleTicketSeverity

Severity of the trouble ticket per TMF621. Drives AI escalation logic, SLA timers, and NOC escalation paths. Critical and major tickets must trigger immediate human-in-the-loop notification under NIS2 for incidents affecting essential services.

Workflow area: Trouble Ticket & Service Assurance

OTel attribute
telecom.trouble_ticket.severity
Permitted values
  • critical
  • major
  • minor
  • no_impact

TroubleTicketType

The classification of the trouble ticket per TMF621. Determines routing logic, responsible team assignment, and which AI remediation agents are eligible to handle it.

Workflow area: Trouble Ticket & Service Assurance

OTel attribute
telecom.trouble_ticket.type
First 8 permitted values
  • trouble_report
  • installation_request
  • service_request
  • billing_dispute
  • change_request
  • query
  • incident
  • problem

IncidentPriority

ITIL 4 incident priority matrix values, combining urgency and impact. Used by AI incident management agents to set escalation timers and determine whether automated resolution is permitted.

Workflow area: Trouble Ticket & Service Assurance

OTel attribute
telecom.incident.priority
Permitted values
  • p1_critical
  • p2_high
  • p3_medium
  • p4_low

ServiceRestorationMethod

The method used to restore service after a fault. AI remediation agents must log the restoration method to support post-incident review and SLA reporting.

Workflow area: Trouble Ticket & Service Assurance

OTel attribute
telecom.incident.restoration_method
First 8 permitted values
  • autonomous_self_heal
  • automated_runbook_executed
  • hitl_approved_change
  • emergency_change_deployed
  • manual_field_intervention
  • traffic_rerouting
  • failover_to_redundant_path
  • service_migration_to_backup_node

ProductOrderState

The lifecycle state of a product order per TM Forum TMF622 v5.0. These are the exact productOrderStateType values in the TMF622 ProductOrder resource. Agentic provisioning agents must use these exact values when reading or setting product order state via the TMF622 API.

Workflow area: Product Order & Service Provisioning

OTel attribute
telecom.product_order.state
Permitted values
  • acknowledged
  • in_progress
  • held
  • pending
  • cancelled
  • completed
  • failed
  • partial

OrderItemAction

The action type for an individual order item within a product order per TM Forum TMF622. Determines what the provisioning agent must do for each product line item.

Workflow area: Product Order & Service Provisioning

OTel attribute
telecom.order_item.action
Permitted values
  • add
  • modify
  • delete
  • no_change
  • suspend
  • resume
  • port_out

ServiceOrderState

The lifecycle state of a service order per TM Forum TMF641 v5.0. Mirrors TMF622 ProductOrder state at the service layer; used when orchestrating multi-domain service provisioning via the OSS.

Workflow area: Product Order & Service Provisioning

OTel attribute
telecom.service_order.state
Permitted values
  • acknowledged
  • in_progress
  • held
  • pending
  • cancelled
  • completed
  • failed
  • partial

ProvisioningActivationState

Service activation state per TM Forum TMF640 Service Activation & Configuration API. Used by AI service activation agents to track service configuration lifecycle.

Workflow area: Product Order & Service Provisioning

OTel attribute
telecom.provisioning.activation_state
Permitted values
  • designing
  • activating
  • active
  • inactive
  • terminating
  • terminated

NetworkAlarmSeverity

Alarm perceived severity per ITU-T X.733 Section 8.1.2.3 and TM Forum TMF642 perceivedSeverityType. These are the exact ITU-T/TMF642 values. AIOps agents must use these when processing alarms from NMS/EMS systems.

Workflow area: Network Alarm & Fault Management

OTel attribute
telecom.alarm.severity
Permitted values
  • critical
  • major
  • minor
  • warning
  • indeterminate
  • cleared

AlarmProbableCause

Probable cause categories for network alarms per ITU-T X.733 and extended by TMF642. AIOps root cause analysis agents use these values to classify the root cause hypothesis and trigger appropriate remediation runbooks.

Workflow area: Network Alarm & Fault Management

OTel attribute
telecom.alarm.probable_cause
First 8 permitted values
  • software_error
  • software_program_error
  • software_program_abnormally_terminated
  • version_mismatch
  • configuration_or_customization_error
  • hardware_malfunction
  • hardware_power_problem
  • hardware_resource_exhausted

AlarmEventType

Alarm event type categories per ITU-T X.733 Section 8.1.2.1. Classifies the broad category of fault at the first level of alarm taxonomy. Used by AI alarm correlation to route to the appropriate specialist analysis agent.

Workflow area: Network Alarm & Fault Management

OTel attribute
telecom.alarm.event_type
First 8 permitted values
  • communications_alarm
  • environmental_alarm
  • equipment_alarm
  • integrity_violation
  • operational_violation
  • physical_violation
  • processing_error_alarm
  • quality_of_service_alarm

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