サイレント テストのトラブルシューティング

Microsoft eCDN サイレント テスト フレームワークを使用すると、複数のデバイスでシミュレーションを簡単に実行して、ライブ ビデオ イベントの負荷の下で特定のネットワークがどのように動作するかをエミュレートして調べることができます。 すべての結果は、Microsoft eCDN の分析ダッシュボードに論理的に表示されます。

潜在的な問題:

• サイレント テストを作成できない
• ポリシーによってオンラインにアクセスできないようにブロックされたサイレント ランナー
• ランナー (またはピア) がサイレント テストに参加しない
• サイレント ランナーのインスタンス化を検証できない
• 分析の欠如
• ピアリング効率が低い
• 同時閲覧者と割り当てられたデバイスの間の大きな不一致

サイレント テストを作成できないソリューション

サイレント テストを作成するためのプラス (+) ボタンがない場合は、Microsoft Entra ユーザーに、サイレント テストの変更アクセス許可を付与する適切なロールが割り当てられていることを確認します。 詳細については、 アクセスの管理 に関するドキュメントの該当するロールを参照してください。

サイレント ランナーをブロックするポリシーの解決策

一部の Microsoft Edge ポリシーは、サイレント ランナーに干渉することが知られています。

ポリシーを変更した後、エンドポイントを再起動するか、サインアウト/インしてサイレント テストを再実行します。 「サイレント ランナーのインスタンス化を検証できない場合の解決策」セクションの説明に従 って、ランナーのインスタンス化を 確認します。

BrowserSignin ポリシー

一部のマネージド Windows エンドポイントでは、Microsoft Edge BrowserSignin ポリシーによって、サイレント ランナーが正しくインスタンス化されないようにすることができます。 このポリシーは、次のレジストリに格納されます。

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\BrowserSignin

値を 2 に設定すると、サイレント ランナーが依存している Web サイトを読み込む機能がブロックされ、ランナーがオンラインになることはありません。

ポリシー値をチェックするには (管理者として PowerShell を実行します)。

Get-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name BrowserSignin -ErrorAction SilentlyContinue

出力に BrowserSignin : 2が表示される場合は、次のように修復します。

• 推奨 (運用環境に推奨): グループ ポリシーまたは Microsoft Intune を使用してポリシーを一元的に更新し、Edge "BrowserSignin" 設定をブラウザーサインイン (未構成など) を許可するオプションに変更し、エンドポイントでポリシー同期を強制します。 ポリシーが変更されたら、サインアウト/サインインするか、デバイスを再起動します。

• 一時的なローカル テスト (管理者権限が必要): レジストリ値を 0 または 1 (または削除) に設定して、ポリシーが原因であるかどうかを検証します。

# Set BrowserSignin to 1 (creates or updates the value)
New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name BrowserSignin -PropertyType DWord -Value 1 -Force

# Or remove the policy value (if present)
Remove-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name BrowserSignin -ErrorAction SilentlyContinue

HeadlessModeEnabled ポリシー

マネージド Windows エンドポイントでは、Microsoft Edge HeadlessModeEnabled ポリシーを使用すると、サイレント ランナーのブラウザー インスタンスがヘッドレス モードまたはバックグラウンド モードで起動できなくなります。 ブラウザーが予期された (ヘッドレス) モードで起動できない場合、ランナーはオンラインになりません。

このポリシーは、次のレジストリに格納されます。

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\HeadlessModeEnabled

ポリシー値をチェックするには (管理者として PowerShell を実行します)。

Get-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name HeadlessModeEnabled -ErrorAction SilentlyContinue

ヘッドレス操作の HeadlessModeEnabled : 0を無効にする値が出力に表示される場合は、次のように修復します。

• 推奨 (運用環境に推奨): グループ ポリシーまたは Microsoft Intune を使用してポリシーを一元的に更新し、Edge "HeadlessModeEnabled" 設定をヘッドレス操作を許可するオプション ([未構成] や [有効] など) に変更し、エンドポイントでポリシー同期を強制します。 ポリシーが変更されたら、サインアウト/サインインするか、デバイスを再起動します。

• 一時的なローカル テスト (管理者権限が必要): ポリシーが原因であるかどうかを検証するために、レジストリ値を 1 (または削除) に設定します。

# Set HeadlessModeEnabled to 1 (creates or updates the value)
New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name HeadlessModeEnabled -PropertyType DWord -Value 1 -Force

# Or remove the policy value (if present)
Remove-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Edge' -Name HeadlessModeEnabled -ErrorAction SilentlyContinue

サイレント テストへのランナー参加の欠如に対するソリューション

コンプライアンスを確保するには、 サイレント テスト プロセスの概要を確認します。 詳細については、このトラブルシューティング ガイドに進んでください。

サイレント ランナーのインスタンス化を検証できないソリューション

サイレント ランナーは、ユーザーに目立たないように設計されているため、1 つのインスタンス化を検証することは、簡単な作業ではありません。 サイレント ランナーがアクティブかどうかを検証する場合は、次の点を確認します。

