このドキュメントの目的は、実際のイベントに備えて Microsoft eCDN サイレント テスト ツールを使用して企業ネットワークを監査する方法に関する手順を、企業 Web キャスト プラットフォームを管理する技術チームを提供することです。
Microsoft eCDN サイレント テスト フレームワークを使用すると、ビデオ イベントの負荷の下で特定のネットワークがどのように動作するかをエミュレートして調べるために、シミュレーションを複数のデバイスで簡単に実行できます。
サイレント テストは、エンド ユーザー デバイス上のバックグラウンド (ミュート) で実行される実際のビデオ セッションです。 ユーザーは、テストが実行されていることを知らずにコンピューターで作業を続けることができますが、ビデオの帯域幅に対するネットワーク接続の速度低下が発生する可能性があります。
注:
サイレント テストのシミュレートされたイベント コンテンツは、Microsoft eCDN ドメインでホストされます。 そのため、サイレント テストは、タウン ホールやその他のライブ イベント製品の包括的なテストとして使用しないでください。
フレームワークは、次の 3 つの主要なコンポーネントで構成されます。
- ランナー デバイス
- 管理ダッシュボード
- 分析
これらのコンポーネントについては、次のセクションで 1 つずつ説明します。
ランナー デバイス
フレームワークに接続する各デバイスは、"ランナー" と見なされます。 各ランナーは、1 つのビューアーをシミュレートし、Microsoft eCDN のバックエンドと通信して、テストを実行する必要がある手順を取得します。 ほとんどの場合、実行されているテストはありません。その場合、ランナーはテストが開始されるまでアイドル状態で待機します。 Microsoft eCDN は、ランナーとして機能するために指定されたエージェント アプリケーションをすべてのコンピューターに展開する代わりに、エンド ユーザー マシンに一般的にインストールされている既存のソフトウェアを利用して、バックグラウンドでランナーを起動します。
ランナーは基本的に Web ページであるため、任意のブラウザーまたはブラウザーに似た環境で開くことができます。 ランナーをインスタンス化する方法は 2 つあります。
重要
Microsoft Edge または Google Chrome は、エンド ユーザーのマシンにインストールする必要があります。 さらに、サイレント テストに参加するには、デバイスをオンにしてインターネットに接続する必要があります。
ダイレクト ランナー
次の URL でランナー ページを手動で開き、プレースホルダー TENANT_ID_HERE をブラウザーのテナントの ID に置き換えるのに注意を払うと、"直接ランナー" と見なされます。
https://st-sdk.ecdn.teams.microsoft.com/?customerId=TENANT_ID_HERE&adapterId=Direct
注意
サイレント ランナーは、コンピューターの IP アドレスを Microsoft eCDN サービスに公開するために必要な引数を使用してインスタンス化されますが、Direct Runner はマシンのグローバル設定を使用します。 そのため、 mDNS IP 難読化をまだ無効にしていない場合、ダイレクト ランナーがピアリングされる可能性は低いです。
サイレント ランナー
"サイレント ランナー" と見なされるランナー ページを使用して、バックグラウンドでヘッドレス Chromium ブラウザーを起動する PowerShell & Bash スクリプトを提供します。 その後、スクリプトをユーザーのグループで実行して、それらをフレームワークに接続できます。
詳細については、「付録 B: ヘッドレス ブラウザーを使用したランナーの統合」を参照してください。
管理ダッシュボード
管理ダッシュボードを使用すると、テストをスケジュール、変更、取り消しでき、接続されたランナーの数も表示されます。 メイン ウィンドウには、保留中のテスト、進行中のテスト、および既に終了した過去のテストが一覧表示されます。 完了したテストは 24 時間表示され、一覧から非表示になります。
分析
テストがスケジュールされると、"保留中" モードに設定されます。 開始時刻に達すると、テストがアクティブ化され、すべてのオンライン ランナーにアクティブ化シグナルが送信されます。 その後、各ランナーによってターゲット ページが起動され、非表示ウィンドウでビデオの再生が開始されます (ミュート)。 Microsoft eCDN SDK は、 Analytics ダッシュボードで使用できるさまざまなグラフとグラフに表示されるネットワークと UX のメトリックを収集します。 テストの実行中に分析が報告されるため、管理者はテストが終了する前でも状態をチェックできます。
同時実行
コンカレンシー グラフには、時間の経過に伴うアクティブなユーザーの数が表示されます。 アクティブと見なすには、ユーザーがビデオを再生している必要があります。
HTTP + P2P 速度
ネットワーク スループット グラフは、HTTP と P2P のネットワーク消費量の内訳を示しています。
| として表されます | Description | Axis |
|---|---|---|
| 濃い青色のバー | HTTP 帯域幅 | left |
| オレンジ色のバー | P2P 帯域幅 | left |
| 緑の点線 | 全体の P2P 比率をパーセンテージで示す | 右 |
たとえば、P2P 比率が 90% の場合、トラフィックの 10% のみが HTTP 経由でダウンロードされ、残りのトラフィックはユーザー間でピアリングされたことを意味します。
P2P が予想よりも低い場合は、ユーザーのコンカレンシーが十分に高くなかったか、ネットワークにより多くの最適化が必要であることを意味します。 トラブルシューティングについては、 ピアリング効率の低いトラブルシューティング に関するドキュメントを参照してください。
ユーザー エクスペリエンス
ユーザー エクスペリエンス グラフには、再生に費やされた時間と、リバッファーに費やされた時間 (固定されたビデオ) の組み合わせが表示されます。
| として表されます | Description | Axis |
|---|---|---|
| 緑のバー | 再生に費やした時間の合計 (分単位) | left |
| 赤いバー | リバッファーに費やされた時間を分単位で組み合わせる | left |
| 青い点線 | 合計時間のリバッファーアウト率をパーセンテージで示す | 右 |
たとえば、2% の再バッファー率は、ビデオが 98% の時間正しく再生されていたのに対し、ビデオがスタックした時間の 2% を意味します。
再バッファー処理は、理想的には 1% を下回る必要があります。 再バッファーの数が多いか急増すると、ネットワークの輻輳、サーバーの過負荷、コンテンツの構成ミスが考えられます。
ネットワーク要件
サイレント テスト フレームワークでは、次のドメインとポートが使用されます。
| ホスト名 | ポート | プロトコル | Description |
|---|---|---|---|
| *.ecdn.teams.microsoft.com | 443 | HTTPS | リソース & ランナー ページ |
| *.ecdn.teams.microsoft.com | 443 | WSS | Microsoft eCDN のバックエンドへの WebSocket 接続 |
| *.ecdn.teams.cloud.microsoft | 443 | HTTPS/ WSS | 今後の統合ドメイン。 上記の 2 つの説明を参照してください。 |
| any | 高いポート 10,000 + | SCTP | これは、WebRTC ピア接続で必要です。 LAN のみに制限できます。 |
重要
統合ドメイン イニシアチブに従って、ドメインを teams.microsoft.com から teams.cloud.microsoft に移行 し 始めました。 新しいドメインをネットワーク トラフィック フィルターとポリシー (ファイアウォール、プロキシ、ポリシー、VPN) にできるだけ早く追加し、特に記載がない限りレガシ ドメインを保持することをお勧めします。
セキュリティ
サイレント テスト フレームワークは、ランナーにテストを割り当てることで動作します。 ランナーは Microsoft eCDN のバックエンドに接続する静的ページですが、実行されるテストは動的であり、任意のターゲット ページを実行できます。 そのため、ランナーはブラウザーによってサンドボックス化された Web ページ内で実行され、最新のブラウザーに組み込まれているセキュリティ メカニズムに依存しています。 統合 (カスタム統合を除く) に関係なく、ターゲット ページは常に iframe を使用して安全なクリーン コンテキストで実行されます。
また、ネットワークのアクセス許可はブラウザーによって制限され、HTTP、WebSocket、WebRTC などの一般的な Web API に制限されます。
テストの実行を待機している間、ランナーはセキュリティで保護された TLS 接続 (WSS) 経由で永続的な WebSocket 接続を維持します。
付録
付録 A: サイレント テストをスケジュールする方法
サイレント テスト ダッシュボードに移動する
+ 記号を選択します
必須フィールドに入力します
[名前 ] - 任意の任意の名前。
Time & Date - テストが開始される特定の時刻。
期間 - テストの期間。 適切なシミュレーションを可能にするには、少なくとも 20 分をお勧めします。
ターゲット URL - シミュレートされたイベント中にビデオを再生するイベント ページの一般公開 URL。 組み込みのページを使用することも、独自のページを作成することもできます。
組み込みのStream - Microsoft eCDN には、既に統合された組み込みページと、いくつかの表示とカスタマイズ可能なストリーミング プロトコルを含むライブ ストリームが含まれています。
カスタム Stream - 独自のライブ ストリームのみを提供し、Microsoft eCDN の自動統合ページを使用できます。 ストリームはパブリックに使用でき、ランナーが読み込むように CORS ヘッダーを含める必要があります。 ストリームは、テストの開始時に自動再生されます。
カスタム ページ - 独自のカスタム ページ。 このページには、プレイヤーとライブ ストリームを含め、Microsoft eCDN と統合する必要があります。 テスト中にユーザーの操作がないため、プレイヤーはビデオの再生を自動的に開始する必要があります。 一部のブラウザーでは、ビデオを自動再生する機能が制限されています。 そのため、オーディオをミュートすることをお勧めします。これにより、制限が緩和されます。 組み込みページは既定でミュートされます。
デバイス フィルター - テストを特定のデバイス グループに制限します。 場合によっては、接続されているデバイスのサブセットでテストを実行することが必要になる場合があります。 たとえば、米国内のオフィスでのみテストを実行したり、Direct ランナー デバイスのみを実行したりします。
国フィルター - 特定の国/地域 (GeoIP) からのデバイスのみが含まれます。
統合フィルター - 特定の統合を介して接続されているデバイスのみを含めます。
デバイス ID フィルター - 特定のデバイス ID でのみテストを実行します。 このフィルターは、主にローカル デバッグ目的で使用されます。
[ スケジュール] を選択すると、テストが作成されます。
サイレント テストの開始時刻に達すると、割り当てられた接続されたデバイスでテストが実行されます。
付録 B: ヘッドレス ブラウザーを使用したランナーの統合
Microsoft eCDN には、インストール不要のサイレント テスター ランナー スクリプトが用意されています。
このスクリプトは、指定した期間、特定のページのバックグラウンドでクロム ベースのブラウザー (Microsoft Edge または Google Chrome) を起動し、バックグラウンド ブラウザー プロセスを閉じます。
さらに、Microsoft eCDN には、Active Directory にリストされているリモート マシンでサイレント テスター ランナー スクリプトを実行する呼び出しスクリプトが用意されています。
注:
マシンを再起動してもランナーは自動的に復元されないため、スクリプトを使用してブラウザーを再度起動する必要があります。
Windows 環境の手順
silent-tester-runner-windows.ps1 PowerShell スクリプトをダウンロードします。
スクリプト内で次を編集します。
$TenantID-
TENANT_IDを Microsoft テナント ID に置き換えます。$TestID-
TEST_IDを一意の ID 文字列に置き換えます。 この文字列はログ ファイルの作成で使用され、サイレント テスト管理者はテスト結果を一意に識別できます。
重要
各テストには、一意の$TestIDが必要です。 スクリプトは、現在のインスタンスと同じ$TestIDで以前に実行されていたことを検出した場合、サイレント ランナーをインスタンス化せずに終了します。
(省略可能) $scenarioDuration - ブラウザーのアップタイム期間を目的の値 (秒単位) に設定します。 この期間、ターゲット マシンでサイレント テストを実行できます。 ブラウザーがアイドル状態であるため、テストの実行の柔軟性を高めるために、この値を数日に増やすことに問題はありません。 このプロセスは、システムの再起動後も存続しません。 既定値は 86,400 秒 (24 時間) です。
(省略可能) $customChromePath - Microsoft Edge または Google Chrome が既定のパス (
C:\Program FilesまたはC:\Program Files (x86)) にインストールされていない場合は、この変数をブラウザーの実行可能ファイルのパスに設定します。 例えば：C:\Custom Path\Edge\msedge.exe
次のいずれかのオプションなど、任意の方法を使用して、ターゲット マシンでスクリプトを実行します。
GPO の使用
SCCMの使用
または、ドメイン コントローラーから手動で。 便宜上、呼び出しスクリプトの例を提供します。
remote-invocation.ps1 - Active Directory のすべてのコンピューターでランナー スクリプトを実行する PowerShell スクリプトをダウンロードします。
(省略可能)スクリプトを編集して、Active Directory クエリのスコープを、ニーズに基づいて限られたコンピューター グループに制限します。 高度なフィルター処理については、
Get-ADComputerコマンドレットの ドキュメントを参照してください 。
注:
ランナー スクリプトが、呼び出しスクリプトを実行しているディレクトリと同じディレクトリにあることを確認します。
注意
最適な結果を得るには、 ユーザー コンテキストでランナー スクリプトを実行します。 SYSTEM アカウントでランナー スクリプトを実行することは推奨されません。
サイレント テスト ダッシュボードに移動し、ターゲット マシンがオンライン ランナーとして表示されるようにします。
Mac 環境の実行手順
silent-tester-runner-mac.sh ダウンロード - バックグラウンドで Google Chrome を 24 時間起動する Bash スクリプト。
silent-tester-runner-mac.sh の編集:
ecdnCustomerId -
CUSTOMER_IDを Microsoft テナント ID に置き換えます。(省略可能) scenarioDuration - ブラウザーのアップタイム期間を目的の値 (秒単位) に設定します。 この期間、ターゲット マシンでサイレント テストを実行できます。 ブラウザーがアイドル状態であるため、テストの実行の柔軟性を高めるために、この値を数日に増やすことに問題はありません。 既定値は 86,400 秒 (24 時間) です。
たとえば、サイトでデバイスを管理するために使用されるツールに応じて、Jamf Pro では、さまざまなマシンでスクリプトを実行する方法が異なります。