Juniper NETWORKS NETCONF 和 YANG API 軟體使用者指南

本文檔的目的
本文檔介紹如何透過控制中心 NETCONF 和 YANG API 將 Paragon Active Assurance 與網路服務編排器整合。親身實踐的前任amp文件給出了所涉及的主要任務，包括：建立和部署虛擬測試代理程式、運行測試和監視器以及從這些活動中檢索結果。
在本文檔中，免費提供的 Python NETCONF 用戶端 ncclient 用作協調器的角色。

慣例
本文檔中使用以下縮寫：

縮寫	意義
命令列介面	命令列介面
EM	元素管理器
ES	錯誤第二
環境保護部	MEG（維護實體群組）端點（ITU-T Y.1731 定義）或維護端點（思科定義）
網路功能虛擬化	網絡功能虛擬化
NFVO	網路功能虛擬化編排器
國家標準發展局	網路服務描述符
遠程過程調用	遠程過程調用
啜飲	會話發起協議
SLA	服務等級協定
S-VNFM	特別VNF管理器
虛擬網路功能	虛擬網路功能
虛擬TA	虛擬測試代理

關於向後相容性的說明

在 NETCONF & YANG API 2.35.4/2.36.0 版本中，某些請求的驗證更加嚴格，以遵守 NETCONF 標準。這意味著基於本指南舊版本的客戶端程式碼現在可能會被拒絕。
對於前ample，在之前的 Python ex 中amp在檔案代碼中，未提供名稱空間屬性。現在，每當您想要修改 ConfD 資源時，都需要在請求 XML 中提供命名空間。

先決條件和準備工作

ConfD安裝
ConfD（Tail-f 的產品）用作 Paragon Active Assurance 系統和 NETCONF 之間的中介。 ConfD 將 Paragon Active Assurance 設定和操作資料連接到 NETCONF 和 YANG API。
ConfD 應與控制中心軟體一起安裝，如安裝指南中所述。

驗證 ConfD 是否正在運行
若要驗證 ConfD 是否已啟動並正在執行，請執行以下命令
ssh-s @localhost -p 830 網路配置
檢查 ConfD 在連接埠 830 上是否有回應。在命令中，由 netconf 使用者建立定義
安裝指南中安裝 ConfD 部分中的指令。給出由同一指令定義的密碼。
在輸出中，驗證是否包含控制中心模組。輸出應包含如下行：
http://ncc.netrounds.com?module=netrounds-ncc&修訂=2017-06-15

將配置資料庫與控制中心同步

最後，我們需要透過NETCONF更新來配置資料庫。我們將在這裡透過名為 ncclient（NETCONF 用戶端）的 Python 程式庫來完成此操作。然而，只要使用 NETCONF/YANG 協議，該任務也可以用不同的程式語言來完成。
ncclient 的作用是充當託管 NETCONF/YANG API 的 ConfD 伺服器的客戶端。

值得指出的是，ncclient 與控制中心（以前的“Netrounds Control Center”）沒有任何關係，儘管名稱恰好以“ncc”開頭。
以下是安裝 ncclient 的方法：

從以下位置下載軟體 https://github.com/ncclient/ncclient.
執行此命令：pip install ncclient

我們現在可以如下執行同步。請注意，這需要在單獨的電腦上完成，而不是在控制中心伺服器本身上完成：

#
＃筆記：
# 此腳本充當 NCC 伺服器上執行的 ConfD 的客戶端。
# 它將使用 NETCONF/YANG API 進行通訊。

筆記：每當獨立於 NETCONF 安裝和註冊測試代理程式時，也需要執行此程序。請參閱“結束”部分中的註釋view 有關詳細信息，請參閱第 17 頁的「測試代理編排」。

設定多個 NETCONF 控制的 Paragon Active Assurance 帳戶

只有當您希望設定更多 Paragon Active Assurance 帳戶以由 NETCONF 控制時，除了安裝指南「安裝 ConfD」部分中以這種方式配置的帳戶外，才需要執行下列步驟。
對於每個此類帳戶，請執行以下操作：

在控制中心中，登入帳戶並導覽至帳戶 > 權限。

新增用戶“confd@netrounds.com“，並透過點擊“邀請”按鈕在 GUI 中授予此 ConfD 使用者管理員權限。
依照第 4 頁的「將設定資料庫與控制中心同步」部分所述，將設定資料庫與控制中心同步。
現在您應該能夠使用相同 ConfD 使用者控制多個 Paragon Active Assurance 帳戶。

筆記：一旦您開始透過 ConfD 控制 Paragon Active Assurance 帳戶，您不得透過 web 關於任何「可設定」的 Paragon Active Assurance 功能的 GUI（請參閱第 9 頁上的「Paragon Active Assurance 支援的功能」一章）。如果這樣做，將會導致同步遺失。

NETCONF編排API簡介

超過view

第三方 NFVO 或服務編排器通常是使用控制中心 API 啟動測試和監控會話的元件。此協調器還從測試代理活動中檢索聚合的測量結果。效能 KPI 可以由第三方效能管理系統檢索，而事件（一旦由控制中心中設定的閾值違規觸發）可以傳送到第三方故障管理系統。
總而言之，下圖顯示了 Paragon Active Assurance 如何與 OSS 環境中的其他第三方系統互動。

