NRDOT コレクター(推奨) またはOpenTelemetry Collectorを使用してホスト上で実行されている NGINX Plus サーバーを監視し、メトリクスとテレメトリーデータをNew Relicに送信します。
この統合では、 OpenTelemetry prometheusreceiverとnginx-prometheus-exporterを利用して、NGINX Plus のパフォーマンス メトリクス、接続統計、サーバーの健全性を監視します。 NGINX Plus の豊富な HTTP API 、標準の NGINX の基本的なスタブ ステータス モジュールと比較して、はるかに詳細なメトリックを提供します。

ダッシュボードは、 New Relic NGINX OpenTelemetryモニター クイックスタートから入手できます。
あなたが始める前に
以下のものを用意してください:
有効なNew Relicライセンスキー
NGINX Plus バージョンR13以上
HTTP APIモジュールを有効にしたNGINX Plus
NGINX Prometheus エクスポータがインストールされ、NGINX Plus インスタンスと一緒に実行され、HTTP APIメトリクスを Prometheus 形式で公開します
Linux ホストにインストールされている次のいずれかのコレクター:
- NRDOT コレクター(推奨 - New RelicのOpenTelemetryディストリビューション)、または
- OpenTelemetry Collector Contrib (代替オプション)
Linux ホストから次のネットワーク アクセス:
- NGINX Plus HTTP APIエンドポイント
- New Relic OTLPエンドポイント
NGINX Plusの監視を設定する
お好みのコレクターを選択し、設定手順に従ってください。
ヒント
検証手順のいずれかが失敗した場合は、続行する前に不足しているコンポーネントをインストールしてください。NRDOT コレクターのインストールについてサポートが必要ですか? nrdot -collectors-releases リポジトリのインストレーション セクションを確認してください。
インストレーション使用時 export collector_distro="nrdot-collector"
NRDOT コレクターを構成する
NGINX Plus Prometheus エクスポーターからメトリクスをスクレイピングし、 New Relicに送信するように NRDOT コレクターを構成します。
環境を構成し、構成パスを更新する
NRDOT コレクター設定を更新して、NGINX Plus 構成ファイルを使用し、OTLP エンドポイントを設定します。
New Relicリージョンに基づいて OTLP エンドポイントを決定します。 お住まいの地域でエンドポイントとサポートされているポートの完全なリストについては 、「エンドポイント、ポート、およびプロトコルの構成」を参照してください。
重要
ライセンスキーはインストール中にすでに/etc/nrdot-collector/nrdot-collector.confに設定されています。 構成ファイルのパスと OTLP エンドポイントを更新するだけで済みます。
コレクター設定ファイルを更新します。
$export collector_distro="nrdot-collector"$export otlp_endpoint="YOUR_NEWRELIC_OTLP_ENDPOINT" # Replace with your region's endpoint$
$# Update the config file path to point to nginx-plus-config.yaml$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/nginx-plus-config.yaml"|' /etc/${collector_distro}/${collector_distro}.conf$
$# Add the OTLP endpoint$echo "OTEL_EXPORTER_OTLP_ENDPOINT=${otlp_endpoint}" | sudo tee -a /etc/${collector_distro}/${collector_distro}.conf > /dev/null(オプション) NGINX ログの転送
メトリクスと一緒にログイベントが必要な場合は、コレクター設定を拡張してアクセスとエラーログを含めます。
監視を開始する
すべて設定が完了したら、NRDOTコレクターを起動して、データがNew Relicに流れていることを確認してください。
ヒント
検証手順のいずれかが失敗した場合は、続行する前に不足しているコンポーネントをインストールしてください。コレクターのインストールについてサポートが必要ですか? OpenTelemetry Collectorインストレーション ガイドを確認してください。
OpenTelemetryコレクターを構成する
NGINX Plus Prometheus エクスポーターからメトリクスを取得し、 New Relicに送信するようにOpenTelemetry Collector構成します。
認証を設定する
OpenTelemetry Collector が New Relic アカウントにデータを送信できるように、安全な認証を構成します。この手順では、資格情報を安全に保つために環境変数を設定します。
New Relicの認証情報を取得してください:
- ライセンスキー: APIキーUIページからライセンスキーを取得します。
- OTLP エンドポイント: New Relic OTLP エンドポイントから地域のエンドポイントを使用します
認証情報を設定します。
- systemd オーバーライド ディレクトリを作成します。
bash$export collector_distro="otelcol-contrib"$sudo mkdir -p /etc/systemd/system/${collector_distro}.service.d- 環境設定ファイルを作成します。
bash$cat <<EOF | sudo tee /etc/systemd/system/${collector_distro}.service.d/environment.conf$[Service]$Environment="NEWRELIC_OTLP_ENDPOINT=<`YOUR_NEWRELIC_OTLP_ENDPOINT>`"$Environment="NEWRELIC_LICENSE_KEY=`<YOUR_NEW_RELIC_LICENSE_KEY>`"$EOF
(オプション) NGINX ログの転送
メトリクスと一緒にログイベントが必要な場合は、コレクター設定を拡張してアクセスとエラーログを含めます。
監視を開始する
すべての設定が完了したら、OpenTelemetry Collector を起動し、データが New Relic に流れていることを確認します。
データを見つけて使用する
- one.newrelic.com > Integrations & Agentsに移動します。
- Dashboardsを選択し、 NGINX OTel overview [NGINX OTel 概要]ダッシュボード をクリックします。
- ポップアップウィンドウでアカウントを選択します。
- 「ダッシュボードの表示」をクリックし、New Relic で NGINX Plus データを表示します。
NGINX Plus メトリクスは、 Metricイベント タイプに関連付けられています。 このデータは、トラブルシューティングの目的で、またはカスタム チャートやダッシュボードを作成するために書き込むことができます。
メトリクスが収集されました
OpenTelemetry Collector 、 NGINX Prometheus エクスポーターからメトリクスを取得し、NGINX Plus HTTP APIメトリクスを Prometheus 形式で公開します。
以下は、利用可能な NGINX Plus メトリクスです。
次のステップ
データについて詳しくはこちらをご覧ください:
- NGINX データを見つけて書きます- ダッシュボードにアクセスし、カスタム書き込みを作成し、アラートを設定します
- NRQL入門- 高度なデータ分析のためのNew Relicのクエリ言語を学ぶ
- NRQLアラート条件の作成- NGINX Plus メトリクスに基づいてカスタム アラートを設定します
関連する監視を調べます:
- OpenTelemetryを使用したセルフホスト NGINX のモニター- 標準 NGINX デプロイメント用
- モニター NGINX on Kubernetes with OpenTelemetry - コンテナ環境向け