New Relic 、NerdGraph を使用してスクリプト化ブラウザモニターを作成できます。 スクリプト化ブラウザモニターは、実際のブラウザ環境でカスタム JavaScript コードを実行し、複雑なユーザー インタラクションや複数ステップのワークフローをシミュレートできます。 このチュートリアルでは、NerdGraph API使用してスクリプト化ブラウザモニターの作成を自動化する方法の例を示します。
スクリプト化ブラウザモニターを作成する
syntheticsCreateScriptBrowserMonitorミューテーションを使用して、ブラウザ化ブラウザモニターを作成できます。 このミューテーションにより、ブラウザで JavaScript コードを実行するカスタム スクリプト監視を設定できます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 整数 | はい | モニターが作成される New Relic 。 |
| 配列 | はい | モニターがジョブを実行するために使用するBrowser 。 サポートされているブラウザ:
、
、
。 |
| 配列 | はい | モニターがジョブを実行するために使用するデバイス。サポートされているデバイス:
、
、
、
、
。 |
| 配列 | はい | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | はい | マイクロソフトブラウザモニターの表示名。 |
| イナム | はい | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| 弦 | はい | モニターで使用されるランタイム タイプ。受け入れられる値は
のみです。 |
| 弦 | はい | モニターで使用されるランタイム タイプのバージョン。受け入れられる値は
のみです。 |
| 弦 | はい | モニターで使用される言語。受け入れられる値は
のみです。 |
| 弦 | はい | モニターが実行する JavaScript コード。これは base64 でエンコードされたものではなく、プレーンテキストである必要があります。スクリプトは、 Seleniumウェブ API を使用してブラウザを制御できます。 |
| イナム | はい | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| ブール値 | いいえ | 障害が発生したときやスクリプトが実行されたときのジョブ実行中にスクリーンショットをキャプチャします。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
サンプルリクエスト
mutation { syntheticsCreateScriptBrowserMonitor( accountId: ACCOUNT_ID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } script: "SCRIPT_CONTENT" status: STATUS advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsCreateScriptBrowserMonitor": { "errors": null } }}モニターの作成中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
スクリプト化されたブラウザモニターを更新する
syntheticsUpdateScriptBrowserMonitorミューテーションを使用して、既存のブラウザ化ブラウザモニターを更新できます。 すでに作成されているブラウザ化ブラウザモニターの設定を変更することができます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | 更新するモニターの一意のエンティティ 。 |
| 配列 | いいえ | モニターがジョブを実行するために使用するBrowser 。 サポートされているブラウザ:
、
、
。 |
| 配列 | いいえ | モニターがジョブを実行するために使用するデバイス。サポートされているデバイス:
、
、
、
、
。 |
| 配列 | いいえ | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | いいえ | マイクロソフトブラウザモニターの更新された表示名。 |
| イナム | いいえ | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| 弦 | いいえ | モニターで使用されるランタイム タイプ。受け入れられる値は
のみです。 |
| 弦 | いいえ | モニターで使用されるランタイム タイプのバージョン。受け入れられる値は
のみです。 |
| 弦 | いいえ | モニターで使用される言語。受け入れられる値は
のみです。 |
| 弦 | いいえ | モニターが実行する JavaScript コード。これは base64 でエンコードされたものではなく、プレーンテキストである必要があります。 |
| イナム | いいえ | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| ブール値 | いいえ | 障害が発生したときやスクリプトが実行されたときのジョブ実行中にスクリーンショットをキャプチャします。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
サンプルリクエスト
mutation { syntheticsUpdateScriptBrowserMonitor( guid: ENTITY_GUID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } script: "SCRIPT_CONTENT" status: STATUS advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "errors": null } }}モニターの更新中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
マイクロソフト化ブラウザモニターのランタイムをアップグレードする
ブラウザ化ブラウザモニターをアップグレードして、新しいChrome 100 以降のランタイムを使用できます。 これにより、モニターで最新のブラウザ機能とセキュリティ更新が使用されるようになります。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | アップグレードするモニターの一意のエンティティ 。 |
| 弦 | はい | ランタイムタイプ。受け入れられる値は
のみです。 |
| 弦 | はい | ランタイムバージョン。受け入れられる値は
のみです。 |
| 弦 | はい | スクリプト言語。受け入れられる値は
のみです。 |
サンプルリクエスト
mutation { syntheticsUpdateScriptBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "CHROME_BROWSER" runtimeTypeVersion: "100" scriptLanguage: "JAVASCRIPT" } } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "errors": null } }}モニター ランタイムのアップグレードで問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionフィールドとtypeフィールドを持つオブジェクトが含まれます。
マイクロソフト化ブラウザモニターのランタイムをダウングレードする
ブラウザ化ブラウザモニターをダウングレードして、レガシー ランタイムを使用することができます。 これは互換性の理由で必要な場合がありますが、レガシー ランタイムは 2024 年 10 月 22 日にサポートが終了することに注意してください。
重要
レガシー ランタイムは非推奨となり、2024 年 10 月 22 日にサポートが終了します。一時的な互換性が必要な場合を除き、レガシー ランタイムへのダウングレードは推奨されません。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | ダウングレードするモニターの一意のエンティティ 。 |
| 弦 | はい | レガシーランタイムを使用するには、空の文字列
に設定します。 |
| 弦 | はい | レガシーランタイムを使用するには、空の文字列
に設定します。 |
| 弦 | はい | レガシーランタイムを使用するには、空の文字列
に設定します。 |
サンプルリクエスト
mutation { syntheticsUpdateScriptBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "", runtimeTypeVersion: "", scriptLanguage: "" } } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "errors": null } }}モニター ランタイムのダウングレードで問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionフィールドとtypeフィールドを持つオブジェクトが含まれます。
マイクロソフト化ブラウザモニターを削除する
シナリオ化ブラウザモニターが不要になった場合は、 syntheticsDeleteMonitorミューテーションを使用して完全に削除できます。
モニターを削除するには、 「合成モニターの削除」セクションを参照してください。