NFVO/服務編排器：指示 VNF 管理器部署 vTA 並將 Paragon Active Assurance 配置到服務鏈中。服務啟動後，編排器使用控制中心的 API 來觸發服務啟動測試並檢索通過/失敗結果。如果測試通過，編排器將使用控制中心的 API 開始主動監控服務。協調器或單獨的績效管理平台可以連續檢索監控中的 KPI。
控制中心：依照 NFVO 或服務編排器的指示部署、擴展和終止 vTA。

績效管理系統或服務品質管理系統：透過控制中心 API 從主動監控中讀取 KPI。
故障管理系統：如果違反 SLA，則從控制中心接收 NETCONF、SNMP 或電子郵件通知。

Paragon Active Assurance 中概念的定義

測試代理：在 Paragon Active Assurance 系統中執行測量（用於測試和監控）的元件。測試代理由能夠產生、接收和分析真實網路流量的軟體組成。
本文檔中討論的測試代理程式類型是虛擬測試代理程式 (vTA)，它是部署在虛擬機器管理程式上的虛擬網路功能 (VNF)。也存在其他類型的測試代理程式。

Paragon Active Assurance 有兩種基本類型的測量：測試和監控。
測試：測試由一個或多個步驟組成，每個步驟都有指定的有限持續時間。步驟按順序執行。每個步驟可能需要同時執行多個任務。

監視器：監視器沒有指定的持續時間，但無限期地執行。就像測試中的一個步驟一樣，監視器可以執行多個並發任務。
範本：當 Paragon Active Assurance 由協調器控制時，測試和監控始終透過定義測試或監控的範本來執行。參數設定可以在運行時作為輸入傳遞給模板。

自動化工作流程
設計時間

在設計時，您可以透過在 Paragon Active Assurance 中建立測試和監視器模板來準備測量。第 15 頁的「測試和監控範本」一章介紹如何執行此操作。

運行時
在運行時，您設定設備並執行實際測量。

一個結束view 所有前任中amp給出的檔案可以在「Examp「透過 NETCONF 和 YANG API 控制 Paragon Active Assurance 的檔案」（第 15 頁）。
如何部署和配置測試代理將在“Ex”一章中介紹amp第 16 頁上的「測試代理」。

如何匯入庫存商品（例如 TW）AMP 反射板和 IPTV 頻道在「Ex」章節中詳細介紹amp第 29 頁上的「文件：庫存項目」。
如何配置警報在“Ex”一章中進行了說明amp第 35 頁上的「警報：警報」。

「Ex」章節中介紹如何透過 NETCONF 執行 Paragon Active Assurance 範本來執行測試和監控。amp第 43 頁上的「les：測試」和「Examp第 54 頁上的「檔案：監視器」。

Paragon Active Assurance 支援的功能

Paragon Active Assurance 中的所有測試和監控類型都可以透過使用範本來建立和執行。應用程式內說明中的「測試和監視器」>「建立範本」下介紹如何執行此操作。

目前不支援建立 Paragon Active Assurance 帳戶；然而，將為使用者設定一個或多個預定義帳戶。
下表詳細介紹了此版本中 Paragon Active Assurance 的可用功能，以及這些功能在 YANG 中的表示方式。

YANG 結構解釋

為了方便起見，這裡給出了特徵表中引用的 YANG 結構的定義。

Config (config=true)：配置數據，將系統從一種狀態轉換為另一種狀態所需的。
狀態（config = false）：狀態資料：系統上非配置資料的附加數據，例如唯讀狀態資訊和收集的統計資料。
RPC：遠端過程調用，在 NETCONF 協定中使用。
通知：從NETCONF伺服器傳送到NETCONF客戶端的事件通知。

可用於編排的 Paragon Active Assurance 功能表
資源：監控
YANG 路徑：/accounts/account/monitor

特徵	子特徵	陽構造
建立/修改/刪除監視器	基於監控模板	配置
啟動/停止監視器	–	配置
監控模板	列出具有輸入的現有監視器模板	狀態
NETCONF 通知	警報狀態改變	通知
監控結果	頂級 SLA/ES 計數器 (%) 任務等級的 SLA/ES 計數器 (%)	狀態

與測試不同（比較下面的資源：測試），監視器不是透過 RPC 啟動，而是透過提交監視器配置來啟動。
資源：測試
YANG 路徑：/accounts/account/tests

特徵	子特徵	陽構造
開始測試	基於測試模板	遠程過程調用
管理測試	列出測試及其狀態	狀態
測試模板	列出具有輸入的現有測試模板	狀態
NETCONF 通知	測試狀態已更改	通知
測試結果	取得測試步驟狀態（通過、失敗、錯誤…）	狀態

資源：測試代理
陽路：

/accounts/account/test-agents（設定）
/accounts/account/registered-test-agents（州）

/accounts/account/test-agents 下的測試代理程式是在帳戶中設定的測試代理程式。編排器只能透過 NETCONF 在測試和監控中設定和使用這些測試代理程式。
配置測試代理程式並將其註冊到帳戶後，測試代理程式將顯示在 /accounts/account/registered-test-agents 下。您可以在 NETCONF 中使用「get」指令找到所有已註冊的測試代理程式（比較章節 Examp萊斯：測試代理）。
在 /accounts/account/registered-test-agents 下，您也可能會找到尚未設定的測試代理程式。任何此類測試代理程式都必須在使用之前進行配置。
在編排場景中，通常建議您透過 NETCONF 進行 Paragon Active Assurance 帳戶的所有配置。這確保了測試代理和註冊測試代理不會出現分歧。

