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.
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.
How to use this reference
- Start with the core file if you need the cross-industry governance baseline.
- Choose an industry file for its workflow fields and permitted values.
- 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
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
- https://www.tmforum.org/open-digital-architecture/open-apis
- https://www.tmforum.org/resources/specifications/tmf621-trouble-ticket-management-api-user-guide-v5-0-0/
- https://www.tmforum.org/open-digital-architecture/open-apis/product-ordering-management-api-TMF622/v5.0
- https://www.tmforum.org/open-digital-architecture/open-apis/alarm-management-tmf642/
- https://www.3gpp.org/ftp/Specs/archive/28_series/28.541/
- https://www.3gpp.org/ftp/Specs/archive/28_series/28.530/
- https://www.etsi.org/deliver/etsi_gs/ZSM/001_099/002/01.01.01_60/gs_ZSM002v010101p.pdf
- https://www.nist.gov/cyberframework
- https://www.itil.com/
- https://www.itu.int/rec/T-REC-X.733/en
Subdomains
| Subdomain | Categories | Sample attributes |
|---|---|---|
| Trouble Ticket & Service Assurance | 5 | telecom.trouble_ticket.status, telecom.trouble_ticket.severity, telecom.trouble_ticket.type |
| Product Order & Service Provisioning | 4 | telecom.product_order.state, telecom.order_item.action, telecom.service_order.state |
| Network Alarm & Fault Management | 4 | telecom.alarm.severity, telecom.alarm.probable_cause, telecom.alarm.event_type |
| AIOps & Autonomous Network Operations | 4 | telecom.autonomous_network.level, telecom.aiops.action_type, telecom.closed_loop.state |
| 5G Network Slice Management | 3 | telecom.network_slice.instance_state, telecom.network_slice.service_type, telecom.network_slice.sla_violation_type |
| ITIL 4 Change & Problem Management | 4 | telecom.itil.change_category, telecom.itil.change_approval_state, telecom.itil.problem_status |
| Cybersecurity & SOC Operations | 4 | telecom.security.event_kind, telecom.security.nis2_incident_severity, telecom.security.automated_response_action |
| Service Level Management | 2 | telecom.sla.compliance_state, telecom.kpi.performance_class |
| Regulatory Reporting & Outage Notification | 2 | telecom.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, andtransformedresults 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.
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
newacknowledgedin_progresspendingheldresolvedclosedcancelled
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
criticalmajorminorno_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_reportinstallation_requestservice_requestbilling_disputechange_requestqueryincidentproblem
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_criticalp2_highp3_mediump4_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_healautomated_runbook_executedhitl_approved_changeemergency_change_deployedmanual_field_interventiontraffic_reroutingfailover_to_redundant_pathservice_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
acknowledgedin_progressheldpendingcancelledcompletedfailedpartial
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
addmodifydeleteno_changesuspendresumeport_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
acknowledgedin_progressheldpendingcancelledcompletedfailedpartial
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
designingactivatingactiveinactiveterminatingterminated
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
criticalmajorminorwarningindeterminatecleared
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_errorsoftware_program_errorsoftware_program_abnormally_terminatedversion_mismatchconfiguration_or_customization_errorhardware_malfunctionhardware_power_problemhardware_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_alarmenvironmental_alarmequipment_alarmintegrity_violationoperational_violationphysical_violationprocessing_error_alarmquality_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.