新しい合成モニター ランタイムに切り替えるための移行ガイド

モニターがレガシー ランタイム上にある場合は、それらの合成モニターを更新して、新しいランタイムの機能を利用することをお勧めします。それらを更新すると、パブリック モニターが実行されるバックエンド環境が改善されます。

切り替えを行うと、次の機能が提供されます。

• Chrome バージョン 100 以降にアクセスして、スクリプト化されたブラウザ モニタがエンド ユーザーが使用しているものと同様のバージョンのブラウザを使用できるようにします。
• 非推奨のrequestライブラリの代わりにgot node.jsライブラリを使用する更新されたスクリプトAPIランタイムへのアクセス。
• async/await構文のサポート。これにより、スクリプトの作成と保守が簡素化され、古いランタイムの.thenプロミスチェーンとは異なります。
• ShadowDOMオブジェクトのサポートが向上しました。
• スクリプト化されたAPIモニター用のカスタムタイミングライブラリ。

• NerdGraph APIにアクセスして、合成モニターの管理を自動化します。

プライベート ロケーションの要件

プライベートな場所で新しいランタイムを使用するには、 synthetics ジョブ マネージャーをインストールする必要があります。

モニターを新しいランタイムに変換します

既存のモニターは、作成時に使用されたランタイムにデフォルト設定されます。将来のサポート終了プロセス中に重要なモニターが破損するのを防ぐために、モニターを遅かれ早かれ変換することをお勧めします。

変換する：

1. one.newrelic.com > Synthetic monitoringに移動し、編集するモニターを選択します。
2. [一般]をクリックします。
3. ドロップダウン メニューを使用して、現在のランタイム ビューを切り替えます (スクリプト化された API モニターには Node.js 16 を使用し、スクリプト化されたブラウザー モニターには Chrome 100 を使用します)。
4. [検証]をクリックして、モニターが新しいランタイムで機能することを確認します。必要に応じて、スクリプトを変更します。
5. 保存する。

新しいランタイムでモニターを作成する

新しい単純なブラウザー モニター、スクリプト化されたブラウザー モニター、またはスクリプト化された API モニターを作成すると、新しいランタイムがデフォルトになります。合成ジョブ マネージャーの代わりにコンテナー化されたプライベート ミニオンを使用してプライベート ロケーションのモニターを作成している場合は、レガシー ランタイムに切り替える必要がある場合があります。

1. one.newrelic.com > Synthetic monitoring > Create monitorに移動し、作成するモニターの種類を選択します。
2. [ランタイム]ドロップダウンメニューを使用して、従来のランタイム環境と新しいランタイム環境を切り替えます。
3. モニターを作成します。

新しいランタイムは従来のランタイムと下位互換性がありますが、できるだけ早く新しい環境に変換することをお勧めします。

NerdGraphを使用してモニターを管理する

NerdGraph APIを使用して合成モニターを管理できます。以前の REST API 機能と比較すると、次のことが得られます。

• 証明書チェック モニター、リンク切れモニター、およびステップ モニターの管理。
• スクリプト化されたモニターを作成するための簡略化されたプロセス。
• (2 回の呼び出しではなく) 1 回の呼び出しだけで、スクリプト化されたモニターにスクリプトを添付する機能。
• モニターにタグを追加する機能。

NerdGraph では、 壊れたリンク、 ステップ、および 証明書チェック モニターをプログラムで作成することもできます。

スクリプト化されたAPIモニターでカスタムタイミングの詳細を取得する

レガシーランタイムで$httpオブジェクトまたはrequestモジュールを使用すると、スクリプト化されたAPIモニターの一部がタイミングの詳細を報告できるようになりました。結果の詳細は、スクリプトログ、チェック結果（pass / fail）に限定されており、Node.jsモジュールでは使用できませんでした。

新しい合成監視ランタイムには、デフォルトの$httpオブジェクトを使用するときにすぐに使用できるタイミングの詳細が含まれています。他のNode.jsモジュールを使用するときにカスタムタイミングの詳細を取得するには、 $harライブラリを使用してNewRelicにレポートします。

非推奨の機能

新しいランタイムには、構文の変更とその他の非推奨が含まれています。スクリプト化されたブラウザー モニターの スクリプト構文を 変更する新しい言語を導入します。新しいランタイムは、ほとんどの場合、従来のランタイム構文と下位互換性があります。アップグレード プロセス中にモニターが壊れるのを避けるために、スクリプト ログ出力に非推奨の警告が表示される場合があります。