特徵	子特徵	陽構造
在伺服器上預先建立測試代理	–	配置
配置離線測試代理	（控制中心將配置推送到測試代理當它上線時）	配置
使用現有/外部配置的測試代理	用於測試/監控	配置
	配置接口	配置
	獲取狀態	狀態
配置測試代理程式（僅限測試設備）	配置NTP	配置
	設定網橋	配置
	配置VLAN介面	配置
	配置SSH密鑰	配置
	IPv6	配置
實用程式	重新啟動	遠程過程調用
	更新	遠程過程調用
NETCONF 通知	在線狀態發生變化	通知
地位	取得系統狀態（正常運作時間、記憶體使用情況、平均負載、版本）	狀態

資源：庫存
YANG 路徑：/accounts/account/twamp- 反射器

支援的 NETCONF 功能

下表指向描述用於 Paragon Active Assurance 編排目的的 NETCONF 功能的 IETF RFC。

ietf-netconf.yang
IETF RFC 6241，網路設定協定 (NETCONF)， https://tools.ietf.org/html/rfc6241
唯一支援的錯誤處理方法是錯誤時回滾。
唯一支援的資料儲存是可寫入的運行。
ietf-netconf-notifications.yang
IETF RFC 5277、NETCONF 事件通知、 https://tools.ietf.org/html/rfc5277

測試和監控模板
測試和監控類型的範本需要透過 Paragon Active Assurance 前端使用者介面手動設定。應用程式內說明中的「測試和監視器」>「建立範本」下介紹如何執行此操作。

Examp透過 NETCONF 和 YANG API 控制 Paragon Active Assurance 的文件

在接下來的章節中，假設已根據第 15 頁「測試和監控模板」一章中給出的說明定義了合適的測試和監控模板。

防爆中使用的工具amp萊斯
所有的前任amp後續章節中的文件是使用以下免費工具建立的：

Pang：用於視覺化和瀏覽YANG模型。
可用於 https://github.com/mbj4668/pyang （從 git 克隆並運行 python setup.py install）。
Python NETCONF 用戶端「ncclient」：用於使用 NETCONF 與控制中心通訊。

可在 https://github.com/ncclient/ncclient 取得（執行 pip install ncclient）。
根據安裝指南安裝 ConfD 後，可在 /opt/netrounds-confd 中找到 netrounds-ncc.yang 資料模型。

超過view 已執行的關鍵任務

（下面也舉例說明了一些進一步的任務。）

第 16 頁上的“建立和部署新的測試代理”
第 29 頁上的“建立庫存項目（例如反射器）”
第 35 頁的“設定警報範本以及向何處發送警報”

第 45 頁上的“建立並執行測試”
第 50 頁上的“檢索測試結果”
第 60 頁上的“啟動監測器（包括警報設定）”
第 67 頁上的“檢索顯示器的 SLA 狀態”
「與 tags” 第 71 頁

Examp萊斯：測試代理

超過view 測試代理編排
Paragon Active Assurance 中的測試代理程式在編排情境中被視為「設定」。這意味著測試代理程式的建立、控制和刪除應透過協調器和 NETCONF 完成，而不是透過 Paragon Active Assurance GUI 完成。
重要提示：如果技術人員在未先透過 NETCONF 和 YANG API 建立的情況下安裝測試代理程式並註冊到控制中心，則測試代理程式將不存在於組態資料庫中，且系統將不同步。在這種情況下，為了使 ConfD 能夠識別測試代理，需要與控制中心執行新的同步，如第 4 頁的「將配置資料庫與控制中心同步」一節中詳細介紹的。

因此，虛擬測試代理程式 (vTA) 的編排應該按以下步驟完成：

使用控制中心的 NETCONF 和 YANG 介面建立虛擬測試代理，包括其介面配置。測試代理的名稱將是其唯一的密鑰。
在虛擬化平台上部署vTA。請按照線上幫助中測試代理 > 安裝下的說明進行操作。使用 cloud-init 使用者資料將允許 vTA 連接到控制中心的基本介面配置以及身份驗證憑證提供到 vTA 中。
vTA 啟動後，它將使用加密的 OpenVPN 連線自動連線到控制中心。由於 vTA 的 test-agent-statuschange 參數的值現在已更改為“在線”，因此發送了 NETCONF 通知。
筆記：由於 vTA 的名稱是其在控制中心中的標識符，因此該名稱必須與第 1 頁「步驟 17」中控制中心中定義的名稱相同。
一旦 vTA 連接到控制中心並通過身份驗證，介面設定就會推送到 vTA。這是在控制中心建立 vTA 時第 1 頁的「步驟 17」中提供的介面配置。

在 vTA 達到其目的後，刪除 vTA。

建立和部署新的測試代理

我們首先需要使用控制中心的 NETCONF & YANG 介面建立一個測試代理程式。以這種方式建立測試代理程式時，不需要與控制中心同步。
測試代理的 YANG 模型如下圖所示。它作為命令的輸出獲得
pyang -f 樹 netrounds-ncc.yang
完整的 YANG 模型在第 81 頁的「附錄：完整 YANG 模型的樹狀結構」中給出，其中還包含一個圖例，解釋了本文檔中本文檔和其他 YANG 模型插圖中使用的約定。

我們按照以下步驟進行，詳細資訊如下：

