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