PHPエージェントのインストール

次の手順では、install.sh インストールスクリプトを使用して PHP エージェントをインストールする方法について説明しています。

  1. PHPエージェントのインストール「」の説明に従って、環境のサポートとシステム要件を確認します。
  2. php-agent インストールディレクトリを作成します。
    このディレクトリの所有者は Apache または PHP-FPM（FastCGI Process Manager）を実行するユーザーと同じである必要があります。Splunk AppDynamics では、このディレクトリの名前を /opt/appdynamics/php-agent. にすることが推奨されています。
    注: このドキュメントでは、PHP エージェント インストール ディレクトリを以下で示しています。このディレクトリの所有者は Apache または PHP-FPM（FastCGI Process Manager）を実行するユーザーと同じである必要があります。Splunk AppDynamics では、このディレクトリの名前を /opt/appdynamics/php-agent にすることが推奨されています。
  3. マシン上に複数の Apache インスタンスがある場合は、適切な ノード、php_ini dir、および php_ext dir オプションを使用して、各 Apache インスタンスに対して install.sh を 1 回ずつ実行します。
    参照先：

    コマンドラインから、ディレクトリを PHP エージェントのインストールディレクトリに変更し、エージェント ディストリビューションを展開します。以下にコマンド例を示します。

    オプション 説明
    Linux
    CODE 
    cd <php_agent_install>
tar -xvjf appdynamics-php-agent-x64-linux.tar.bz2
    Windows
    CODE 
    Expand-Archive -Path "C:\path\to\your\zipfile.zip" -DestinationPath "C:\path\to\extract\to"
  4. <<php_agent_install> ディレクトリに次の権限を設定します。

    • php：PHP エージェント ログ ディレクトリ内のすべてのディレクトリを、全員が読み取りおよび実行できるようにし、ディレクトリの所有者が書き込めるようにします。

      CODE 
      chmod -R 755 <php_agent_install>

    • logs：可能であれば、ログのサブディレクトリを全員が読み取り/書き込み/実行できるようにします。

      CODE 
      chmod 777 <php_agent_install>/logs

      ディレクトリアクセス権限777は、組織によっては寛大すぎる場合があります。その場合は単に、このディレクトリを apache/php/proxy ユーザが所有するようにしてください。

  5. 次のシンタックスを使用して自動化スクリプトを実行します。
    注: Windows の場合は、管理者アクセスがあることを確認します。

    コマンド引数は次のように説明されています。.  

    • -s オプション：エージェントに SSL（HTTPS）を使用してコントローラに接続させたい場合は、必要に応じて -s オプションを指定します。-s この場合、コントローラポートをコントローラのHTTPSポートに設定します。
    • -a account_name@account_access_key：必要なコントローラアカウント名とアカウントキー。アカウント名とアクセスキーを探すには、Splunk AppDynamics UI の右上隅にある をクリックしてから [License] をクリックします。
    • http-proxy-host と http-proxy-port：< と http-proxy-port> を設定して、<http-proxy-host> プロキシサーバを介してデータをコントローラにルーティングします。<http-proxy-host> はプロキシサーバのホスト名または IP アドレス、<http-proxy-port>はプロキシサーバで使用している HTTP または HTTPS ポートです。http-proxy-host を設定する場合は、http-proxy-port も設定する必要があります。
    • http-proxy-user と http-proxy-password-file: プロキシを使用し、プロキシサーバーがログイン情報を必要とする場合のユーザー名とパスワードファイル。
    • -e オプション：appdynamics_agent.so ファイルの拡張ディレクトリ。UbuntuおよびデフォルトPHP CLIバイナリを特定できない場合に必要です。
    • -ii オプション：appdynamics_agent.iniファイルの ini ディレクトリ。UbuntuおよびデフォルトPHP CLIバイナリを特定できない場合に必要です。このオプションは、Windows では使用できません。
    • -v オプション：インストゥルメント化する PHP のバージョン。有効な形式は、1 つまたは 2 つの小数点があるバージョン番号です。たとえば、7.4 や 7.4.29 です。デフォルトの PHP CLI バイナリを特定できない場合、または PHP CLI バイナリがない場合にのみ必要です。
    • -p オプション：PHP バイナリへのパス
    • enable-cli-long-running：true に設定すると、長期実行 CLI アプリケーションで PHP を保護します。デフォルトは false. です。「Suhosin パッチを使用した長期実行 CLI アプリケーション」を参照してください。
    • --log-dir=<dir>：エージェントおよびプロキシのログが書き込まれるディレクトリ。デフォルトは <php_agent_install>/logs ディレクトリです。
    • --proxy-ctrl-dir=<dir>：プロキシ制御ディレクトリ。指定しない場合、インストーラは一時的なディレクトリを作成します。

    すべてのオプションが使用されている場合、-e、-i、および -v オプションは -p オプションよりも優先されます。

    注:

    • Ubuntu では、インストールはルートユーザとして実行する必要があります。また、-e オプションを使用して appdynamics_agent.so ファイルの正しい拡張ディレクトリを指定し、-i オプションを使用して appdynamics_agent.ini ファイルの正しい ini ディレクトリを指定します。

    • Windows では、各コマンドラインオプションとその値の間に等号（=）を使用します。ファイルパスを指定する場合は、パス値を一重引用符または二重引用符で囲み、バックスラッシュが正しく処理されるようにします。

    オプション 説明
    Linux
    CODE 
    <php_agent_install>/install.sh  [-s] -a=<account_name>@<account_access_key>
[--http-proxy-host=<proxy_host>] [--http-proxy-port=<proxy_port>] [-e <php_ext_dir>] [-i <php_ini_dir>]
[-p <php_binary_dir>] [-v <php_version>]
 <controller-host> <controller-port> <app_name> <tier_name> <node_name>
    Windows
    CODE 
    <php_agent_install>\install.ps1  [-s] -a=<account_name>@<account_access_key>
[--http-proxy-host=<proxy_host>] [--http-proxy-port=<proxy_port>] [-e="<php_ext_dir>"]
[-p "<php_binary_dir>"] [-v <php_version>]
 <controller-host> <controller-port> <app_name> <tier_name> <node_name>
  6. オプション: ${AGENT_DIRECTORY}/php/conf/appdynamics_agent.ini（オプション、Windows のみ）${AGENT_DIRECTORY}/php/conf/appdynamics_agent.ini ファイルからエージェント構成フラグメントをコピーし、php.ini ファイルに貼り付けます。php.ini
  7. PHP-CLI のみをモニタするエージェントをインストールする場合を除き、Web サーバを再起動します。
インストールが失敗した場合は、「PHP エージェントのインストールに関する問題の解決」を参照してください。