一開始，Paragon Active Assurance 帳戶「演示」的庫存中沒有測試代理程式。
使用 ncclient 建立名為「vta1」的測試代理程式。此時此刻tage、尚不存在真正的測試代理（即尚未啟動）。
測試代理部署在 OpenStack 中。（此處選擇在該平台上進行部署作為其中一種可能性。）

測試代理連接到控制中心帳戶“演示”，現在可供使用。
步驟 1：一開始，帳戶「demo」中沒有測試代理程式。請參閱下面的控制中心 GUI 螢幕截圖。步驟 2：使用 Python NETCONF 用戶端「ncclient」在控制中心建立測試代理程式。下面是 ncclient 程式碼，用於建立一個測試代理，該測試代理程式具有一個帶有 DHCP 位址的實體介面：

導入argparse
來自 ncclient 導入管理器
parser = argparse.ArgumentParser(description='測試建立測試代理程式')
parser.add_argument('–host', help='找到 ConfD 的主機名稱', required=True)
parser.add_argument('–port', help='連接ConfD的連接埠', required=True)
parser.add_argument('–username', help='連接ConfD的使用者名稱', required=True)
parser.add_argument('–password', help='ConfD 帳號密碼', required=True)
parser.add_argument('–netrounds-account', help='NCC 帳戶簡稱', required=True)
parser.add_argument('–test-agent-name', help='測試代理名稱', required=True)
args = parser.parse_args()
與 manager.connect(host=args.host, port=args.port, username=args.username,
密碼=args.password，hostkey_verify=False）作為m：
# 在控制中心建立測試代理
xml =“””

)print m.edit_config(target='running', config=xml)

筆記：後面的 ex 中省略了 manager.connect(…) 前面的程式碼ample 程式碼片段。
eth0上配置了NTP伺服器，eth0也是管理介面（即連接Control Center的介面）。
測試代理應用程式目前不允許配置介面。因此，從版本 2.34.0 開始，可以省略 YANG 模式中的介面配置。因此，在這種情況下，對應的 XML 得到了極大的簡化：建立測試代理後，它就會存在於配置資料庫和控制中心中。請參閱下面的測試代理清單螢幕截圖，顯示測試代理「vta1」：

步驟 3：現在是時候在 OpenStack 中部署測試代理程式「vta1」了。
測試代理將使用 cloud-init 使用者資料來檢索有關如何連接到控制中心的資訊。具體來說，用戶數據文本 file 具有以下內容（請注意，#cloud-config 和 netrounds_test_agent 行必須存在，且其餘行必須縮排）：

有關更多信息，請參閱文件如何在 OpenStack 中部署虛擬測試代理程式。
部署測試代理程式並連接到控制中心後，設定將從控制中心推送到測試代理程式。

步驟 4：測試代理現已在控制中心上線並已取得其配置。測試代理已準備好用於測試和監控。請參閱以下部分：

第 45 頁上的“開始測試”
第 60 頁上的“啟動監視器”

在您的 Paragon Active Assurance 帳戶中列出測試代理
下面是前ample ncclient 用於列出 Paragon Active Assurance 帳戶中的測試代理程式的 Python 程式碼：

運行此程式碼會得到如下所示的輸出：

刪除測試代理
測試完成後，在某些用例中可能需要刪除測試代理程式。
下面的程式碼片段顯示如何使用 ncclient 執行此操作：

NETCONF 通知
下面，我們介紹一個簡單的例子amp用於偵聽來自控制中心的所有傳入 NETCONF 通知的文件腳本。每當發生某些事件（例如測試代理離線或使用者啟動的測試完成）時，就會發送這些通知。根據通知中攜帶的信息，使用者可以在編排器中分配自動後續操作。

當執行上述腳本時，NC 用戶端將以結構化 XML 形式呈現收到的通知。見前任amp下面的檔案輸出顯示測試代理程式意外離線。

2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
示範
HW1
離線

Examples：庫存項目

建立（導入）和管理庫存項目，例如 TWAMP 反射器和 Y.1731 MEP 的完成方式與測試代理類似。以下是 XML 和 NETCONF 程式碼，用於透過 NETCONF 和 YANG API 在 Paragon Active Assurance 中定義此類實體並擷取所定義項目的清單。

創建 TWAMP 反射鏡

創建 Y.1731 MEP

建立 IPTV 頻道

建立 Ping 主機

建立 SIP 帳戶

檢索庫存物品
以下是用於檢索帳戶中定義的所有庫存項目的 Python 程式碼。（這裡一次獲取所有類型的庫存項目，以避免文件中出現重複。當然，可以通過省略下面帳戶下的一些行來獲取庫存項目的任何子集。）

運行此程式碼會得到如下所示的輸出：

Examp萊斯：警報

警報範本和關聯項目（SNMP 管理器、警報電子郵件清單）的建立和管理方式與庫存項目類似。本章包含 XML 和 NETCONF 程式碼，用於透過 NETCONF 和 YANG API 在 Paragon Active Assurance 中定義此類實體以及擷取已定義項目的清單。
警報電子郵件列表
建立警報電子郵件列表

檢索所有警報電子郵件列表

SNMP 管理器
建立 SNMP 管理器

檢索所有 SNMP 管理器

警報模板
建立警報模板

檢索所有警報模板

Examp萊斯：SSH 金鑰

