Synthetic モニタリングの設定

概要

Synthetic Monitoring & Continuous Testing の設定ページで、次のトピックにアクセスして制御することができます。

デフォルトの設定

強制タグの設定

Usage Attribution ページでは、コストと使用量の属性を分析するために最大 3 つのタグを構成できます。Synthetic テストを作成または編集する際に、ユーザーがすべての構成済み使用量属性タグを入力することを要求するには、Enforce tags for usage attribution on all tests (すべてのテストで使用量属性に関するタグを強制する) を選択します。この設定を有効にした場合、ユーザーはすべての必須タグを入力しないとテストを保存できません。

デフォルトの場所

API テストマルチステップ API テスト、またはブラウザテストの詳細にデフォルトの場所を選択します。

Datadog で管理されるすべての場所と、ご使用のアカウントでセットアップしたプライベートロケーションから選択できます。

ロケーションの選択が完了したら、Save Default Locations をクリックします。

デフォルトのブラウザとデバイス

ブラウザテストの詳細で、デフォルトのブラウザとデバイスの種類を選択します。

ブラウザは、Google Chrome、Mozilla Firefox、Microsoft Edge から選択できます。デバイスは、大型のノートパソコン、タブレット、小型のモバイルデバイスから選択できます。

ブラウザとデバイスの選択が完了したら、Save Default Browsers & Devices をクリックします。

デフォルトのタグ

API テストマルチステップ API テスト、またはブラウザテストの詳細にデフォルトのタグを選択または追加します。

関連タグの選択が完了したら、Save Default Tags をクリックします。

ヘルプ

デフォルトでは、Datadog 管理者および Datadog 標準ロールを持つユーザーのみが Synthetic Monitoring Default Settings ページにアクセスできます。Default Settings ページにアクセスするには、ユーザーをこの 2 つのデフォルトのロールのいずれかにアップグレードします。

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

インテグレーション設定

インテグレーション設定ページ

ブラウザテスト用の APM インテグレーション

Datadog の APM インテグレーションヘッダーにより、Datadog はブラウザテストと APM を関連付けることができます。

APM ヘッダーを送信するエンドポイントを定義するには、Value リストに URL を追加します。エンドポイントがトレースされ、許可されている場合、ブラウザテストの結果は自動的にその対応するトレースに結びつけられます。

* を使用すると幅広いドメイン名を許容することができます。たとえば、https://*.datadoghq.com/* を追加すると、https://datadoghq.com/ のすべてが許可されます。URL の追加が完了したら、Save APM Integration Settings をクリックします。

詳しくは、Synthetics と APM トレースの接続をご覧ください。

Synthetic データ収集と RUM アプリケーション

テスト実行からの RUM データの収集を Datadog に許可するには、Enable Synthetic RUM data collection (Synthetic RUM データ収集を有効にする) をクリックします。無効にすると、ブラウザテストレコーダーで RUM 設定を編集することができなくなります。変更を適用するには、Save RUM Data Collection をクリックします。

新しいブラウザテストがデータを送信するデフォルトのアプリケーションを選択します。Default Application ドロップダウンメニューを使用し、ブラウザテストのデータを収集する RUM アプリケーションを選択します。変更を適用するには、Save RUM Data Applications をクリックします。

詳しくは、RUM とセッションリプレイの確認をご覧ください。

プライベートロケーション

詳しくは、プライベートロケーションから Synthetic テストを実行するをご覧ください。

グローバル変数

グローバル変数は、Synthetic テストのすべてからアクセス可能な変数です。テストスイートのシングルマルチステップ API テストブラウザテストモバイルアプリテストのすべてで使用することができます。

グローバル変数を作成するには、Synthetic Monitoring & Continuous Testing > Settings ページGlobal Variables タブに移動し、+ New Global Variable をクリックします。

作成する変数のタイプを選択します。

  1. Variable Name を入力します。変数名に使用できるのは大文字、数字、アンダースコアのみです。この名前は、グローバル変数全体で一意である必要があります。
  2. オプションで、Description を入力し、Tags を選択して変数と関連付けます。
  3. 変数に割り当てる Value を入力します。
  4. 変数の難読化を有効にすると、テスト結果に値が表示されません (オプション)。
グローバル変数による値の指定

既存の HTTP テストからは、関連するレスポンスヘッダーや本文をパースして変数を作成し、既存のマルチステップ API テストからは、抽出した変数を使用して作成することができます。

マルチステップ API テストから抽出できる利用可能な変数
  1. Variable Name を入力します。変数名に使用できるのは大文字、数字、アンダースコアのみです。

  2. オプションで、Description を入力し、Tags を選択して変数と関連付けます。

  3. 変数の難読化を有効にすると、テスト結果に値が表示されません (オプション)。

  4. 変数を抽出したい test を選択します。

  5. マルチステップ API テストを使用している場合、テストからローカル変数を抽出します。HTTP テストを使用している場合は、レスポンスヘッダーあるいはレスポンス本文から変数を抽出するように選択します。

    • Response Header から値を抽出: レスポンスのヘッダー全体を変数に使用するか、レスポンスのヘッダーを regex でパースします。
    • Response Body から値を抽出: リクエストのレスポンス本文全体を使用するか、レスポンス本文を regexjsonpathxpath でパースします。
    • Response Status Code から値を抽出する。

