Apacheモニタリングインテグレーション

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

互換性および要件

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

New Relicアカウント。アカウントをお持ちでない場合無料サインアップクレジットカードは不要です。
Apacheバージョン2.2および2.4
Apacheステータスモジュールが、Apacheインスタンスに対して有効化かつ設定済みです。
Apacheインテグレーションを含むホストから使用できるApacheのステータスモジュールエンドポイント（デフォルトのserver-status）。

クイックスタート

KubernetesまたはECS環境でApacheを実行していない場合は、ガイド付きインストールをお勧めします。当社のガイド付きインストールでは、InfrastructureエージェントとCLIを使用してApacheインテグレーションを設定し、お客様の環境で実行されている他のアプリケーションとログソースを検出し、インストゥルメントすべきアプリケーションとログソースを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。

始める準備はできていますか？使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。

ガイド付きインストール（米国オプション）

ガイド付きインストール（EUオプション）

インストール

ガイド付きインストールを使用しない場合は、ご使用の環境に応じた手順に従ってください。

インテグレーションを更新する

このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インストール後のタスク

インストールが完了したら、設定オプションを設定できます。インテグレーションを機能させるには、設定がいくつか必要ですが、オプションの設定もあります。

Apacheサーバーの有効化

Apacheインテグレーションからデータを取得するには、以下が必要です。

Apacheステータスモジュールが、Apacheインスタンスに対して有効化かつ設定済みであることを確認します。
Apacheインテグレーションを含むホストから使用できるApacheのステータスモジュールエンドポイント（デフォルトのserver-status）であることを確認します。

インテグレーションの設定

ECSまたはKubernetesインテグレーションからこのインテグレーションを有効にした場合は、以下のドキュメントを参照してください。

標準オンホストインストールの場合、このインテグレーションにはYAML設定ファイル、apache-config.ymlが付属しています。この設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。コピーおよび編集できるサンプル設定ファイルapache-config.yml.sampleが付属しています。

設定に関するヒント：

インテグレーションディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、以下を実行して、サンプル設定ファイルのコピーを作成します。

cp apache-config.yml.sample apache-config.yml

設定プリファレンスに基づいて編集します。

完了したら、Infrastructureエージェントを再起動します。

自動Apacheアクセス、Apacheエラーログ解析および転送を有効にするには、apache-log-win.yml.exampleファイルをapache-log-win.ymlにコピー（または名前変更）します。エージェントを再起動する必要はありませんが、Apacheログファイルのデフォルトの場所を使用していない場合は、その場所でYMLファイルを更新する必要がある場合があります。

サンプル設定ファイルのコピーを作成するには、以下を実行します。

sudo cp apache-config.yml.sample apache-config.yml

設定プリファレンスに基づいて編集します。

完了したら、Infrastructureエージェントを再起動します。

自動Apacheアクセス、Apacheエラーログ解析および転送を有効にするには、apache-log.yml.exampleファイルをapache-log.ymlにコピー（または名前変更）します。エージェントを再起動する必要はありませんが、Apacheログファイルのデフォルトの場所を使用していない場合は、その場所でYMLファイルを更新する必要がある場合があります。

たとえば、

bash

$sudo cp /etc/newrelic-infra/logging.d/apache-log.yml.example /etc/newrelic-infra/logging.d/apache-log.yml

設定ファイルには、interval、timeout、inventory_sourceなどのこのNew Relicオンホストインテグレーションとその他に適用される共通の設定があります。これらの共通設定の詳細については、オンホスト設定フォーマットを参照してください。

設定ファイルのenvセクションを使用して、Apacheに関連する特定の設定を定義します。これらの設定は、Apacheインスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、このドキュメントの次のセクションで説明します。

設定ファイルの例もあります。

このドキュメントはインストールで役立ちましたか。

Apache設定オプション

Apacheインテグレーションは、メトリクスとインベントリの両方の情報を収集します。この表は、各設定オプションが何に適用されるかを示しています。

' ' ' ' ' ' ' ' ' ' ' ' ' '

