New Relic Infrastructure 用の NGINX インテグレーション

New Relic Infrastructure NGINX インテグレーションは、NGINX インスタンスのデータを New Relic にレポートします。ここでは、NGINX インテグレーションをインストールし、有効にする方法と、キャプチャできるデータについて紹介します。インテグレーションに関する一般的な情報については、インテグレーションの概要をご覧ください。

この機能を利用できるかは契約しているサブスクリプションレベルによります。

互換性と要件

NGINX インテグレーションは、NGINX Open Source と NGINX Plus(商用版)の両方で機能します。

要件:

インストール

NGINX のインストール手順は以下の通りです。

  1. Infrastructure インテグレーションパッケージを入手します。
  2. bash を開き、インテグレーション用のフォルダに移動します。
  3. 以下を実行し、サンプルの背一定ファイルを作成します。
    cd /etc/newrelic-infra/integrations.d
    sudo cp nginx-config.yml.sample nginx-config.yml
    
  4. 次のセクションで説明するように、設定ファイル code>nginx-config.yml
  5. Infrastructure エージェントを再起動します。

設定

NGINX インテグレーションからデータをキャプチャするには、まず該当する拡張モジュールを有効にし、設定を行います。

インテグレーションには以下の2つのコマンドがあります。

  • metrics: 特定の NGINX サーバのメトリクスを取得します。引数は以下の通り。

    • status_url: ステータスモジュールを使ってメトリクスを取得できる URL。
      例: status_url: http://127.0.0.1/status
  • inventory: 設定ファイルに設定されている設定パラメータを取得します。引数は以下の通り。

    • config_path: NGINX の設定ファイルのパス
      例: config_path: /etc/nginx/nginx.conf.
      詳しくは、インベントリデータを参照。

システムのメタデータ

インテグレーションは、NGINX システムに関する以下のメタデータが収集します。その属性は、Insight の NginxSample イベントタイプから見つけることができます。

名前 説明
software.edition NGINX のエディション。"open source" もしくは "plus"
software.version NGINX のバージョン

メトリクス

NGINX インテグレーションは、以下のメトリックデータ属性を収集します。この属性は、Insight の NginxSample イベントタイプから見つけることができます。New Relic でインテグレーションデータを検索して使用する方法については、インテグレーションデータの検索と使用を参照してください。

NR 属性 単位 説明
net.connectionsAcceptedPerSecond connections / second コネクションで受信したクライアントのコネクション数(単位: 秒)
net.connectionsActive connections 現在アクティブなコネクション数。
net.connectionsDroppedPerSecond connections / second 受信したが、処理できなかったために落とされたコネクション数(単位:秒)。
net.connectionsReading connections nginx がリクエストヘッダを読み込んでいる現在のコネクション数。
net.connectionsWaiting connections リクエストを待機しているアイドル状態の現在のクライアントコネクション数。
net.connectionsWriting connections nginx がレスポンスをクライアントに書き戻している現在のコネクション数。
net.requestsPerSecond requests / second クライアントリクエストの合計。1秒あたりのリクエスト数。
NR 属性 単位 説明
net.connectionsAcceptedPerSecond connections / second コネクションで受信したクライアントのコネクション数(単位: 秒)
net.connectionsDroppedPerSecond requests / second ドロップしたクライアントコネクション数(単位:秒)。
net.connectionsActive connections 現在アクティブなコネクション数。
net.connectionsIdle connections 現在のアイドル状態のクライアントコネクション数。
net.requestsPerSecond requests / second 1秒あたりのリクエスト数

インベントリデータ

インテグレーションは、NGINX マスターの設定ファイル(通常は nginx.conf)で定義されている設定を取り込みます。

マスター設定ファイルには、設定を複数のファイルに分割するための "include <OTHER_FILE_NAME>" コマンドを含めることができます。 New Relic は include コマンドを解析しないので、それを使っている場合、設定が失われてしまいます。