正規表現による値の抽出のほか、正規表現を使って次のようにパースすることもできます。

  • パターンの最初のインスタンスだけでなく、与えられたパターンのすべてのインスタンスにもマッチする
  • マッチングパターンの大文字小文字を無視する
  • 複数行に渡る文字列のマッチング
  • 渡された正規表現パターンをユニコードとして扱う
  • ピリオド記号で改行を識別できるようにする
  • 正規表現パターン内の指定されたインデックスからマッチする
  • マッチしたパターンを与えられた値で代用する
HTTP テストのレスポンス本文を正規表現でパースする

変数の値は抽出元のテストが実行される度に更新されます。

TOTP を生成しテストで使用するには、シークレットキーを入植する場所にグローバル変数を作成するか、認証プロバイダーからの QR コードをアップロードします。

  1. Choose variable typeMFA Token を選択します。
  2. Define Variable で、Variable Name を入力します。変数名に使用できるのは大文字、数字、アンダースコアのみです。
  3. オプションで、Description を入力し、Tags を選択して変数と関連付けます。
  4. 変数にシークレットキーを入力するか、QR コードイメージをアップロードします。
  5. + Generate をクリックして OTP を作成します。コピーアイコンを使用すると、生成した OTP をコピーできます。
MFA トークンの作成

ブラウザテストにおける TOTP ベースの MFA については、ブラウザテストにおける多要素認証 (MFA) のための TOTP を参照してください。

Synthetic テストでパスキーを使ってユーザージャーニーを完了するには、Virtual Authenticator グローバル変数を作成します。このグローバル変数は、Synthetic のすべてのブラウザテストでパスキーを生成し、保存するために使用されます。詳しくは、ブラウザテストでパスキーを使うを参照してください。

  1. Synthetic Monitoring & Continuous Testing > SettingsGlobal Variables タブに移動し、+ New Global Variable をクリックします。

  2. Choose variable type セクションで、Virtual Authenticator を選択します。

  3. Specify variable details セクションで、Variable Name を入力します。変数名に使用できるのは大文字、数字、アンダースコアのみです。

  4. オプションで、Description を入力し、変数に関連付ける Tags を選択します。Datadog は、パスキーの生成と保存に使用される Virtual Authenticator を作成します。

  5. Permissions settings セクションで、組織内のロールに基づいて変数へのアクセスを制限します。ロールの詳細については、RBAC ドキュメントを参照してください。

Virtual Authenticator の作成

一度作成したグローバル変数は、すべての Synthetic テストで使用することができます。グローバル変数をテストにインポートするには、+ Variables をクリックし、変数を追加するフィールドに {{ と入力し、グローバル変数を選択します。

変数については、HTTP テストマルチステップ API テストブラウザテストモバイルアプリテストブラウザテストステップのドキュメントをご参照ください。

ヘルプ

デフォルトでは、Datadog 管理者および Datadog 標準ロールを持つユーザーのみが Synthetic Monitoring Global Variables ページにアクセスできます。ユーザーをこの 2 つのデフォルトのロールのいずれかにアップグレードすると、Global Variables ページにアクセスできます。

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

アクセス制限

アカウントにカスタムロールを使用しているお客様は、アクセス制限が可能です。カスタムロール機能を使用している場合は、synthetics_global_variable_read および synthetics_global_variable_write 権限を含むカスタムロールにユーザーを追加します。

組織内のロールに基づきグローバル変数へのアクセスを制限できます。グローバル変数を作成する際に、Permissions settings で、グローバル変数の読み取りおよび書き込みが可能なロール (ユーザーに加えて) を選択します。

グローバル変数へのアクセス制限

インテグレーション設定

インテグレーション設定ページ

ブラウザテスト用の APM インテグレーション

APM インテグレーションのヘッダーをその URL に追加することを許可します。Datadog APM インテグレーションのヘッダーでは、APM を使用して Datadog をブラウザテストにリンクさせることができます。

APM ヘッダーを送信するエンドポイントを定義するには、Value フィールドに URL を入力します。エンドポイントがトレースされ、許可されている場合、ブラウザテストの結果は自動的にその対応するトレースに結びつけられます。

* を使用すると幅広いドメイン名を許容することができます。たとえば、https://*.datadoghq.com/* を追加すると、https://datadoghq.com/ のすべてが許可されます。URL の追加が完了したら、Save APM Integration Settings をクリックします。

詳しくは、Synthetics と APM トレースの接続をご覧ください。

Synthetic データ収集と RUM アプリケーション

Datadog がテスト実行から RUM データを収集することを許可するには、Enable Synthetic RUM data collection をクリックします。無効にすると、ブラウザテストレコーダーで RUM 設定を編集することができなくなります。データ収集の有効化が完了したら、Save RUM Data Collection をクリックします。

ブラウザテストデータを収集する RUM アプリケーションを Default Application ドロップダウンメニューから選択します。デフォルトアプリケーションの指定が完了したら、Save RUM Data Applications をクリックします。

詳しくは、RUM とセッションリプレイの確認をご覧ください。

その他の参考資料