> [name=蔡秀吉]<br/>[time=July 21 2023][color=#F4B400]
> 中文翻譯：故障監視管理服務操作流程
> Source：[O-RAN.WG10.O1 Interface.0-R003-v09.00.00](https://drive.google.com/file/d/1dz20YO2JvmL2nzzloOnTYX03NDuZonLN/view?usp=drive_link)

## Fault Supervision Management Services(MnS)
Fault Supervision MnS（翻譯：故障監視管理服務），它允許 Fault Supervision MnS Provider 向 Fault Supervision MnS Consumer 報告錯誤和事件，並允許 Fault Supervision MnS Consumer(SMO) 對 Fault Supervision MnS Provider(ME) 進行故障監視操作(Operation)
例如：獲取警報列表 (Get alarm list)。

## 先備知識
::: warning
SMO 作為 NETCONF client，同時也是 MnS Consumer(MnS 消費者) 提供管理服務。
:::

::: danger
O-RAN 架構中的其他組件 **（如：RIC、O-CU、O-DU、O-RU）** 則被視為 NETCONF Server，並作為 MnS Provider(MnS 的提供者)。
O-RAN NETCONF Server 同時也會被稱之為 Managed Element(ME)
:::

- Stage 1：Fault Supervision MnS 在 [3GPP TS 28.545](https://drive.google.com/file/d/1_Wp1rJg11nyjuIOXupS5Jp9l_2yD4_q_/view?usp=drive_link) 中規定。
- Stage 2：Fault notifications 在 [3GPP TS 28.532](https://drive.google.com/file/d/1scrVhLXjI1ENDtRHHQwO_Eug2DcyWI_-/view?usp=drive_link) 中規定。
- Stage 2：AlarmList IOC 和 AlarmRecord Data Type 在 [3GPP TS 28.622](https://drive.google.com/file/d/1szM-7KG7pqM2jsZLXKYuBCSeVujz3Ncz/view?usp=drive_link)(4.3.27) 中規定。
- Stage 3：[3GPP TS 28.623](https://drive.google.com/file/d/1umkt8kwh9VF10-jXr3seisQO3lDsg5B8/view?usp=drive_link) 中規定了 XML、JSON 和 YANG 的解決方案集(Solution Sets)。

## Fault Notification(故障通知)

### 描述
當警報發生、警報被清除、警報嚴重等級(Severity) 改變時，Fault Supervision MnS Provider 會向 Fault Supervision MnS Consumer 發送非同步故障通知事件。

### 需求
O-RAN 支援下列在 3GPP TS 28.545 第 5.2.5 節中規定的 Fault supervision data report service 需求：

- REQ-FSDR_NF-FUN-1 用於發送警報通知
- REQ-FSDR_NF-FUN-3 用於警報通知訂閱
- REQ-FSDR_NF-FUN-4 用於取消訂閱警報通知
- REQ-FSDR_NF-FUN-6 用於讀取警報列表
- REQ-FSDR_NF-FUN-8 用於透過過濾器讀取警報列表
- REQ-FSDR_NF-FUN-9 用於發送更改的警報通知
- REQ-FSDR_NF-FUN-10 用於發送已清除的警報通知
- REQ-FSDR_NF-FUN-11 用於發送新的警報通知
- REQ-FSDR_NF-FUN-12 用於發送警報列表重建通知

以下在 3GPP TS 28.545 第 5.2.5 節中的需求，在 O-RAN 中是可選的：
- REQ-FSDR_NF-FUN-2 用於為虛擬化資源提供警報
原理：虛擬化資源的警報由 O-Cloud 通過 O2 介面回報。
- REQ-FSDR_NF-FUN-5 用於過濾報告的警報通知
理由：不建議在 NF 級別過濾警報通知。SMO 應接收 NF 生成的所有警報通知。 警報過濾最好在 SMO 上進行。
- REQ-FSDR_NF-FUN-7 用於維護虛擬化資源的警報列表
原理：虛擬化資源的警報由 O-Cloud 通過 O2 介面回報。

### 操作流程(Procedures)
操作流程在 3GPP TS 28.545 第 9.1 節中被定義，請參閱 [O-RAN Fault Notification Procedures](https://hackmd.io/@thc1006/Hkyld085h)

### 操作與通知(Operations and Notifications)
Fault Supervision MnS 的通知，必須採用以下其中一種格式：
- SDO O1 格式
- O1 支援 3GPP TS 28.532 中所規定的 Fault Notification(故障通知)
- VES O1 格式　
- 協調出統一的 VES 事件（如：[VES Event Listener Specification](https://docs.onap.org/projects/onap-vnfrqts-requirements/en/latest/Chapter8/ves_7_2/ves_event_listener_7_2.html) 中所規定的）包含帶有 "**Data**" element 的 stndDefinedFields，其中也包含 O1 支援 3GPP TS 28.532 中所規定的 Fault Notification(故障通知)

O1 有支援以下 3GPP 標準中的故障通知：
- notifyNewAlarm (通知新警報)
- notifyClearedAlarm (通知清除警報)
- notifyAlarmListRebuilt (通知警報列表重建)
- notifyChangedAlarmGeneral and/or notifyChangedAlarm

> 補充：
> - notifyChangedAlarm 僅支援回報嚴重性變化。
> - notifyChangedAlarmGeneral 允許 Producer 在單個通知中回報嚴重性的變化和與此警報相關的任何其他屬性變化。[color=#F4B400]

3GPP TS 28.532 中指定的其他 Fault Notification(故障通知) 是選用的。
原因：O-RAN 目前尚未定義發送這些其他 notifications types 的用例(use cases)。如未來定義了發送其他 notifications types 的用例，O-RAN O1 interface Spec 將會更新。

## 故障監控(Fault Supervision Control)
### 描述
從 3GPP R16 起，[IOC](https://hackmd.io/bbnAMnuISraGJnk56yGnYA?view#3GPP-IOC%E6%98%AF%E4%BB%80%E9%BA%BC%EF%BC%9F) 支援了 Management Services Use Cases 的專用操作，此外，IOC 的屬性可透過通用配置機制(generic provisioning mechanisms) 進行讀取和設定。
針對 Fault Supervision，3GPP TS 28.622 中指定了 AlarmList IOC，用來代表儲存和管理警報記錄的能力。

每個 Fault Supervision MnS Provider 都有一個 AlarmList （警報列表），由 Provider 所創建。而 AlarmList 包含每個活動警報(active alarm)的一個警報記錄(AlarmRecord)。

AlarmList 中的 AlarmRecords 可由 Fault Supervision MnS Consumer 讀取，並可選擇使用過濾器，根據 AlarmRecord 中的屬性值，來檢索特定的 AlarmRecords。
例如：只有被標註為嚴重等級的 AlarmRecord，才會被 Fault Supervision MnS Consumer 檢索到。

AlarmRecord: perceivedSeverity = CRITICAL

### 需求(Requirements)
3GPP TS 28.545 第 5.2.5 節中 Fault supervision data report service 的需求，對於 O-RAN Fault Supervision MnS Provider 是強制性的，這些需求就寫在本文件上面的 [Fault Notification(故障通知)需求](https://hackmd.io/BTi-cM94RWOMCOJ4Sn4_Hw?view#Fault-Notification%E6%95%85%E9%9A%9C%E9%80%9A%E7%9F%A5)

以下來自 3GPP TS 28.545 第 5.2.6 節的 fault supervision data control service 需求，對於 O-RAN Fault Supervision MnS Provider 來說是選用的支援：

- REQ-FSDC_NF-FUN-1 支援警報確認。
理由：沒有用例(use cases) 要求 NF 確認警報。該操作最好在 SMO 完成。如果 NF 不支援來自 MnS Consumer 的警報確認，則 NF 必須將已清除的警報視為已自動確認，以便將其從 AlarmList 中刪除。
- REQ-FSDC_NF-FUN-2 支援手動警報清除。
理由：手動清除警報僅適用於 ADMC（自動檢測、手動清除）警報。如果 NF 支援 ADMC 警報，則應支援此操作。否則不需要。
- REQ-FSDC_NF-FUN-4 支援確認狀態更改通知。
理由：沒有用例要求 NF 確認警報。該操作最好在 SMO 完成。如果 NF 支援警報確認，則應支援此操作。否則不需要。

### 操作流程(Procedures)
- NETCONF protocol 和 YANG data models 用於獲取和設定 AlarmList 中 AlarmRecords 的屬性。
- 有關使用 NETCONF 讀取 MOI 屬性和修改 MOI 屬性的步驟，請參閱 [O-RAN.WG10.O1-Interface.0-R003-v09](https://drive.google.com/file/d/1dz20YO2JvmL2nzzloOnTYX03NDuZonLN/view?usp=drive_link) "Provisioning management services" 的部分。

### 警報列表 IOC 定義(AlarmList IOC Definition)
AlarmList IOC 定義在 [TS 28.622](https://drive.google.com/file/d/1l81TPmWz_jA_V2MQ1mkQ4nRVMIM32_NX/view?usp=drive_link) 第 4.3.26 和 4.3.27 節中指定，屬性定義在第 4.4.1 節中。
AlarmList IOC 的 YANG 解決方案集，在 [TS 28.623](https://drive.google.com/file/d/1umkt8kwh9VF10-jXr3seisQO3lDsg5B8/view?usp=drive_link) 附錄 D.2.9 中提供。

### 建議閱讀的文章
- [3GPP Fault Notification Procedure相關專有名詞](https://hackmd.io/@thc1006/H1zeAAI9h)
- [O-RAN Fault Notification Procedures](https://hackmd.io/@thc1006/Hkyld085h)
- [5G O-RAN Operations and Maintenance (OAM) 功能介紹](https://hackmd.io/@thc1006/S1UNcWlO9)

### 參考資料
- [3GPP TS 28.532 V17.1.1](https://drive.google.com/file/d/1scrVhLXjI1ENDtRHHQwO_Eug2DcyWI_-/view?usp=drive_link)
- [3GPP TS 28.545 V17.0.0](https://drive.google.com/file/d/1_Wp1rJg11nyjuIOXupS5Jp9l_2yD4_q_/view?usp=drive_link)
- [3GPP TS 28.622 V17.1.1](https://drive.google.com/file/d/1l81TPmWz_jA_V2MQ1mkQ4nRVMIM32_NX/view?usp=drive_link)
- [3GPP TS 28.623 V17.2.2](https://drive.google.com/file/d/1umkt8kwh9VF10-jXr3seisQO3lDsg5B8/view?usp=drive_link)

#### 其他資訊
歡迎加入 FB [O-RAN 5G 網路通訊技術 X GDSC] 學術交流社群：https://www.facebook.com/groups/534980718419173

#### 作者資訊（蔡秀吉）
- [e-mail]
- [e-mail]
- https://www.facebook.com/thc1006