• [接続済みクライアント] は、サイレント テスト ダッシュボードでカウントされます。
• $env:TEMPがシステム設定パスであり、スクリプトで$TestID値が設定されている"$env:TEMP\p5_log_" + $TestID + ".txt"としてのログ ファイルの存在。 たとえば、"C:\Users\MYUSERNAME\AppData\Local\Temp\p5_log_123.txt"
• これらの各バックグラウンド プロセスの存在。
  • powershell または pwsh - サイレント ランナー スクリプトを実行する非表示の PowerShell インスタンス。その選択は通常、エンドポイント管理システムによって制御されます。
  • msedgeまたは chrome - シミュレートされたビューアーの役割を引き受ける非表示のブラウザー インスタンスChromium。
  • cmd または powershell - タイムアウトが経過した後に PowerShell と chromium プロセスを終了する非表示のウォッチドッグ プロセス。

分析の不足に対するソリューション

分析が見つからない場合は、個々のクライアントと Microsoft eCDN のバックエンドの間にブロックが発生していると推定されます。 管理コンソールを開き、[Advanced > Silent Tester] に移動してトラブルシューティングを開始します。 そのページの右上に疑問符 (?) リンクが表示され、手順 1 と手順 3 の追加情報が見つかるヘルパー ページに移動します。 または、「 サイレント テストを実行する方法」を参照することもできます。

1. TENANT_ID_HERE プレースホルダーの代わりにテナント ID を使用するように注意して、直接ランナー URL を開きます。 ここで指定したテンプレート URL から作成するか、 ヘルパー ページにある事前構築済みの URL を使用できます。 直接ランナー ページは、1 つのビューアーをシミュレートし、必要な接続の状態を調査します。

   https://st-sdk.ecdn.teams.microsoft.com/?customerId=TENANT_ID_HERE&adapterId=Direct
   

   

2. ブラウザーの DevTools を表示します。 Microsoft Edge でページを右クリックし、[検査] を選択します。

   重要

   次の手順でサイレント テストを開始する 前に DevTools を開く必要があります。または、分析のために重要なセッションのスタートアップ情報がキャプチャされません。

3. [サイレント テスター] ページに戻り、スケジュールされた (サイレント) テストを開始し、すべての設定はビデオ品質とは別に既定値のままにします。 ビデオ品質を静的な値 ( 480p - 1Mbps など) に設定して、ばらつきを取り除く。 開始すると、直接 ランナー ページに灰色の DIV バーが表示され、この例の図に示すように、ストリームが開始されたことを確認する "進行中のテスト" というテキストが表示されます。

   

   DevTool の [ネットワーク] タブでダウンロードされているビデオ チャンクを観察することで、セッションが進行中であることを確認することもできます。

   

4. DevTool の [ネットワーク ] タブと [コンソール ] タブでエラーがないか調べます。 セッションの開始に特に注意してください。

   "フォント" エラーを除き、赤でエラーが発生します。これは既知であり、不使用です。 Microsoft eCDN をブロックしていることを示す可能性のあるエラーは、トラブルシューティングの取り組みの公正なリードです。

   たとえば、[コンソール] タブで、次の図のような接続拒否エラーが発生する可能性があります。

   

   これは、サード パーティ プラットフォーム ページの [Web サイトの許可リスト] ページにドメインが一覧表示されていること、および Microsoft eCDN ドメインが許可リストに追加されていないことを示している可能性があります。

   

   または、IP が [セキュリティ] ページの [エンド ユーザー IP 許可リスト] に含まれていない場合もあります。

   

   注:

   どちらのフィルターでも、Microsoft eCDN が機能するためのエントリは必要ありません。 つまり、これらのフィルターのいずれかを未入力のままにすると、フィルターが無効になります。

   HTTP ビデオ データ チャンクが取得されていない場合は、バックエンドへの接続が妨げている可能性があります。ファイアウォール、プロキシなどです。ブロックされている URL またはプロトコルを特定できる場合は、ネットワークやセキュリティ チームにチェックして、その種類の接続が許可されているかどうかを確認します。 次のドキュメントを確認して、適切な例外が作成されていることを確認します。 ネットワーク要件、 クラウド、セキュリティドキュメント。

ピアリング効率を低くするためのソリューション

通常、低いピアリング効率は、クライアントが少なすぎる (20 歳未満) でサイレント テストを行う場合に発生します。 クライアントの数を増やすと、ピアリング グループが拡大されるため、ピアリングの効率が向上します。 その他の考えられる原因の一覧と、それぞれのトラブルシューティング方法については、 効率の低 いトラブルシューティングに関する記事を参照してください。

同時閲覧者と割り当てられたデバイスの間で大きな不一致が生じるソリューション

この状況は通常、次の場合に発生します。

• ローカルまたは企業のセキュリティ ソフトウェアが Microsoft eCDN をブロックしている
• 移行期間中にサイレント テストが実施されています (従業員が退社し、ワークステーションをシャットダウンする)

トラブルシューティングの方法を次に示します。

• 以降、移行期間 (従業員が退職する) でサイレント テストを開始することは避けてください。そのため、参加者の数が偏る可能性があります。

• Microsoft eCDN Analytics ダッシュボードにリアルタイム分析が反映されるまで、1 ~ 3 分かかります。

• ランナー URL がブロックされていないことを確認します。 詳細については、「 分析の欠如に関するソリューション 」セクションの手順を参照してください。