Xena 庫
XML報告規範
概述
本頁說明由 Xena2544、Xena1564、Xena3918 及 Xena2889 測試應用程式所產生的 XML 報告格式。
每個 XML 報告均包含測試結果部分與測試配置部分。結果部分將呈現實際測試結果，而配置部分則包含執行測試時所使用的完整設定。
此 XML 報告未包含任何 XML 架構定義，因此使用者需參閱此維基頁面。
XML 標頭與頂層標籤
XML報告檔案以標準標頭開頭，格式如下：
該報告的頂層標籤為。
測試結果
結果部分被標記包圍。該部分包含以下子部分：
| 區段標籤 | 說明 |
|---|---|
| 包含整個測試套件的摘要數據。 | |
| 包含吞吐量測試的結果。 | |
| 包含損失測試的結果。 | |
| 包含延遲與抖動測試的結果。 | |
| 包含連續測試的結果。 |
摘要
本節包含測試套件的摘要數據。定義了以下子標籤：
標籤本身並不承載任何值。它包含以下屬性：
| 測試公司 | 執行測試的公司名稱 |
| 客戶 | 客戶名稱 |
| 客戶存取識別碼 | 測試指定之客戶存取識別碼 |
| 客戶服務ID | 測試指定之客戶服務識別碼 |
標籤本身並不承載任何值。它包含以下屬性：
| 測試日期時間 | 表單測試的時間戳記格式為「YYYYMMDD-HHMMSS」。採用生成報告之電腦的當地時間。 |
| 測試持續時間 | 整數，測試的總持續時間（以秒為單位）。 |
| 無端口 | 整數，測試中使用的埠口數量 |
| 無得分 | 整數，測試中使用的運行次數 |
此標籤包含單一 CDATA 值，該值即為測試指定的註解。此標籤不具備任何屬性。
測試類型專屬區段
報告將包含四個測試類型的獨立章節，分別命名為、和。
每種測試類型的區段將包含若干結果。每個結果皆以標籤包圍。結果的總計數將作為結果標籤的屬性呈現，而端口特定結果則以子標籤形式報告。
結果屬性
標籤可能包含以下屬性。部分屬性僅適用於特定測試類型，其適用範圍將透過圖例標示：
- THR：吞吐量
- LOS：損失
- 延遲/抖動
- B2B：背靠背
- 全數：以上所述
| 屬性名稱 | 類型 | 說明 | 適用於測試類型 |
|---|---|---|---|
| 幀尺寸 | 數字 | 本次測試所使用的框架尺寸。 | 全部 |
| 總評分 | 數字 | 每秒封包總速率 | THR |
| 通過率百分比 | 數字 | 及格率（以百分比表示，相對於最高可能達到的百分比）。 | THR |
| 總傳輸封包數 | 數字 | 傳輸的封包總數。 | 全部 |
| 總處方藥包數 | 數字 | 接收到的封包總數。 | 全部 |
| 已接受 | 是／否 | 結果是否被接受？ | 全部 |
| 最大速率百分比 | 數字 | 最大速率以百分比表示，相對於最高可能速度而言。 | LOS，企業對企業 |
| 最大速率每秒封包數 | 數字 | 每秒封包中使用的最大速率。 | LOS，企業對企業 |
| 最大速率Mbps | 數字 | 最大速率以 Mbps 為單位。 | LOS，企業對企業 |
港口屬性
屬性（某些屬性僅適用於特定測試類型）：
| 屬性名稱 | 類型 | 說明 | 適用於測試類型 |
|---|---|---|---|
| 姓名 | 字串 | 表格上該港口的全稱「P—」 | 全部 |
| 費率 | 數字 | 每秒封包使用率。 | THR |
| 利率百分比 | 數字 | 使用率佔最高使用率的百分比 | THR |
| 速率Mbps | 數字 | 使用速率（單位：Mbps） | THR |
| 損失百分比 | 數字 | 傳輸總封包數中封包遺失的百分比。 | LOS |
| 延遲平均值 | 數字 | 平均延遲（單位：微秒） | LAT |
| 最小延遲 | 數字 | 最低延遲（單位：微秒） | LAT |
| 最大延遲 | 數字 | 最大延遲（單位：微秒） | LAT |
| 抖動平均值 | 數字 | 平均抖動（單位：微秒） | LAT |
| 抖動最小化 | 數字 | 最小抖動（單位：微秒） | LAT |
| 抖動最大值 | 數字 | 最大抖動（單位：微秒） | LAT |
| 突發大小 | 數字 | 突發大小（以位元組為單位） | B2B |
延遲與抖動率
延遲與抖動測試在不同速率下執行，並針對每種速率分別回報結果。因此「延遲與抖動」章節內另設有「結果」子章節，此標籤僅包含名為「數值」的單一屬性，該屬性以數字形式提供所使用的速率。
測試配置
配置區段以標籤包圍。其格式遵循與配置檔案相同的結構。然而，配置檔案以JSON格式儲存，但XML報告使用相同的標籤值。有關JSON配置檔案語法的詳細資訊，請參閱此頁面。
範例腳本
Xenas2544 應用程式隨附數個範例 Python 腳本，說明如何從命令列啟動 Xena2544 應用程式並執行設定，同時使用內建的xml.dom.minidom Python套件解析產生的 XML 報告。當然，您亦可選用任何其他符合標準的 XML 解析套件。
範例
以下範例片段展示了該格式的使用方式：
php version="1.0" encoding="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
