XMLレポート仕様

概要

このページでは、Xena2544、Xena1564、Xena3918、Xena2889 テストアプリケーションが生成する XML レポートのフォーマットについて説明します。

各 XML レポートには、試験結果セクションと 試験構成セクションの両方が含まれる。結果セクションには実際の結果が含まれ、構成セクションにはテストの実行に使用された完全な構成が含まれます。

XMLレポートにはXMLスキーマ定義が含まれていないため、XMLレポートのユーザーはこのウィキページを参照する必要がある。

XMLヘッダーとトップタグ

XMLレポートファイルは、以下のような標準的なヘッダーで始まる：

レポートのトップタグは.

テスト結果

結果セクションは、タグ .このセクションには以下のサブセクションがある：

セクションタグ	説明
	テスト・スイート全体の要約データを含む。
	スループットテストの結果が含まれる。
	ロステストの結果が含まれています。
	レイテンシーとジッターのテスト結果が含まれています。
	バック・トゥ・バック・テストの結果を収録。

概要

このセクションにはテスト・スイートの要約データが含まれる。以下のサブタグが定義されている：

タグ自身は値を持ちません。タグには以下の属性があります：

テスト会社	試験実施会社名
お客様	顧客名
カスタマーアクセスID	テスト用に指定された顧客アクセスID
顧客サービスID	テスト用に指定されたカスタマーサービスID

タグ自身は値を持ちません。タグには以下の属性があります：

テスト日時	YYYYMMDD-HHMMSS」形式のテストのタイムスタンプ。レポートを生成するPCのローカル時間が使用されます。
テスト期間	整数、試験時間の合計（秒単位）。
ノーポート	整数、テストで使用するポート数
ノーラン	整数、テストで使用されるランの数

このタグは、テストに指定されたコメントである1つのCDATA値を含む。属性はありません。

テストタイプ別セクション

レポートには、4つのテストタイプ（ 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 、 ）に分かれたセクションがある。

各試験タイプ・セクションには、いくつかの結果が含まれる。各結果はタグで囲まれる。結果の合計は結果タグの属性として報告され、ポート固有の結果はサブタグで報告される。

結果属性

タグは以下の属性を含むことができる。一部の属性は特定のテスト・タイプにのみ有効で、凡例で示されています：

• THRスループット
• LOS：敗戦、
• LAT：レイテンシー／ジッター
• B2B：バック・トゥ・バック
• すべて：上記のすべて

属性名	タイプ	説明	テストタイプに有効
フレームサイズ	番号	このテストに使用されるフレームサイズ。	すべて
トータルレート	番号	パケット/秒の合計レート	THR
通過レート	番号	最大合格率に対する合格率。	THR
総Txパケット数	番号	送信されたパケットの総数。	すべて
総受信パケット数	番号	受信したパケットの総数。	すべて
受諾	はい／いいえ	結果は受け入れられたのか、受け入れられなかったのか？	すべて
最大レート	番号	使用可能な最大速度のパーセンテージ。	LOS、B2B
最大レート	番号	1秒あたりのパケット数。	LOS、B2B
最大レートMbps	番号	最大使用レート（Mbps）。	LOS、B2B

ポート属性

属性（一部の属性は特定のテスト・タイプにのみ有効）を使用します：

属性名	タイプ	説明	テストタイプに有効
名称	ストリング	ポートの正式名称。	すべて
レート	番号	使用レート（パケット/秒）。	THR
レート	番号	最大レートに対する使用レート	THR
レートMbps	番号	使用レート（Mbps	THR
ロス指数	番号	パケットロス（パケット総送信量に対する割合）。	LOS
レイテンシ	番号	平均待ち時間（マイクロ秒	LAT
レイテンシー最小	番号	最小待ち時間（マイクロ秒	LAT
レイテンシーマックス	番号	最大待ち時間（マイクロ秒	LAT
ジッター平均値	番号	平均ジッター（マイクロ秒	LAT
ジッター最小	番号	最小ジッター（マイクロ秒	LAT
ジッターマックス	番号	最大ジッター（マイクロ秒	LAT
バーストサイズ	番号	バーストサイズ（バイト	B2B

レイテンシーとジッターレート

レイテンシーとジッターのテストは様々なレートで行われる。結果はまた、使用された各レートについて報告される。したがって、Latency and Jitter セクションには、Results セクションをカプセル化した、もう1つのセ クションと呼ばれるタグが含まれる。このタグには、"Value "という1つの属性が含まれ、使用されたレートを数値として提供する。

テスト構成

コンフィギュレーション・セクションは、タグ .フォーマットは、設定ファイルに使用されているのと同じ構造に従っています。ただし、設定ファイルはJSON形式で保存されますが、XMLレポートには同じタグ値が使用されます。JSON設定ファイルの構文の詳細については、このページを参照してください。

サンプルスクリプト

Xenas2544 アプリケーションには、Xena2544 アプリケーションを起動し、コマンドラインからコンフィギュレーションを実行する方法と、組み込みのxml.dom.minidom Pythonパッケージを使用して結果の XML レポートを解析する方法を説明した、いくつかのサンプル Python スクリプトが付属しています。もちろん、他の標準に準拠したXML解析パッケージを使用することもできます。

例

次のサンプル・スニペットは、この書式がどのように使われているかを示しています：

 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