概要

ブラウザテストは、Datadog が Web アプリケーション上で実行するシナリオです。世界中の複数の場所からさまざまなブラウザおよびデバイスを使用して実行され、テスト間隔は自由に設定できます。これらのテストは、アプリケーションが稼働してリクエストに応答していること、シナリオで定義された条件が満たされていることを確認します。

テストコンフィギュレーション

ブラウザテストの構成を定義します。

1. Starting URL を入力します。ブラウザテストがシナリオを開始する URL です。

2. 名前を追加します。ブラウザテストの名前です。

3. 環境と追加タグを選択します。ブラウザのテストにアタッチされる env と関連するタグを設定します。与えられた <KEY> に対する <VALUE> をフィルタリングするには、<KEY>:<VALUE> という形式を使用します。

4. ブラウザとデバイスを選択します。テストを実行するブラウザ (Chrome、Firefox、Edge など) とデバイス (Laptop Large、Tablet、Mobile Small など) です。

   • 大型のラップトップデバイスの場合、寸法は 1440 ピクセル × 1100 ピクセルです。
   • タブレットデバイスの場合、寸法は 768 ピクセル × 1020 ピクセルです。
   • 小型のモバイルデバイスの場合、寸法は 320 ピクセル × 550 ピクセルです。

5. 管理ロケーションとプライベートロケーションを選択します。Datadog が管理する世界中のロケーションを選択するか、プライベートロケーションを作成して、カスタムロケーションやプライベートネットワーク内からブラウザテストを実行することができます。

   Datadog’s out-of-the-box managed locations allow you to test public-facing websites and endpoints from regions where your customers are located.

   Americas	APAC	EMEA
   Canada Central (AWS)	Hong Kong (AWS)	Cape Town (AWS)
   Northern California (AWS)	Mumbai (AWS)	Frankfurt (AWS)
   Northern Virginia (AWS)	Seoul (AWS)	Ireland (AWS)
   Ohio (AWS)	Singapore (AWS)	London (AWS)
   Oregon (AWS)	Sydney (AWS)	Paris (AWS)
   São Paulo (AWS)	Tokyo (AWS)	Stockholm (AWS)
   Virginia (Azure)	Osaka (AWS)	Milan (AWS)
   	Jakarta (AWS)	Bahrain (AWS)

   The Datadog for Government site (US1-FED) uses the following managed location:

   Americas
   US-West

   また、Continuous Testing Tunnel を使用すると、ローカルの開発環境や CI/CD パイプライン内でテストをトリガーし、内部環境をテストすることができます。

6. テスト頻度を設定します。間隔は 5 分に 1 回から週に 1 回までさまざまです。1 分単位の頻度を希望する場合は、サポートにお問い合わせください。

高度なオプション

Variables

Create local variables

To create a local variable, click Create a Local Variable. You can select one of the following available builtins to add to your variable string:

{{ numeric(n) }}

Generates a numeric string with n digits.

{{ alphabetic(n) }}

Generates an alphabetic string with n letters.

{{ alphanumeric(n) }}

Generates an alphanumeric string with n characters.

{{ date(n unit, format) }}

Generates a date in one of Datadog’s accepted formats with a value corresponding to the UTC date the test is initiated at + or - n units.

{{ timestamp(n, unit) }}

Generates a timestamp in one of Datadog’s accepted units with a value corresponding to the UTC timestamp the test is initiated at +/- n units.

{{ uuid }}

Generates a version 4 universally unique identifier (UUID).

{{ public-id }}

Injects the Public ID of your test.

{{ result-id }}

Injects the Result ID of your test run.

To obfuscate local variable values in test results, select Hide and obfuscate variable value. Once you have defined the variable string, click Add Variable.

グローバル変数を使用する

Settings で定義されたグローバル変数は、ブラウザテストの詳細の Starting URL や Advanced Options のほか、テスト記録で使用することができます。

利用可能な変数の一覧を表示するには