您可以透過 NETCONF 和 YANG API 將 SSH 公鑰新增至測試代理程式。使用對應的私鑰，您可以透過 SSH 登入測試代理程式。
SSH 金鑰上可用操作的完整清單如下：

新增 SSH 金鑰
修改 SSH 金鑰
檢查 SSH 金鑰
列出 SSH 金鑰
刪除 SSH 金鑰。
下面以新增和刪除操作為例。

新增 SSH 金鑰

以下是建立新 SSH 金鑰的方法。

刪除 SSH 金鑰
如果要刪除 SSH 金鑰，請使用下列命令：

Examp萊斯：測試

此處假設已根據第 17 頁上的「建立和部署新測試代理」部分建立了測試代理程式（測試所需的數量）。
YANG 測試模型路徑

物品	YANG模型路徑：/accounts/account/tests …
測試	/.
測試[id]	/測試
id	/測試/id
姓名	/測試/名稱
地位	/測試/狀態
開始時間	/測試/開始時間
末日	/測試/結束時間
報告-url	/測試報告-url
步驟	/測試/步驟
步驟[id]	/測試/步驟/步驟
姓名	/測試/步驟/步驟/名稱
id	/測試/步驟/步驟/id
開始時間	/測試/步驟/步驟/開始時間
末日	/測試/步驟/步驟/結束時間
地位	/測試/步驟/步驟/狀態
狀態訊息	/測試/步驟/步驟/狀態訊息
範本	/模板
模板[名稱]	/模板/模板
姓名	/模板/模板/名稱
描述	/模板/模板/描述
參數	/模板/模板/參數
參數[鍵]	/模板/模板/參數/參數
鑰匙	/模板/模板/參數/參數/鍵
類型	/模板/模板/參數/參數/類型

測試編排的先決條件

為了使用 NC 用戶端透過 NETCONF 啟動測試，需要先使用控制中心 GUI 建立測試模板，如「測試和監視器」>「建立模板」下的應用程式內說明中詳細說明。在編排測試範本的啟動時，在此範本中指定為「範本輸入」的所有欄位都需要作為 XML 中的參數。

在 Paragon Active Assurance 中執行測試被視為編排上下文中的「狀態」。狀態數據是不可寫的數據，不儲存在配置資料庫中，與「關於配置」部分中提到的配置數據相反view 第 17 頁上的「測試代理程式編排」。這基本上意味著對控制中心 GUI 中的測試或範本的變更不會導致控制中心和組態資料庫之間出現任何與同步相關的問題。
獲取報告-URL 在測試報告中，您需要確保控制中心 URL 已正確配置。這是在 file /opt/netrounds-confd/settings.py。預設情況下，控制中心主機名稱是使用 socket.gethostname() 檢索的：請參閱下文。如果這不能產生正確的結果，您需要設定主機名稱（或整個 URL）在此手動 file.

# URL 控制中心的不含尾部斜線。
# 這是給前任的amp測試報告中使用的le-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % 主機名
開始測試
如第 17 頁「建立和部署新測試代理」部分所述，執行指令 pang -f tree netrounds-ncc.yang
從目錄 /opt/netrounds-confd/ 中輸出 YANG 模型。在此模型中，使用 NC 用戶端啟動測試的 RPC 如下所示：

有關說明，請參閱部分 第 81 頁的“圖例” 在附錄中。

其步驟如下圖所示：

測試代理程式已註冊至 Paragon Active Assurance 帳戶，但尚未開始測試。
所需的輸入參數在將運行的測試模板中標識。

使用 ncclient 開始 60 秒的 HTTP 測試。

步 1：一開始，Paragon Active Assurance 帳戶中尚未啟動任何測試。請參閱下面的控制中心 GUI 螢幕截圖。
步 2：我們將在本例中用於啟動測試的模板ample 是一個 HTTP 測試模板。它有兩個強制輸入欄位（客戶和 URL）我們在控制中心 GUI 中建置範本時已指定。

我們將在由 NETCONF 管理器 (ncclient) 傳送到配置資料庫的 XML 配置中定義這些參數（以及其他參數）。
步驟3：使用ncclient發起HTTP測試。
下面是前amp文件代碼，其中為 HTTP 測試模板指定所需的配置資訊和參數。根據模板的建構方式，此處的詳細資訊可能會有所不同。
對於每個參數，需要提供屬性。密鑰與參數的相同
控制中心中的變數名稱。您可以如下檢查變數名稱：

點擊側欄上的測試並選擇新測試序列。

點擊我的模板。
點擊感興趣的模板下方的編輯連結。
點選右上角的編輯輸入按鈕。

在我們的前任amp文件，預設情況下，變數名稱只是控制中心中顯示名稱的小寫版本（“url” 與 “URL“， ETC。）。但是，在控制中心 GUI 中，您可以將變數重新命名為您喜歡的任何名稱。
除了鍵之外，每個參數都需要指定其類型：例如amp樂，為了 URL.
請注意，您需要重新view 完整的 YANG 模型以獲得有關類型的完整資訊。對於測試代理接口，類型具有更複雜的結構，如下所示在下面的程式碼中。

