ジョブとパイプラインの実行を分散トレースとして視覚化することにより、 OpenTelemetry プラグインで Jenkins を監視します。クイックスタートをインストールして、Jenkins パイプラインを監視するための事前構築済みのダッシュボードを取得することもできます。
前提条件
まず、Jenkins から OpenTelemetry プラグインをインストールする必要があります。
- ジェンキンスにログインします。
- ダッシュボードからManage Jenkinsをクリックします。
- [システム構成] で、 [プラグインの管理] をクリックします。
- Availableタブをクリックし、検索バーにOpenTelemetryと入力します。
- OpenTelemetryチェックボックスを選択し、再起動せずにインストールします。
- インストールが完了したら、 Manage Jenkinsをクリックします。
- [システム構成] で、[システムの構成] をクリックします。
- 下にスクロールして、 OpenTelemetryというセクションを確認します。表示されない場合は、Jenkins を再起動します。
構成
New Relic OTLP エンドポイント と New Relic にデータを送信するように Jenkins OpenTelemetry プラグインを設定します。
- OTLP エンドポイントを入力します。たとえば、
https://otlp.nr-data.net:4317. - 認証には、[ヘッダー認証] を選択します。[ヘッダー名]フィールドにapi-keyと入力します。b.Header Valueフィールドに、New Relic インジェスト ライセンス キーを含むシークレット テキストを入力します。
- 変更を保存します。
New Relic ライセンス キーを使用してシークレット テキストを作成していない場合は、[ + 追加] ボタンをクリックし、[ Jenkins Credentials Provider ] を選択して作成します。kindとsecretを除いてデフォルト値をそのまま使用できます。説明はオプションです。
- [種類] ドロップダウンから、 [秘密のテキスト] を選択します。
- シークレットフィールドに、New Relic インジェスト ライセンス キーを入力します。
- 必要に応じて、秘密のテキストの目的を示す説明を追加します。
バリデーション
ジョブを実行するか、新しいパイプラインを作成して、New Relic で Jenkins データを表示します。パイプラインを構築する方法は次のとおりです。
- Jenkins にログインし、 New Itemをクリックします。
- 項目名を入力し、 [パイプライン] をクリックしてから [ OK ] をクリックします。
- パイプラインセクションまで一番下までスクロールします。
- パイプライン スクリプトを使用し、サンプル パイプラインを試す...ドロップダウンからオプションを選択します。
- [保存] をクリックします。
- 新しく作成されたパイプラインで、 Build Nowをクリックします。
- one.newrelic.com > APM & services > Services - OpenTelemetry > jenkins に移動します。
- [分散トレース]をクリックして、ジョブとパイプラインの実行を視覚化します。
- [ログ]をクリックして、Jenkins コンソールのログを表示します。ログがない場合は、環境変数
OTEL_LOGS_EXPORTER="otlp"が設定されていることを確認してください。
Jenkins クイックスタート ダッシュボードをインストールする
Jenkins パイプライン データを New Relic に送信した後、 New Relic Instant Observabilityの事前構築済みダッシュボードを使用して、ジョブとパイプラインの実行を簡単に監視することもできます。事前構築済みのダッシュボードを使用して数分で開始し、統合されたビューで主要なメトリックを表示します。
- New Relic Instant Observabilityの Jenkins クイックスタートに移動し、 + Install nowをクリックします。
- アカウントを選択し、[インストールの開始] をクリックします。
- 検証が既に完了している場合は、[完了] を選択して次のステップに進みます。
- クイックスタートにより、リソースがアカウントにデプロイされます。[データを見る] をクリックして、ダッシュボードにアクセスします。