当社のApacheインテグレーションは、Apache webサーバからNew Relicプラットフォームに、パフォーマンスメトリックスとインベントリデータを送信します。ご利用のApacheメトリックデータに関するプレビルドダッシュボードを閲覧し、アラートポリシーを作成して、独自のカスタムクエリおよびチャートを作成することができます。
このインテグレーションでは、Apacheの ステータスモードからデータを収集する仕組みとなっているため、モジュールを有効にしてご利用のApacheインスタンスに合わせて設定する必要があります(詳しくは要件を参照)。
インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。
互換性と要件
当社のインテグレーションは、Apacheバージョン2.2または2.4と互換性があります。
インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。
- ApacheステータスモジュールがApacheインスタンス向けに有効化かつ設定済み。
- Apacheインテグレーションを含むホストから利用できるApacheのステータスモジュールエンドポイント(デフォルトの
server-status
)。 - ApacheがKubernetesまたはAmazon ECSで実行されていない場合、Infrastructureエージェントが、Apacheを実行しているLinux OSホストにインストールされている必要があります。その他の場合:
インストールと有効化
Apacheインテグレーションをインストールするには、お使いの環境の指示に従います:
追加の注:
- 上級: インテグレーションをtarball書式で使用し、パッケージマネージャ以外でもインストールできます。
- オンホストインテグレーションは、自動的にアップデートしません。 最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。
インテグレーションを設定する
Apacheインテグレーション設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。
インストールの方法により、インテグレーションの設定方法はいくつかあります。
- Kubernetesを通じて有効化された場合: Kubernetesで実行しているサービスを監視するをご覧ください。
- Amazon ECSを通じて有効化された場合: ECSで実行しているサービスを監視するをご覧ください。
- オンホストでインストールされた場合: インテグレーションのYAML設定ファイルである
apache-config.yml
で設定を編集します。
設定オプションには次のものが含まれます。
metrics
:このコマンドは、特定のApacheサーバーのメトリックスを取得します。これは、単一の引数を取ります。status_url
:Apacheステータス情報モジュールを使用してメトリックスを付与するために設定されたURL。デフォルト値:http://127.0.0.1/server-status?auto
。セットアップをカスタマイズして異なるエンドポイントを使用するようにした場合は、この値を設定する必要があります。
inventory
:このコマンドは、Apacheのバイナリファイルを使用することで、Apacheが インベントリデータとして読み込んだモジュールを取得します。インベントリデータの収集を無効にするには、設定ファイルからインベントリコマンドを削除します。status_url
:この URL は、メトリックデータを収集するのと同じ Apache インスタンスにインベントリデータを添付するために使用されます。
labels
:env
ラベルは、environment
属性を制御します。デフォルト値はproduction
です。
一般的な設定の構成の詳細については、設定ファイルをご覧ください。
遠隔監視を起動する
remote_monitoring
パラメーターにより、このインテグレーションの遠隔監視とマルチテナンシーが有効になります。
remote_monitoring
を起動すると、一部の属性が変更されるほか、設定アラートに影響が及ぶ可能性があります。詳しくは、オンホストインテグレーションにおける遠隔監視を参照してください。
重要
remote_monitoring
を使用するには、Infrastructureエージェントのバージョン1.2.25以降が必要です。
環境変数パススルー
環境変数は構成設定の管理に使用された後、Infrastructureエージェントにパススルーされます。この機能の利用手順に関しては、Infrastructureエージェントを設定するを参照してください。
重要
シークレット管理を使用して、New Relic Infrastructureのエージェントによりオンホストインテグレーションを設定し、インテグレーションの設定ファイルにプレーンテキストで書き込みを行わずに(パスワードのような)機密データを使用できます。詳細については、シークレット管理をご覧ください。
データの検索と使用
このサービスからのデータは、インテグレーションダッシュボードにレポートされます。
ApacheデータはApacheSample
のイベントタイプに関連付けられています。トラブルシューティング目的で、またはチャートとダッシュボードを作成するために、このデータのクエリを行えます。
データの検索・使用方法の詳細については、 インテグレーションデータを理解するをご覧ください。
メトリックデータ
Apacheインテグレーションは、以下のメトリックデータ属性を収集します。メトリック名にはそれぞれ、net.
またはserver.
など、カテゴリインジケータとピリオドが先頭に付けられています。
名前 | 説明 |
---|---|
| 1秒あたりに処理されたバイト数。 |
| 1秒あたりのクライアントリクエスト数。 |
| ビジー状態のワーカーの現在の数。 |
| アイドル状態のワーカーの現在の数。 |
| レスポンスを処理してからTCP接続を終了中のワーカーの現在の数。 |
| DNSルックアップを実施中のワーカーの現在の数。 |
| 円満に終了中の現在のワーカーの数。 |
| クリーンアップ作業の準備が整った、アイドル状態のワーカーの現在の数。 |
| 持続的な接続を維持しているワーカーの現在の数。 |
| ロギング操作中のワーカーの現在の数。 |
| リクエスト(ヘッダまたはボディ)を読み込み中のワーカーの現在の数。 |
| 起動中の現在のワーカーの数。 |
| 手が空いているワーカーの合計数。リクエスト処理に必要のないワーカーは、開始できません。 |
| 書き込み中のワーカーの現在の数。 |
インベントリデータ
インベントリデータは、実行中のApacheと読み込まれたすべてのApacheモジュールからバージョン番号を取得し、それらのバージョン番号をconfig/apache
ネームスペースの下に追加します。インベントリデータの詳細についてはデータを理解するを参照してください。
システムメタデータ
Infrastructureエージェントによって収集された標準属性の他にも、インテグレーションはApacheSample
イベントタイプに関連付けられたインベントリデータも収集します:
名前 | 説明 |
---|---|
| Apacheサーバーのバージョン。例: |
トラブルシューティング
ソースコードをチェック
このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
- 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
- Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
- New Relicのデータセキュリティとライセンスドキュメントを見直してください。