我們現在可以使用 ncclient 來執行該腳本。假設一切正確，測試將啟動並在控制中心顯示其執行情況：如果測試成功啟動，控制中心將傳回測試 ID。在這個前ample，測試ID為3：測試 ID 也可以在 URL 用於在控制中心 GUI 中進行測試。在這個前amp勒那個 URL 是 https://host/demo/testing/3/。
檢索測試結果
檢索測試結果最直接的方法是指向測試 ID。
以下是取得上述 ID = 3 的 HTTP 測試結果的 Python 程式碼：
與經理。連線（主機=args.host，連接埠=args.port，使用者名稱=args.username，密碼=args.password，hostkey_verify=False）為m：

輸出將如下所示：

匯出和匯入測試模板
測試範本可以以 JSON 格式匯出，並以該格式重新匯入控制中心。如果您想在控制中心的不同安裝中使用測試模板，這非常有用。（模板的初始創建最好透過控制中心 GUI 來處理。）
以下是執行匯出和匯入的程式碼。
匯出測試模板

# 從回應中取得json配置
root = ET.fromstring(response._raw)
json_config = 根[0].text
列印 json_config
該模板包含在 json_config 物件中。
導入測試模板
可以將包含測試範本的 JSON 配置物件重新匯入到控制中心，如下所示。

Examp萊斯：監視器

本節假設已根據第 17 頁上的「建立和部署新測試代理」部分建立了測試代理程式（監視器所需的數量）。
監視器的 YANG 模型路徑

