New Relic では、NerdGraph を使用して壊れたリンク モニターを作成できます。壊れたリンク モニターは、すべてのリンクをスキャンし、失敗した HTTP ステータス コードを返すリンクを報告することで、Web ページ上の壊れたリンクをチェックします。このチュートリアルでは、NerdGraph API を使用して壊れたリンク モニターの作成を自動化する方法の例を示します。
壊れたリンクモニターを作成する
syntheticsCreateBrokenLinksMonitorミューテーションを使用して壊れたリンク モニターを作成できます。このミューテーションにより、任意の Web ページの壊れたリンクの監視を設定できます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 整数 | はい | モニターが作成される New Relic 。 |
| 配列 | はい | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | はい | 壊れたリンク モニターの表示名。 |
| イナム | はい | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| イナム | はい | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| 弦 | はい | 壊れたリンクをスキャンする Web ページの URI (例:
)。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
| オブジェクト | いいえ | モニターを整理およびフィルタリングするためのタグ。各タグには
プロパティと
プロパティがあります。 |
サンプルリクエスト
mutation { syntheticsCreateBrokenLinksMonitor( accountId: ACCOUNT_ID monitor: { locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" period: PERIOD status: STATUS apdexTarget: APDEX_TARGET uri: "MONITOR_URI" tags: { key: "YOUR_TAG_NAME", values: "TAG_VALUE" } } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsCreateBrokenLinksMonitor": { "errors": null } }}モニターの作成中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
壊れたリンクモニターを更新する
syntheticsUpdateBrokenLinksMonitorミューテーションを使用して、既存の壊れたリンク モニターを更新できます。これにより、すでに作成されている壊れたリンク モニターの設定を変更できます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | 更新するモニターの一意のエンティティ 。 |
| 配列 | いいえ | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | いいえ | 壊れたリンク モニターの更新された表示名。 |
| イナム | いいえ | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| イナム | いいえ | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| 弦 | いいえ | 壊れたリンクをスキャンする Web ページの URI (例:
)。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
| オブジェクト | いいえ | モニターを整理およびフィルタリングするためのタグ。各タグには
プロパティと
プロパティがあります。 |
サンプルリクエスト
mutation { syntheticsUpdateBrokenLinksMonitor( guid: ENTITY_GUID monitor: { locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" period: PERIOD status: STATUS apdexTarget: APDEX_TARGET uri: "MONITOR_URI" tags: { key: "YOUR_TAG_NAME", values: "TAG_VALUE" } } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsUpdateBrokenLinksMonitor": { "errors": null } }}モニターの更新中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
壊れたリンクモニターを削除する
壊れたリンク モニターが不要になった場合は、 syntheticsDeleteMonitorミューテーションを使用してそれを完全に削除できます。
モニターを削除するには、 「合成モニターの削除」セクションを参照してください。