技術的専門知識
著作権 © 2009-2026Xena （デンマーク）
Xena ベース
XMLレポート仕様書
概要
このページでは、Xena2544、Xena1564、Xena3918、およびXena2889テストアプリケーションによって生成されるXMLレポートのフォーマットについて説明します。
各XMLレポートには、テスト結果セクションとテスト構成セクションの両方が含まれます。結果セクションには実際の結果が記載され、構成セクションにはテスト実行に使用された完全な構成が含まれます。
XMLレポートにはXMLスキーマ定義が含まれていないため、XMLレポートの利用者はこのWikiページを参照する必要があります。
XMLヘッダーとトップタグ
XMLレポートファイルは、以下の標準ヘッダーで始まります：
レポートのトップタグは です。
テスト結果
結果セクションはタグで囲まれています。このセクションには以下のサブセクションが含まれます：
| セクションタグ | 説明 |
|---|---|
| テストスイート全体の要約データを含みます。 | |
| スループットテストの結果が含まれています。 | |
| 損失試験の結果を含みます。 | |
| レイテンシおよびジッタテストの結果を含みます。 | |
| 連続テストの結果が含まれています。 |
要約
このセクションにはテストスイートの要約データが含まれます。以下のサブタグが定義されています：
タグ自体には値は含まれません。以下の属性を含みます：
| テスト会社 | 試験を実施する会社の名称 |
| お客様 | 顧客名 |
| カスタマーアクセスID | テスト用に指定された顧客アクセスID |
| カスタマーサービスID | テスト用に指定されたカスタマーサービスID |
タグ自体には値は含まれません。以下の属性を含みます：
| テスト日時 | フォーム上のテスト用タイムスタンプ「YYYYMMDD-HHMMSS」。レポートを生成するPCのローカル時間が使用されます。 |
| テスト時間 | 整数、テストの合計所要時間（秒単位）。 |
| ポートなし | 整数、テストで使用されたポートの数 |
| ノーランズ | 整数、テストで使用された実行回数 |
このタグは、テスト用に指定されたコメントである単一のCDATA値を含みます。属性は一切持ちません。
テスト種別固有セクション
報告書には、それぞれと、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と、と
各テストタイプセクションには複数の結果が含まれます。各結果はタグで囲まれます。結果の合計値は結果タグの属性として報告され、ポート固有の結果はサブタグで報告されます。
結果属性
このタグには以下の属性が含まれる場合があります。一部の属性は特定のテストタイプでのみ有効であり、その旨は凡例で示されています：
- THR: スループット
- ロス：損失
- LAT: 遅延/ジッター
- B2B: 背中合わせ
- すべて：上記のすべて
| 属性名 | タイプ | 説明 | テストタイプ(複数可)に有効 |
|---|---|---|---|
| フレームサイズ | 番号 | このテストに使用されたフレームサイズ。 | すべて |
| 総合評価 | 番号 | パケット/秒における合計レート | THR |
| 合格率パーセント | 番号 | 合格率（最大可能率に対する割合） | THR |
| 総送信パケット数 | 番号 | 送信されたパケットの総数。 | すべて |
| 総処方箋数 | 番号 | 受信したパケットの総数。 | すべて |
| 受理されました | はい／いいえ | 結果は受け入れられたのか、それとも受け入れられなかったのか？ | すべて |
| 最大レートパーセント | 番号 | 最大速度に対する使用率（パーセント）。 | LOS、B2B |
| 最大パケットレート | 番号 | パケット毎秒で使用される最大レート。 | LOS、B2B |
| 最大速度Mbps | 番号 | 最大使用速度（Mbps単位） | LOS、B2B |
ポート属性
属性（一部の属性は特定のテストタイプでのみ有効です）：
| 属性名 | タイプ | 説明 | テストタイプ(複数可)に有効 |
|---|---|---|---|
| 名前 | 文字列 | フォーム上のポートの正式名称「P—」 | すべて |
| レート | 番号 | パケット/秒での使用率。 | THR |
| レートパーセント | 番号 | 最大率に対する使用率（％） | THR |
| レートMbps | 番号 | 使用レート（Mbps） | THR |
| 損失率 | 番号 | 送信された総パケットに対するパケット損失の割合。 | LOS |
| レイテンシ平均 | 番号 | 平均レイテンシ（マイクロ秒単位） | LAT |
| レイテンシー最小値 | 番号 | 最小レイテンシ（マイクロ秒単位） | LAT |
| 最大遅延時間 | 番号 | 最大遅延時間（マイクロ秒単位） | LAT |
| ジッタ平均 | 番号 | 平均ジッタ（マイクロ秒単位） | LAT |
| ジッター最小化 | 番号 | 最小ジッタ（マイクロ秒単位） | LAT |
| ジッターマックス | 番号 | 最大ジッタ（マイクロ秒単位） | LAT |
| バーストサイズ | 番号 | バーストサイズ（バイト単位） | B2B |
遅延とジッタ率
レイテンシおよびジッタテストは様々なレートで実施される。結果も使用された各レートごとに報告される。したがって、レイテンシおよびジッタセクションには「Results」セクションをカプセル化する「Results」セクションと呼ばれる別のセクションが含まれる。このタグには「Value」と呼ばれる単一の属性が含まれ、使用されたレートを数値として提供する。
テスト構成
設定セクションはタグで囲まれています。フォーマットは設定ファイルで使用される構造と同じです。ただし設定ファイルはJSON形式で保存されますが、XMLレポートには同じタグ値が使用されます。JSON設定ファイルの構文の詳細については、このページを参照してください。
サンプルスクリプト
Xenas2544アプリケーションには、いくつかのサンプルPythonスクリプトが同梱されています。これらは、Xena2544アプリケーションを起動し、コマンドラインから設定を実行する方法、および組み込みのxml.dom.minidom Pythonパッケージを使用して結果のXMLレポートを解析する方法を説明しています。もちろん、他の標準準拠の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