設定	説明	デフォルト	適用先
STATUS_URL	ステータスモジュールを使ってメトリクスを付与するために設定されたURL。	http://127.0.0.1/server-status?auto	メトリクス、インベントリ
BINARY_PATH	Apacheバイナリファイルの場所を設定します。	該当なし	インベントリ
CA_BUNDLE_FILE	代替証明書機関のバンドルファイル。	該当なし	メトリクス
CA_BUNDLE_DIR	代替証明書機関のバンドルディレクトリ。	該当なし	メトリクス
VALIDATE_CERTS	ステータスURLが自己署名証明書を持つHTTPSの場合、`false`に設定されます。	true	メトリクス
REMOTE_MONITORING	マルチテナンシー監視を有効にします。	true	メトリクス、インベントリ
メトリクス	`true`に設定すると、メトリクスのみの収集が有効になります。	false
インベントリ	`true`に設定すると、インベントリのみの収集が有効になります。	false

これらの設定値は、いくつかの方法で定義できます。

設定ファイルに直接値を追加します（最も一般的な方法）。
{{}}表記を使用して、環境変数の値を置き換えます。これには、Infrastructureエージェントバージョン1.14.0以降が必要です。詳細については、Infrastructure設定または環境変数の例を参照してください。
シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。

ラベル

さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、属性（キーや値のペア）をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。

デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、選択したラベルを削除、変更、お好きな設定を新規追加することができます。

labels:
   env: production
   role: load_balancer

設定の例

以下に、YAML設定の例をいくつか示します。

これは、ローカルホストからメトリクスとインベントリを収集するための非常に基本的な設定です。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

この設定は、基本認証で保護されたローカルホストからメトリクスとインベントリを収集します。STATUS_URLのusernameとpasswordを認証情報に置き換えます。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://username:password@127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://username:password@127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

デフォルトでは、インテグレーションは/usr/sbin/httpdと/usr/sbin/apache2ctlの2つの異なる場所で、Apacheバイナリを検出しようとします。
Apacheがカスタムロケーションにインストールされている場合、またはMS Windowsを使用している場合は、BINARY_PATH設定を使用してApacheバイナリの正しい場所とファイル名を指定します。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      BINARY_PATH: 'C:\Apache\bin\httpd.exe'
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

この設定では、メトリクスのみを収集するためのMETRICS: trueを含むインテグレーションブロックが1つだけあり、VALIDATE_CERTS: falseを追加して、自己署名証明書の使用時にサーバーのSSL証明書の検証を防止します。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://my_apache_host/server-status?auto
      VALIDATE_CERTS: false
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

この設定では、メトリクスのみを収集するためのMETRICS: trueを含むインテグレーションブロックが1つだけあり、CA_BUNDLE_FILEを追加し、代替証明書ファイルを指定します。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://my_apache_host/server-status?auto
      CA_BUNDLE_FILE='/etc/ssl/certs/custom-ca.crt'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

この設定では、環境変数APACHE_STATUSを使用して、インテグレーションのSTATUS_URL設定を入力します。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: {{APACHE_STATUS}}
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

この設定では、同じインテグレーションから複数のApacheサーバーを監視しています。最初のインスタンス (STATUS_URL: https://1st_apache_host/server-status?auto) ではメトリクスとインベントリを収集し、2番目のインスタンス (STATUS_URL: https://2nd_apache_host/server-status?auto) ではメトリクスのみを収集します。

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://1st_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: https://1st_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://2nd_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

データの検索と使用

このインテグレーションからのデータは、one.newrelic.com > Infrastructure > Third-party services > Apacheから入手できます。

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エンドポイントにアクセスする際に問題がある場合は、以下の2つの解決策があります。

SSL証明書を無視することはできませんが、ca_bundle_fileとca_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を使用することもできます。

ソースコードのチェック

このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。

Apacheモニタリングインテグレーション

互換性および要件

クイックスタート

インストール

VMまたはオンプレミスホストにインストールする

ECS経由でインストール

Kubernetes経由でインストール

インテグレーションを更新する

インストール後のタスク

Apacheサーバーの有効化

インテグレーションの設定

Windowsの設定

Linuxの設定

このドキュメントはインストールで役立ちましたか。

Apache設定オプション

ラベル

設定の例

基本設定

HTTP基本認証

APACHEバイナリのカスタムロケーション

自己署名証明書のみを使用したメトリクス

代替証明書のみを使用したメトリクス

環境変数の置換