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

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

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

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

互換性および要件

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

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

New Relicアカウント。アカウントをお持ちでない場合無料サインアップクレジットカードは不要です。
Apacheステータスモジュールが、Apacheインスタンスに対して有効化かつ設定済みです。
Apacheインテグレーションを含むホストから使用できるApacheのステータスモジュールエンドポイント（デフォルトのserver-status）。
ApacheがKubernetesまたはAmazon ECSで実行されていない場合、Infrastructureエージェントが、Apacheを実行しているLinux OSホストにインストールされている必要があります。その他の場合：
- Kubernetesで実行されている場合は、これらの要件をご覧ください。
- ECSで実行されている場合は、これらの要件をご覧ください。

クイックスタート

Apacheウェブサーバーを迅速に計装し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールは、New Relic CLIおよびインフラストラクチャエージェントをダウンロードおよびインストールする環境用にカスタマイズされたCLIコマンドを作成します。

始める準備はできていますか？ボタンの1つをクリックし、試行してください。

ガイド付きインストール

EUガイド付きインストール

当社のガイド付きインストールは、インフラストラクチャエージェントを使用してApacheインテグレーションを設定します。それだけではなく、環境内で実行中のその他のアプリケーションとログソースを発見し、どれを計装するべきかを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ニーズに合わない場合は、その他の方法を検索し、Apacheウェブサーバーのモニターを開始できます。

インストールと有効化

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

' '

ファイル名nri-apacheを使用して、インテグレーションのインストールのための手順に従ってください。
ディレクトリをインテグレーションのフォルダに変更する場合は、以下の手順に従います。
```
cd /etc/newrelic-infra/integrations.d
```
サンプルの設定ファイルのコピー：
```
sudo cp apache-config.yml.sample apache-config.yml
```
環境設定で説明したとおり、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
```

nri-apache.MSIインストーライメージをこちらからダウンロードします。
http://download.newrelic.com/infrastructure_agent/windows/integrations/nri-apache/nri-apache-amd64.msi

インストールするには、Windowsのコマンドプロンプトで次のコマンドを実行します。

msiexec.exe /qn /i PATH\TO\nri-apache-amd64.msi

インテグレーションディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、以下を実行して、サンプル設定ファイルのコピーを作成します。
```
cp apache-config.yml.sample apache-config.yml
```
環境設定を使用して、設定ファイルapache-config.ymlを編集します。
Infrastructureエージェントを再起動します。

追加の注：

アドバンスト：インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。
オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

設定

Apacheサーバーの有効化

Apacheインテグレーションからデータを取得するには、まずステータスモジュールを有効化し、設定する必要があります。

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

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

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

Kubernetesで有効化した場合：Kubernetes上で実行中のサービスの監視を参照してください。
Amazon ECSで有効化した場合：ECS上で実行中のサービスの監視を参照してください。
オンホストにインストールする場合：インテグレーションのYAML設定ファイルapache-config.ymlで設定を編集します。

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

設定ファイルには、interval、timeout、inventory_sourceなど、すべてのインテグレーションに適用される共通設定があります。これらの共通設定の詳細については、設定形式ドキュメントを参照してください。

重要

レガシー設定/定義ファイルを引き続き使用する場合は、このドキュメントを参照してください。

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

Apacheインスタンスの設定

Apacheインテグレーションはメトリクス（M）とインベントリ（I）の両方の情報を収集します。このテーブルでは、各収集に使用可能な設定にApplies To列を使用します。

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

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

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

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

ラベル／カスタム属性

さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、キーや値のペア属性をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。
デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、削除、変更、お好きな設定を新規追加することができます。

labels:
   env: production
   role: load_balancer

設定の例

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

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

データの検索と使用

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

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モニタリングインテグレーション

互換性および要件

クイックスタート

インストールと有効化

ECS

Kubernetes

Linux

Windows

設定

Apacheサーバーの有効化

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

重要

Apacheインスタンスの設定

ラベル／カスタム属性

設定の例

基本設定

HTTP基本認証

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

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

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

環境変数の置換