このページは Cloud Translation API によって翻訳されました。

パフォーマンスログ

ChromeDriver ではパフォーマンスロギングがサポートされており、ここから次のイベントを取得できます。「タイムライン」、「ネットワーク」、「ページ」のほか、トレースデータトレースカテゴリを指定できます

パフォーマンスログを有効にする

パフォーマンスロギングはデフォルトでは有効になっていない。新しいセッションを作成する際は有効にする必要があります

DesiredCapabilities cap = DesiredCapabilities.chrome();
LoggingPreferences logPrefs = new LoggingPreferences();
logPrefs.enable(LogType.PERFORMANCE, Level.ALL);
cap.setCapability(CapabilityType.LOGGING_PREFS, logPrefs);
RemoteWebDriver driver = new RemoteWebDriver(new URL("http://127.0.0.1:9515"), cap);

有効にすると、パフォーマンスログでタイムライン、ネットワーク、ページが収集されますできます。トレースの有効化やパフォーマンスロギングのカスタマイズも行う場合は、あります。

デフォルトのオプションを使用したパフォーマンスロギングの完全な例（クレジット: Michael Klepikov）をご覧ください。

Angular Benchpress もパフォーマンスロギングを使用します。

トレースとカスタムロギング

パフォーマンスロギングをカスタマイズする必要がある場合、たとえばトレースを有効にするために、 perfLoggingPrefs 機能を使用できます。（ChromeOptions 経由）。トレースを有効にするには、1 つ以上の Chrome をトレースカテゴリを指定します。詳細情報: Chrome のトレース。

トレースを有効にすると、タイムラインドメインは暗黙的に無効になります。まだです loggingPrefs 機能を使用したパフォーマンスログを有効にする必要があります。

DesiredCapabilities cap = DesiredCapabilities.chrome();
LoggingPreferences logPrefs = new LoggingPreferences();
logPrefs.enable(LogType.PERFORMANCE, Level.ALL);
cap.setCapability(CapabilityType.LOGGING_PREFS, logPrefs);
Map<String, Object> perfLogPrefs = new HashMap<String, Object>();
perfLogPrefs.put("traceCategories", "browser,devtools.timeline,devtools"); // comma-separated trace categories
ChromeOptions options = new ChromeOptions();
options.setExperimentalOption("perfLoggingPrefs", perfLogPrefs);
caps.setCapability(ChromeOptions.CAPABILITY, options);
RemoteWebDriver driver = new RemoteWebDriver(new URL("http://127.0.0.1:9515"), cap);

perfLoggingPrefs を使用して、ネットワークとページを有効または無効にすることもできます。個別に管理できます。たとえば、ネットワークドメインを明示的に有効にすることで、トレース中:

...

Map<String, Object> perfLogPrefs = new HashMap<String, Object>();
perfLogPrefs.put("traceCategories", "browser,devtools.timeline,devtools");
perfLogPrefs.put("enableNetwork", true);
ChromeOptions options = new ChromeOptions();
options.setExperimentalOption("perfLoggingPrefs", perfLogPrefs);
caps.setCapability(ChromeOptions.CAPABILITY, options);

...

トレースが有効になっている場合、ChromeDriver は Chrome の実行時にブラウザ全体のトレースを開始します起動され、Chrome を閉じるまでトレースが続行されます。トレースが破棄されるとトレースを停止するまで、Chrome はトレースイベントをメモリにバッファします。

トレースバッファがいっぱいになると、トレースイベントは記録されなくなります。避けるべきことバッファがいっぱいになった（トレースデータが失われた）場合、ChromeDriver は定期的にバッファ内のイベントを収集して、特定の時点でトレースを再開。

トレースイベントを収集するとテストのオーバーヘッドが増加する可能性があるため、ChromeDriver のみがテスト中の適切なポイントでトレースイベントを収集します。現在、ページナビゲーションイベントの発生時にのみ収集され、などのログがリクエストされます。データアナリストのバッファがいっぱいになっているため、ChromeDriver がバッファの使用状況をサポートされている Chrome バージョン（r263512 以降）。バッファがいっぱいになると、ChromeDriver は警告を記録し、パフォーマンスログにエントリを追加します。

ログエントリの収集

テストでは、パフォーマンスログエントリを取得できます。詳しくは、 WebDriver のロギングに関するドキュメントをご覧ください。

for (LogEntry entry : driver.manage().logs().get(LogType.PERFORMANCE)) {
  System.out.println(entry.toString());
}

各エントリは、次の構造の JSON 文字列です。

{
  "webview": <originating WebView ID>,
  "message": { "method": "...", "params": { ... }} // DevTools message.
}

メソッドの値は、DevTools イベントのメソッドです。たとえば、タイムラインイベントには、すべてのイベントに対して Timeline.eventRecorded のメソッドが含まれます。バージョン 1.1 以前のプロトコル（その時点で最新の表示されます）。

トレースログエントリ

バージョン 1.1 では、トレースは公開された DevTools プロトコルの一部でないため、ご覧ください。

すべてのトレースイベントの WebView の値は「browser」、イベントは収集されます。

次の 2 つのトレースイベントメソッドを使用できます。

tracing.dataCollected: パラメータは、辞書形式の単一のトレースイベントです。
tracing.bufferUsage: パラメータには、1 つのエラーキーと、テスト中に DevTools トレースバッファがいっぱいになったことを示すメッセージが含まれます。

トレースイベントの例を次に示します。

{
    "webview":"browser",
    "message":{
        "method":"Tracing.dataCollected",
        "params":{
            "args":{"layerTreeId":1},
            "cat":"cc,devtools",
            "name":"DrawFrame",
            "ph":"i",
            "pid":11405,
            "s":"t",
            "tid":11405,
            "ts":3846117219.0,
            "tts":1134680
        }
    }
}

パフォーマンス ログ