Xena 知識庫
XML 報告規範
概述
本頁介紹 Xena2544、Xena1564、Xena3918 和 Xena2889 測試應用程式生成的 XML 報告的格式。
每個 XML 報告都包含一個 測試結果部分 和一個 測試配置部分。結果部分將包含實際結果，而配置部分包含用於執行測試的完整配置。
XML 報表不包含任何 XML 架構定義，因此 XML 報表的使用者需要參考此 Wiki 頁面。
XML 標頭和頂部標記
XML 報告檔以標準標頭開頭，如下所示：
報告的頂部標記是 。
測試結果
結果部分包含在標記中。該部份包含以下子部分：
| 部分標記 | 解釋 |
|---|---|
| 包含整個測試套件的摘要數據。 | |
| 包含輸送量測試的結果。 | |
| 包含損失測試的結果。 | |
| 包含延遲和抖動測試的結果。 | |
| 包含背靠背測試的結果。 |
總結
本部分包含測試套件的摘要數據。定義以下子標記：
標記本身不帶有值。它包含以下屬性：
| 測試公司 | 執行測試的公司名稱 |
| 客戶 | 客戶名稱 |
| 客戶訪問ID | 為測試指定的客戶存取 ID |
| 客戶服務編號 | 為測試指定的客戶服務ID |
標記本身不帶有值。它包含以下屬性：
| 測試日期時間 | 表單為“YYYYMMDD-HHMMSS”的測試時間戳。使用生成報告的 PC 的本地時間。 |
| 測試持續時間 | 整數，測試的總持續時間（以秒為單位）。 |
| 無埠 | 整數，測試中使用的埠數 |
| 無運行 | 整數，測試中使用的運行次數 |
此標記包含單個 CDATA 值，該值是為測試指定的註釋。它沒有屬性。
特定於測試類型的部分
此報告會包含四種測試類型中每種測試類型的一個部分，分別名為、 和 。
每個測試類型部分將包含許多結果。每個結果都將包含在一個標籤中。結果的總計將報告為結果標記的屬性，而特定於埠的結果將在子標記中報告。
結果屬性
標記可能包含以下屬性。某些屬性僅對某些測試類型有效，圖例表示：
- THR：輸送量
- LOS：損失，
- 緯度：延遲/抖動
- B2B：背靠背
- 全部：以上所有內容
| 屬性名稱 | 類型 | 解釋 | 適用於測試類型 |
|---|---|---|---|
| 框架尺寸 | 數 | 用於此測試的幀大小。 | 都 |
| 總利率 | 數 | 以數據包/秒為單位的總速率 | 鞘翅目 |
| 通過率pcnt | 數 | 通過率（以最大可能率的百分比表示）。 | 鞘翅目 |
| 總Tx數據包 | 數 | 傳輸的數據包總數。 | 都 |
| 總接收數據包 | 數 | 接收的數據包總數。 | 都 |
| 接受 | 是/否 | 結果是否被接受？ | 都 |
| MaxRatePcnt | 數 | 使用的最大速率，以最大可能速度的百分比表示。 | 洛杉磯，B2B |
| 最大速率PPS | 數 | 以每秒數據包數為單位使用的最大速率。 | 洛杉磯，B2B |
| 最大速率Mbps | 數 | 使用的最大速率（以 Mbps 為單位）。 | 洛杉磯，B2B |
埠屬性
屬性（某些屬性僅對某些測試類型有效）：
| 屬性名稱 | 類型 | 解釋 | 適用於測試類型 |
|---|---|---|---|
| 名字 | 字串 | 埠的全名，格式為“P—” | 都 |
| 率 | 數 | 以數據包/秒為單位的已用速率。 | 鞘翅目 |
| RatePcnt | 數 | 使用率（以最大速率的百分比表示） | 鞘翅目 |
| RateMbps | 數 | 使用速率（以 Mbps 為單位 ） | 鞘翅目 |
| 損失個人 | 數 | 數據包丟失率（占傳輸數據包總數的百分比）。 | 洛杉磯 |
| 延遲平均 | 數 | 平均延遲（微秒） | 拉特 |
| 延遲最小值 | 數 | 最小延遲（微秒） | 拉特 |
| 最大延遲 | 數 | 最大延遲（微秒） | 拉特 |
| 抖動平均 | 數 | 平均抖動（以微秒為單位） | 拉特 |
| 抖動最小值 | 數 | 最小抖動（以微秒為單位） | 拉特 |
| 抖動最大 | 數 | 最大抖動（微秒） | 拉特 |
| 突發大小 | 數 | 突發大小（以位元組為單位） | B2B |
延遲和抖動率
延遲和抖動測試以不同的速率執行。對於所使用的每個速率，還會報告結果。因此，延遲和抖動部分包含另一個稱為封裝結果部分的部分。此標籤包含一個名為「Value」的單個屬性，該屬性提供用作數位的比率。
測試配置
配置部分包含在標記 中。格式遵循與配置檔相同的結構。但是，配置檔以 JSON 格式保存，但 XML 報告使用相同的標記值。有關 JSON 設定檔語法的詳細資訊，請參閱 此頁面 。
示例腳本
Xenas2544 應用程式與一些示例 Python 腳本一起分發，這些腳本解釋了如何啟動 Xena2544 應用程式並從命令行執行配置，以及使用內置的 xml.dom.minidom Python 包解析生成的 XML 報告。當然，可以使用任何其他符合標準的 XML 解析包。
例
以下範例代碼段顯示如何使用該格式：
版本=“1.0” 編碼=“UTF-8”？>
<xena2544></xena2544
<testresults>
<summary>
<identification< span=""> TestCompany="Xena Networks ApS" Customer="Xena Networks" /></identification<>
<metrics< span=""> TestDateTime="20120627-091018" TestDuration="123" /></metrics<>
<comment></comment>
>
<throughput>
<result< span=""> FrameSize="64" TotalRate="1488095" PassedRatePcnt="100,00"></result<>
<port< span=""> Name="P-0-10-1" Rate="1488095" RatePcnt="100" RateMbps="1000" /></port<>
>
<result< span=""> FrameSize="128" TotalRate="844594" PassedRatePcnt="100,00"></result<>
<port< span=""> Name="P-0-10-1" Rate="844594" RatePcnt="100" RateMbps="1000" /></port<>
>
>
<loss></loss
>
>
<testconfiguration>
>
></testconfiguration</throughput</summary</testresults
