Jenkins を使用して変更を追跡する

変更追跡機能を使用すると、監視する変更を指定して、顧客やシステムにどのような影響を与えるかを確認できます。GraphQL または CLI を使用して監視する変更を指定できますが、Jenkins のパイプラインを使用して変更を記録することもできます。

パイプラインは、指定したビルドを呼び出し、追加の環境変数をビルドプロセスに渡します。これにより、デプロイに必要なデータが入力され、New Relic 全体のチャートに表示されます。変更追跡 UI に結果が表示され、この情報を使用してエンティティの正常性に対する変更の影響を理解できます。

前提条件

Jenkins プラグインをインストールするには、次のものが必要です。

Jenkins を開いたら、 Manage Jenkinsに移動し、次にPluginsに移動します。
Available pluginsをクリックして、 newrelic-deployment-notifierを検索します。 Installをクリックします。
インストールの進行状況を示す新しいページが表示されます。プラグインを再起動する必要はありません。

New Relic Deployment Notifier をビルド後のアクションとして Jenkins ビルドジョブ設定に追加するには:

必須のVersionまたはRevision値と、任意の値を追加します。これらのフィールドでは、 ${BUILD_NUMBER}などの環境変数を使用できます。

フィールド	説明
説明	追跡対象の説明を挿入します。
リビジョン	導入のためのリビジョン。ここでは`${BUILD_NUMBER}`適切な値になる可能性があります。
変更ログ	展開で発生した変更のリストへの参照。
専念	コミット ID を参照するハッシュ。
ディープリンク	Jenkins ジョブまたはデプロイメントへのその他の参照へのディープリンク。
EntityGuid	展開に関するアプリケーションエンティティ (詳細については、アプリケーション GUIDを参照してください)。
展開タイプ	実施されているデプロイメントのタイプ。
グループ ID	変更のクラスターを参照するための識別子。
タイムスタンプ	オプションの Unix エポックロングフォーマットのタイムスタンプ。指定されていない場合は、リクエストを受信した時間に設定します。これは、Unix エポックからのミリ秒数になります。
バージョン	デプロイされているもののバージョン。ここでは`${BUILD_NUMBER}`適切な値になる可能性があります。
ユーザー	デプロイメントを実行するユーザー。 Tip: Build ユーザー Vars プラグインをインストールすると、Jenkins ユーザーに関する環境変数が設定され、それをこのフィールドで使用できます ( `${BUILD_USER}`など)。 $Screenshot showing User field set to ${BUILD_USER}$

(オプション) この Jenkins ジョブが複数のエンティティに影響を与える場合は、通知を受信するためにエンティティを追加することもできます。さらにアプリを追加するには、 Add another notificationボタンをクリックします。

追跡したい変更を指定したら、New Relic UI でそれらの変更の影響を分析できます。詳細については、 New Relic で変更を表示および分析する方法を参照してください。