物品	YANG模型路徑：/accounts/account/monitors …
監視器	/.
監視器[名稱]	/監視器
姓名	/監視器/名稱
描述	/監視器/描述
開始了	/監控/啟動
範本	/監視器/模板
警報配置	/監視器/警報配置
物品	YANG模型路徑：/accounts/account/monitors/monitor/alarm-configs …
警報配置[標識符]	/警報配置
識別符	/警報配置/標識符
範本	/警報配置/模板
電子郵件	/警報配置/電子郵件
SNMP	/警報配置/snmp
臨界值	/alarm-config/thr-es-關鍵
閾值清除	/alarm-config/thr-es-ritic-clear
三大調	/alarm-config/thr-es-major
三大調清除	/alarm-config/thr-es-major-clear
三小調	/alarm-config/thr-es-minor
三小調清晰	/alarm-config/thr-es-minor-clear
三號警告	/alarm-config/thr-es-警告
三次警告清除	/alarm-config/thr-es-warning-clear
無數據嚴重性	/警報配置/無數據嚴重性
無數據逾時	/警報配置/無數據逾時
行動	/警報配置/操作
窗口大小	/警報配置/視窗大小
間隔	/警報配置/間隔
只發送一次	/alarm-config/僅發送一次
每個流的 snmp 陷阱	/alarm-config/snmp-trap-per-stream
物品	YANG模型路徑：/accounts/account/monitors …
參數	/監控/參數
物品	YANG模型路徑：/accounts/account/monitors/monitor/parameters …
參數[鍵]	/範圍
鑰匙	/參數/鍵
（值類型）	/範圍
：（整數）	/範圍
整數	/參數/整數
：（漂浮）	/範圍
漂浮	/參數/浮點
：（細繩）	/範圍
物品	YANG模型路徑：/accounts/account/monitors/monitor/parameters …
細繩	/參數/字串
:(測試代理介面)	/範圍
測試代理介面	/參數/測試代理接口
測試代理介面[“1”（第 58 頁）	/參數/測試代理介面/
帳戶	/參數/測試代理介面/測試代理介面/帳戶
測試代理	/參數/測試代理介面/測試代理介面/測試代理
介面	/參數/測試代理介面/測試代理介面/接口
IP版本	/parameter/test-agent-interfaces/test-agent-interface/ip-版本
:(TWamp-反射鏡）	/範圍
twamp- 反射器	/參數/twamp- 反射器
twamp-反射鏡[名稱]	/參數/twamp-反射器/twamp-反射器
姓名	/參數/twamp-反射器/twamp-反射器/名稱
:(y1731-meps)	/範圍
y1731-meps	/參數/y1731-meps
y1731-mep[名稱]	/參數/y1731-meps/y1731-mep
姓名	/參數/y1731-meps/y1731-mep/名稱
:(sip 帳戶)	/範圍
sip 帳戶	/參數/sip-帳戶
sip 帳戶[第 2 頁的「58」]	/參數/sip-帳戶/sip-帳戶
帳戶	/參數/sip-帳號/sip-帳號/帳號
測試代理	/parameter/sip-accounts/sip-account/test-agent
介面	/參數/sip-accounts/sip-account/接口
sip位址	/parameter/sip-accounts/sip-account/sip-address
:(iptv 頻道)	/範圍
iptv頻道	/參數/iptv-頻道
iptv 頻道[名稱]	/參數/iptv-頻道/iptv-頻道
姓名	/參數/iptv-channels/iptv-channel/名稱

帳戶測試代理接口
帳號測試代理介面 sip-位址

物品	YANG模型路徑：/accounts/account/monitors …
地位	/監控/狀態
最後 15 分鐘	/監控/狀態/最後 15 分鐘
地位	/監控/狀態/最後 15 分鐘/狀態
狀態值	/監控/狀態/最後 15 分鐘/狀態值
上一個小時	/監控/狀態/最後一小時
地位	/監控/狀態/最後一小時/狀態
狀態值	/監控/狀態/最後一小時/狀態值
最近 24 小時	/監控/狀態/過去 24 小時
地位	/監控/狀態/過去24小時/狀態
狀態值	/monitor/status/last-24-hours/status-value
範本	/模板
模板[名稱]	/模板/模板
姓名	/模板/模板/名稱
描述	/模板/模板/描述
參數	/模板/模板/參數
參數[鍵]	/模板/模板/參數/參數
鑰匙	/模板/模板/參數/參數/鍵
類型	/模板/模板/參數/參數/類型

監視器編排的先決條件
在使用 ncclient 透過 NETCONF 啟動監視器之前，您需要在控制中心 GUI 中建置監視器模板，如「測試和監視器」>「建立模板」下的應用程式內說明中所述。在編排範本的啟動時，在此範本中指定為「範本輸入」的所有欄位都需要作為 XML 中的參數。
從監視器範本取得輸入參數
下面顯示了兩個範本。第一個用於兩個測試代理介面之間的 UDP 監控，第二個用於使用單一測試代理介面的 HTTP。
若要尋找範本的輸入參數，請按一下代表範本的方塊。對於 HTTP 模板，參數可能如下所示：

我們需要在下一步啟動監視器時定義這些參數。
啟動監視器
使用我們在第 17 頁的「建立和部署新測試代理」部分中定義和部署的測試代理，我們可以從範本「HTTP」啟動監視器，如下所示。
對於每個參數，需要提供屬性。此鍵與控制中心中參數的變數名稱相同。您可以如下檢查變數名稱：

點擊側欄上的“監控”並選擇“新建監視器”。

點擊我的模板。
點擊感興趣的模板下方的編輯連結。
點選右上角的編輯輸入按鈕。

在我們的前任amp文件，預設情況下，變數名稱只是控制中心中顯示名稱的小寫版本（“url” 與 “URL“， ETC。）。但是，在控制中心 GUI 中，您可以將變數重新命名為您喜歡的任何名稱。
除了鍵之外，每個參數都需要指定其類型：例如amp樂，為了 URL。請注意，有關參數類型的完整資訊可在 YANG 模型中找到。對於測試代理接口，類型具有更複雜的結構，如下面的程式碼所示。
在前amp在接下來的文件中，沒有警報與監視器關聯。對於前amp涉及警報的文件，請前往第 62 頁的「啟動帶有警報的監視器」部分。

啟動帶有警報的監視器
若要將警報與監視器關聯，您可以指向已定義的警報模板，也可以在建立監視器時提供整個警報配置。我們會給一位前任amp以下每種方法的檔案。
透過指向警報模板來設定監視器警報
為了使用警報模板，您必須知道其 ID。為此，請先依照第 39 頁「檢索所有警報模板」部分所述檢索所有警報模板，並記下相關模板的名稱。然後您可以如下引用該模板：

透過直接配置來設定監視器警報y
或者，您可以透過在建立監視器時提供其完整配置來為監視器設定警報，而無需引用警報範本。這是按以下範例所示完成的amp勒。

檢索正在運行的監視器
若要擷取目前正在執行的所有監視器，請執行下列腳本：
與經理。 connect(host=args.host, port=args.port, username=args.使用者名稱,password=args.password, hostkey_verify=False) as m:

輸出是所有正在運行的監視器的列表，如下所示：

檢索監視器的 SLA 狀態
以下是如何檢索監視器的 SLA 狀態。在這個前amp在文件中，我們正在檢索三個時間間隔內監視器「網路品質」的 SLA 狀態：過去 15 分鐘、過去 24 小時和過去 XNUMX 小時。

輸出將如下所示：

NETCONF 通知
監視器的 NETCONF 通知由 SLA 違規觸發。當監視器的 SLA 在給定時間視窗（預設為最後 15 分鐘）內降至 SLA 閾值（「良好」或「可接受」）以下時，就會發生這種情況。應該注意的是，服務受到問題影響後，SLA 違規通知很快就會出現，而 SLA 狀態僅在 15 分鐘後且只有在沒有進一步違規發生的情況下才會恢復為「良好」。
可以透過編輯設定 SLA_STATUS_WINDOW（以秒為單位的值）來變更時間視窗 /etc/netrounds/netrounds.conf.
匯出和匯入監控模板
這與測試模板的方式完全相同；比較第 52 頁的「匯出和匯入測試範本」部分。下面的程式碼片段說明如何匯出和匯入監視器範本。
匯出監控模板

導入監控模板

使用 Tags

Tags Paragon Active Assurance 中定義的內容可應用於：

監視器
監控模板
測試劑
TWAMP 反射鏡
Ping 主機。
對於前amp樂，你可以 tag 具有相同功能的監視器 tag 作為將運行監視器的測試代理的子集。如果您定義了大量監視器和模板，此功能特別有用。

如果您為監視器設定了帶有 SNMP 陷阱的警報，則 SNMP 陷阱將被指派相同的警報。 tags 作為監視器（如果有）。
創造 Tags
下面我們展示如何建立一個 tag 名稱和顏色由 XML 定義tag> 下部結構。

分配一個 Tag
分配一個 tag 對於資源，您可以將其新增為新資源tag> 下的元素tags> 該資源的元素。
以下是如何分配 tag 給測試代理：

分配一個 tag 到 TWAMP 反射器，執行以下操作：

分配一個 tag 到監視器的處理方式類似：

或者，您可以指派一個現有的 tag 建立資源時會新增到任何這些資源類型，包括tags> 元素包含 tag 有問題。
更新一個 Tag
更新現有的 tag 具有新屬性類似於創建 tag:

取消分配 Tag
取消分配 tag 從資源中，將屬性 nc:operation=”delete” 新增至tag> 屬於資源的元素。下面，我們取消分配 tag 從監視器。

刪除一個 Tag
為了刪除一個 tag 完全從控制中心，再次使用屬性 nc:operation=”delete”，但這次應用於 tag 本身，定義在。

故障排除

問題：Orchestrator 和 Paragon Active Assurance 不同步
Orchestrator 和 Paragon Active Assurance 可能最終會不同步amp如果在控制中心 GUI 中進行了配置更改，或者應用程式配置不成功且回滾到先前的狀態失敗，則該檔案會被刪除。
如果回溯失敗，NETCONF伺服器將不再接受設定變更；它將回覆一條錯誤訊息，指出配置已鎖定，直到恢復同步為止。要恢復同步並解鎖配置更改，您需要執行命令 rpcsync-from-ncc，它將所有配置從控制中心同步到配置資料庫。
筆記： 這 confd@netrounds.com 使用者（或已配置的任何內容）必須具有超級使用者權限才能成功同步所有內容。這可以透過命令 ncc user-update 來實現 confd@netrounds.com –is-superuser 如果用戶不是超級用戶，則會出現警告，指出並非所有內容都可以同步，但所有可以處理的內容都已同步。
筆記： 如果您的 Orchestrator 也儲存配置，您還需要重新同步該配置，因為請求的配置（Orchestrator 期望控制中心擁有的配置）將尚未套用。
問題：由於資源不受支持，初始同步 (sync-from-ncc) 失敗
如果您嘗試在控制中心 GUI 中建立配置的帳戶上執行 rpcsync-from-ncc，並且該帳戶包含不支援的資源，則可能會遇到問題。建議您從一個空帳戶開始，並透過 NETCONF 進行所有設定。否則，如果您遇到資源衝突問題，則必須從帳戶中刪除衝突資源。
問題：NETCONF 命令失敗並出現 ncclient.operations.rpc.RPCError：應用程式通訊失敗
如果控制中心重新啟動，NETCONF 伺服器不會自動恢復與控制中心伺服器的連線。若要恢復與控制中心的連接，請重新啟動 NETCONF 程序： sudo systemctl restart netrounds-confd

關於測試代理應用程式和測試代理設備的注意事項

ConfD 中的測試代理應用程式
在測試代理中，（較新的）測試代理應用程式的工作方式與（較舊的）測試代理設備略有不同。
測試代理應用程式目前不支援介面配置。因此，YANG 模式允許為此類測試代理指定空介面配置。請參閱第 23 頁的「這段文字」以了解前任的情況amp勒。
使用sync-from-ncc 指令將ConfD 資料庫與控制中心同步時，您希望介面組態保持為空，且不被控制中心中的組態覆寫。因此，在使用測試代理應用程式時，您需要在該命令中使用特殊標誌 –without_interface_config。
測試代理設備的空介面配置
如上所述，測試代理應用程式不支援介面配置，因此可以省略 YANG 模式中的介面。
但在某些用例中，您可能想要省略 Test Agent Appliance 的介面配置。前任amp該檔案可能是編排場景，其中您使用 cloud-init 啟動測試代理，並且您希望使用其中的介面配置，而不是在測試代理上線時讓 ConfD 覆寫它。
關於未定義介面的 YANG 架構更改
由於現在允許空介面配置（從版本 2.34.0 開始），因此可以指定任何介面名稱作為作為測試或監視器的一部分運行的任務的輸入。
這是能夠使用測試代理應用程式所必需的，因為 ConfD 中沒有定義這些介面名稱。但請注意，這也意味著如果您意外地將測試或監視器配置為使用不存在的接口，您可能會遇到問題。所以請注意這一點。
註冊 ConfD 中建立的測試代理程式時的限制
透過 REST 或 NETCONF/YANG API 建立測試代理程式時，我們無法事先知道它是哪種類型：測試代理裝置或測試代理應用程式。只有在測試代理註冊後，這一點才會變得清晰。
一旦測試代理被註冊並變成這些具體類型之一，您就不能將其重新註冊為不同類型的測試代理。這意味著您不能先將其註冊為測試代理設備，然後將其重新註冊為測試代理應用程序，反之亦然。如果您需要不同類型的測試代理，則需要建立新的測試代理。

附錄：全YANG模型的樹狀結構

在本附錄中，第 81 頁的「圖例」部分解釋了使用指令 pyang -f tree 產生的 YANG 模型樹結構的語法。
第 82 頁的「YANG 模型樹結構」部分給出了應用於 netrounds-ncc.yang 的命令的輸出。此輸出的部分內容在文件的其他地方複製。
傳奇

YANG模型樹結構

Juniper Networks、Juniper Networks 標誌、Juniper 和 Junos 是 Juniper Networks, Inc. 在美國和其他國家的註冊商標。所有其他商標、服務標記、註冊標記或註冊服務標記均為其各自所有者的財產。瞻博網路對本文檔中的任何不準確之處不承擔任何責任。瞻博網路保留更改、修改、轉讓或以其他方式修訂本出版物的權利，恕不另行通知。版權所有 © 2023 瞻博網路公司。

文件/資源

瞻博網路 NETCONF 和 YANG API 軟體 [pdf] 使用者指南
NETCONF YANG API 軟體, YANG API 軟體, API 軟體, 軟體

參考

使用者手冊

介紹