• ブラウザテストの詳細で: 目的のフィールドに {{ と入力します。

• ブラウザテストのレコーダーで: テストに変数をインポートし、目的のフィールドに {{ を入力するか、アプリケーションに変数を挿入して使用します。

ブラウザテストの記録で変数を使用する方法については、ブラウザテストの手順を参照してください。

アラート条件を定義する

アラートの条件をカスタマイズして、通知アラートの送信をテストする状況を定義できます。

• N のうち n の数の場所で、X の時間（分）継続してアサーションが失敗した場合は、アラートがトリガーされます。このアラートルールにより、通知をトリガーする前にテストが失敗する必要がある時間と場所の数を指定できます。
• 場所が失敗としてマークされる前に、X 回再試行します。これにより、場所が失敗と見なされるために、連続していくつのテスト失敗が発生する必要があるかを定義できます。デフォルトでは、失敗したテストを再試行する前に 300 ミリ秒待機します。この間隔は、API で構成できます。

テストモニターを構成する

設定されたアラート条件に従って、通知が送信されます。このセクションを使用して、チームにメッセージを送る方法と内容を定義します。

1. ブラウザテストのメッセージを入力します。このフィールドでは、標準のマークダウン形式のほか、以下の条件付き変数を使用できます。

   条件付き変数	説明
   {{#is_alert}}	モニターがアラートを発する場合に表示します。
   {{^is_alert}}	モニターがアラートを発しない限り表示します。
   {{#is_recovery}}	モニターが alert から回復したときに表示します。
   {{^is_recovery}}	モニターが alert から回復しない限り表示します。
   {{#is_renotify}}	モニターが再通知したときに表示します。
   {{^is_renotify}}	モニターが再通知しない限り表示します。
   {{#is_priority}}	モニターが優先順位 (P1～P5) に一致したときに表示します。
   {{^is_priority}}	モニターが優先順位 (P1～P5) に一致しない限り表示します。

   通知メッセージには、このセクションで定義されたメッセージや、失敗した場所に関する情報が記載されます。

2. 通知するメンバーやサービスを選択します。

3. 再通知の頻度を指定します。テストの失敗を再通知しない場合は、Never renotify if the monitor has not been resolved オプションを使用してください。

4. Save Details and Record Test をクリックすると、テストの構成が保存され、ブラウザのステップが記録されます。

詳しくは、Synthetic テストモニターの使用をご覧ください。

ステップを記録する

テストの記録を実行できるのは Google Chrome だけです。テストを記録するには、Google Chrome 用の Datadog test recorder をダウンロードする必要があります。

アプリケーション上でアクションを実行するために (リンクをクリックして別のタブを開くなど) ブラウザテストの記録でタブを切り替え、別のテストステップを追加することができます。ブラウザテストは、アサーションを実行する前に、まず (クリックによって) ページと相互作用する必要があります。すべてのテストステップを記録することによって、ブラウザテストはテスト実行時に自動的にタブを切り替えることができます。

1. 必要に応じて、ページの右上にある Open in a pop-up を選択して、別のポップアップウィンドウでテスト記録を開きます。これは、アプリケーションが iframe で開くことをサポートしていない場合、または記録時のサイズの問題を回避したい場合に役立ちます。シークレットモードでポップアップを開いて、ログイン済みのセッションや既存のブラウザからの Cookie などを使用せずに、新しいブラウザからテストの記録を開始することもできます。

2. オプションとして、ブラウザテストからステップの記録を実行する際に、Datadog が自動的に RUM データを収集するように設定します。詳細については、RUM とセッションリプレイの確認を参照してください。

3. Start Recording をクリックして、ブラウザテストの記録を開始します。

4. 監視したいユーザージャーニーを通過するアプリケーションをクリックすると、アクションが自動的に記録され、左側のブラウザテストシナリオ内でステップを作成するために使用されます。

5. 自動的に記録されたステップに加えて、左上隅にあるステップを使用して、シナリオを強化することもできます。

   ブラウザテストによって実行されたジャーニーが期待される状態になったことを確認するために、Datadog では、ブラウザテストは**アサーション**で終了することを推奨します。

6. シナリオが終了したら、Save and Launch Test をクリックします。

権限

デフォルトでは、Datadog 管理者および Datadog 標準ロールを持つユーザーのみが、Synthetic ブラウザテストを作成、編集、削除できます。Synthetic ブラウザテストの作成、編集、削除アクセスを取得するには、ユーザーをこれら 2 つのデフォルトのロールのいずれかにアップグレードします。

カスタムロール機能を使用している場合は、synthetics_read および synthetics_write 権限を含むカスタムロールにユーザーを追加します。

アクセス制限

アカウントにカスタムロールを使用しているお客様は、アクセス制限が利用可能です。

組織内の役割に基づいて、ブラウザテストへのアクセスを制限することができます。ブラウザテストを作成する際に、(ユーザーのほかに) どのロールがテストの読み取りと書き込みを行えるかを選択します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

ブラウザテストによるユーザーエクスペリエンスの監視ブログ エンドツーエンドテスト作成のベストプラクティスブログ Synthetic テストの紹介ラーニングセンター ブラウザテストの概要ドキュメント Synthetic テストモニターについてDOCUMENTATION Terraform による Synthetic ブラウザテストの作成と管理外部サイト

[19] https://www.loc.gov/standards/iso639-2/php/code_list.php