OpenTelemetry と New Relic を使用して Jenkins を監視する

ジョブとパイプラインの実行を分散トレースとして視覚化することにより、 OpenTelemetry プラグインで Jenkins を監視します。クイックスタートをインストールして、Jenkins パイプラインを監視するための事前構築済みのダッシュボードを取得することもできます。

前提条件

まず、Jenkins から OpenTelemetry プラグインをインストールする必要があります。

1. ジェンキンスにログインします。

2. ダッシュボードから、

   Manage Jenkins

   をクリックします。

3. システム設定で、

   Plugins

   をクリックします。

4. Available plugins

   タブをクリックし、

   OpenTelemetry

   を検索します。

5. OpenTelemetry

   チェックボックスをオンにし、

   Install without restart

   選択します。

6. インストレーションが完了したら、

   Manage Jenkins

   をクリックします。

7. System Configuration

   で、

   System

   をクリックします。

8. 下にスクロールして、

   OpenTelemetry

   というセクションを確認します。 表示されない場合は、Jenkins を再起動してください。

構成

Jenkins OpenTelemetry プラグインが New Relic にデータを送信するように構成するには、New Relic OTLP エンドポイントとライセンスキー必要です。

1. OTLP エンドポイントを入力します。たとえば、 https://otlp.nr-data.net:4317 .

2. 認証には、

   Header Authentication

   選択します: a.

   Header Name

   フィールドに

   api-key

   と入力します。 b.

   Header Value

   フィールドに、 New Relic取り込みライセンスキーを含む秘密のテキストを入力します。

3. 変更を保存します。

New Relicライセンスキーで秘密のテキストを作成していない場合は、+ Add ボタンをクリックして Jenkins Credentials Provider を選択し、秘密のテキストを作成します。 kindとsecretを除いてデフォルト値をそのまま使用できます。 descriptionはオプションです。

1. Kind

   ドロップダウンから

   Secret text

   を選択します。

2. secret

   フィールドに、 New Relic取り込みライセンスキーを入力します。

3. 必要に応じて、秘密のテキストの目的を示す説明を追加します。

バリデーション

ジョブを実行するか、新しいパイプラインを作成して、New Relic で Jenkins データを表示します。パイプラインを構築する方法は次のとおりです。

1. Jenkins にログインし、

   New Item

   をクリックします。

2. アイテム名を入力し、

   Pipeline

   をクリックしてから

   OK

   をクリックします。

3. 一番下の

   Pipeline

   セクションまでスクロールします。

4. パイプライン スクリプトを使用して、

   try sample Pipeline...

   ドロップダウンからオプションを選択します。

5. [保存] をクリックします。

6. 新しく作成されたパイプラインで、

   Build Now

   をクリックします。

7. one.newrelic.com > All capabilities > APM & services > Services - OpenTelemetry > jenkins

   に到達しました。

8. Distributed tracing

   をクリックすると、ジョブとパイプラインの実行が視覚化されます。

9. Jenkins コンソール ログを表示するには、

   Logs

   クリックします。 ログがない場合は、環境変数OTEL_LOGS_EXPORTER="otlp"が設定されていることを確認してください。

Jenkins クイックスタート ダッシュボードをインストールする

Jenkins パイプライン データを New Relic に送信した後、 New Relic Instant Observabilityの事前構築済みダッシュボードを使用して、ジョブとパイプラインの実行を簡単に監視することもできます。事前構築済みのダッシュボードを使用して数分で開始し、統合されたビューで主要なメトリックを表示します。

1. New Relic Instantの Jenkins クイックスタートに移動し、

   + Install now

   をクリックします。

2. アカウントを選択し、

   Begin installation

   をクリックします。

3. 検証がすでに完了している場合は、

   done

   を選択して次のステップに進みます。

4. クイックスタートはリソースをアカウントにデプロイします。

   see your data

   をクリックしてダッシュボードにアクセスします。