Apacheインテグレーション

当社のApacheインテグレーションは、Apache webサーバからNew Relicプラットフォームに、パフォーマンスメトリックスインベントリデータを送信します。ご利用のApacheメトリックデータに関するプレビルドダッシュボードを閲覧し、アラートポリシーを作成して、独自のカスタムクエリおよびチャートを作成することができます。

このインテグレーションでは、Apacheの ステータスモードからデータを収集する仕組みとなっているため、モジュールを有効にしてご利用のApacheインスタンスに合わせて設定する必要があります(詳しくは要件を参照)。

インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。

互換性と要件

当社のインテグレーションは、Apacheバージョン2.2または2.4と互換性があります。

インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。

このインテグレーションは、GitHubでのMITライセンスの下でオープンソースとしてリリースされます。

インストールと有効化

Apacheインテグレーションをインストールするには、お使いの環境の指示に従います:

ECS

ECSで実行しているサービスを監視するをご覧ください。

Kubernetes

Kubernetesで実行しているサービスを監視するをご覧ください。

Linux
  1. ファイル名nri-apacheを使用して、インテグレーションのインストールのための手順に従ってください。
  2. ディレクトリをインテグレーションのフォルダに変更する:

    cd /etc/newrelic-infra/integrations.d
    
  3. サンプルの設定ファイルのコピー:

    sudo cp apache-config.yml.sample apache-config.yml
    
  4. 環境設定で説明したとおり、apache-config.ymlファイルを編集します。

  5. Infrastructureエージェントを再起動 します。

追加の注:

インテグレーションを設定する

Apacheインテグレーション設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。

インストールの方法により、インテグレーションの設定方法はいくつかあります。

設定オプションには次のものが含まれます。

  • metrics:このコマンドは、特定のApacheサーバーのメトリックスを取得します。これは、単一の引数を取ります。
    • status_urlApacheステータス情報モジュールを使用してメトリックスを付与するために設定されたURL。デフォルト値: http://127.0.0.1/server-status?auto。セットアップをカスタマイズして異なるエンドポイントを使用するようにした場合は、この値を設定する必要があります。
  • inventory:このコマンドは、Apacheのバイナリファイルを使用することで、Apacheが インベントリデータとして読み込んだモジュールを取得します。インベントリデータの収集を無効にするには、設定ファイルからインベントリコマンドを削除します。
    • status_url:この URL は、メトリックデータを収集するのと同じ Apache インスタンスにインベントリデータを添付するために使用されます。
  • labelsenvラベルは、environment属性を制御します。デフォルト値はproductionです。

一般的な設定の構成の詳細については、設定ファイルをご覧ください。

遠隔監視を起動する

remote_monitoringパラメーターにより、このインテグレーションの遠隔監視とマルチテナンシーが有効になります。

remote_monitoringを起動すると、一部の属性が変更されるほか、設定アラートに影響が及ぶ可能性があります。詳しくは、オンホストインテグレーションにおける遠隔監視を参照してください。

remote_monitoringを使用するには、Infrastructureエージェントのバージョン1.2.25以降が必要です。

環境変数パススルー

環境変数は構成設定の管理に使用された後、Infrastructureエージェントにパススルーされます。この機能の利用手順に関しては、Infrastructureエージェントを設定するを参照してください。

STATUS_URL

Apacheステータス情報モジュールを使用してメトリックスを付与するために設定されたURL。

種類 文字列
デフォルト http://127.0.0.1/server-status?auto

例:

STATUS_URL='http://your.ip.address:8080/server-status?auto'
CA_BUNDLE_FILE

カスタムSSL証明書で用いる代替ファイル

種類 文字列
デフォルト (なし)

例:

CA_BUNDLE_FILE='/etc/ssl/certs/custom-ca.crt'
CA_BUNDLE_DIR

SSL証明書バンドルを見つけるにあたって使用する代替パス。

種類 文字列
デフォルト (なし)

例:

CA_BUNDLE_DIR='/etc/ssl/certs/custom/'

データの検索と使用

このサービスからのデータは、インテグレーションダッシュボードにレポートされます。

ApacheデータはApacheSampleイベントタイプに関連付けられています。トラブルシューティング目的で、またはチャートとダッシュボードを作成するために、このデータのクエリを行えます。

データの検索・使用方法の詳細については、 インテグレーションデータを理解するをご覧ください。

メトリックデータ

Apacheインテグレーションは、以下のメトリックデータ属性を収集します。メトリック名にはそれぞれ、net.またはserver.など、カテゴリインジケータとピリオドが先頭に付けられています。

名前 説明
net.bytesPerSecond 1秒あたりに処理されたバイト数。
net.requestsPerSecond 1秒あたりのクライアントリクエスト数。
server.busyWorkers ビジー状態のワーカーの現在の数。
server.idleWorkers アイドル状態のワーカーの現在の数。
server.scoreboard.closingWorkers レスポンスを処理してからTCP接続を終了中のワーカーの現在の数。
server.scoreboard.dnsLookupWorkers DNSルックアップを実施中のワーカーの現在の数。
server.scoreboard.finishingWorkers 円満に終了中の現在のワーカーの数。
server.scoreboard.idleCleanupWorkers クリーンアップ作業の準備が整った、アイドル状態のワーカーの現在の数。
server.scoreboard.keepAliveWorkers 持続的な接続を維持しているワーカーの現在の数。
server.scoreboard.loggingWorkers ロギング操作中のワーカーの現在の数。
server.scoreboard.readingWorkers リクエスト(ヘッダまたはボディ)を読み込み中のワーカーの現在の数。
server.scoreboard.startingWorkers 起動中の現在のワーカーの数。
server.scoreboard.totalWorkers 手が空いているワーカーの合計数。リクエスト処理に必要のないワーカーは、開始できません。
server.scoreboard.writingWorkers 書き込み中のワーカーの現在の数。

インベントリデータ

インベントリデータは、実行中のApacheと読み込まれたすべてのApacheモジュールからバージョン番号を取得し、それらのバージョン番号をconfig/apacheネームスペースの下に追加します。インベントリデータの詳細についてはデータを理解するを参照してください。

システムメタデータ

Infrastructureエージェントによって収集された標準属性の他にも、インテグレーションはApacheSampleイベントタイプに関連付けられたインベントリデータも収集します:

名前 説明
software.version Apacheサーバーのバージョン。例: Apache/2.4.7 (Ubuntu)

トラブルシューティング

ApacheでHTTPSエンドポイントにアクセスする際の問題

ApacheでHTTPSエンドポイントにアクセスする際に問題がある場合は、以下の2つの解決策があります。

  • SSL証明書を無視することはできませんが、ca_bundle_fileca_bundle_dirの設定ファイルパラメーターを、Apache設定ファイルにある未署名証明書をポイントするように設定することができます。例:

    instances:
    	- name: apache-server-metrics
    command: metrics
    arguments:
    	status_url: http://127.0.0.1/server-status?auto
    	ca_bundle_file: /etc/newrelic-infra/integrations.d/ssl/b2b.ca-bundle
    

    ca_bundle_dirを使用した例:

    ca_bundle_dir: /etc/newrelic-infra/integrations.d/ssl
    
  • HTTPSの代わりに、HTTPを使用することもできます。

その他のヘルプ

推奨する詳細情報: