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をクリックしてダッシュボードにアクセスします。