PHP エージェントのインストール: Ubuntu と Debian

ここでは、Ubuntu または Debian を使っている環境に New Relic の PHP エージェントをインストールする手順について説明します。New Relic Servers の監視エージェントをインストールする手順については、サーバーモニターのインストール:UbuntuとDebian を参照してください。

注: インストール手順の一環として、デフォルトの アプリケーション名を意味のある名前に変更してください。

目次

リポジトリの設定

インストールパッケージを取得インストールする前に、最初のインポートし、New Relic リポジトリのキーを「信頼」する必要があります。これは、システムごとに一度実行する必要があります。root 権限で、以下のコマンドを実行します。

wget -O - https://download.newrelic.com/548C16BF.gpg | sudo apt-key add -

注: root 権限でこのコマンドを実行しない場合は、パブリックキーに関するエラーメッセージが表示されます。

インストールパッケージの取得

インストールパッケージの取得するは、2つの方法があります。

  • apt-get (推奨) を設定しますapt-get を実行すると、自動的にインストールパッケージ取得します。この方法を用いることで、New Relicのアップグレードや管理が簡単になります。システムごとに1度だけこれを行う必要があります。apt-get を実行する方法は、以下のとおりです。
    1. /etc/apt/sources.list.d/newrelic.list ファイルを作成する。
    2. newrelic.list を開き、以下のテキストを追加する。
      deb http://apt.newrelic.com/debian/ newrelic non-free
    3. newrelic.listを保存し、閉じる。
  • .deb ファイルを直接ダウンロードします。また、New RelicのWebサイトから .deb ファイルをローカルディスクにダウンロードすることもできます。そして、パッケージに対して dpkg または apt-get を実行します。お使いのシステム適したファイルダウンロードしてください。

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

注: 以下のコマンドは、初回インストール時にのみ適用されます。New Relicの古いバージョンがインストールされている場合は、エージェントのアップグレードを参照してください。

  1. お好きなパッケージマネージャーを利用して、エージェントとデーモンをインストールします。
    マネージャー インストール方法
    apt-get New Relicのリポジトリから直接インストールするには、以下を実行します。

    apt-get update
    apt-get install newrelic-php5
    32 ビット.deb New Relic の Webサイトから .deb ファイルをダウンロードし、以下を実行します。

    dpkg -i newrelic-php5-common_X.X.X.X_all.deb
    newrelic-daemon_X.X.X.X_i386.deb newrelic-php5_X.X.X.X_i386.deb
    64 ビット .deb New Relic の Webサイトから .deb ファイルをダウンロードし、以下を実行します。

    dpkg -i newrelic-php5-common_X.X.X.X_all.deb
    newrelic-daemon_X.X.X.X_amd64.deb newrelic-php5_X.X.X.X_amd64.deb
    tarball apt-get.deb がお使いのサーバー環境で正常に動かない場合は、バイナリ tarball からインストールしてください。
  2. パッケージ化されていない PHP 環境を使用している場合、New Relicのパッケージをインストールした後、root 権限として newrelic-install スクリプトを実行します。インストールプロセスでは、アプリケーション名とライセンスキーの入力を求められます。また、ヘッドレスインストールを利用するとpreseed your license key and application name via debconfもできます。
  3. 通常どおり、Webサーバーもしくは、FastCGI プロセスマネージャー(FPM)を再起動してください。

ライセンスキーとアプリケーション名の事前設定

ヘッドレスインストールでは、ライセンスキーアプリケーション名を事前設定が可能です。そのためには、お使いのディストリビューションが提供しているデフォルトの PHP5 パッケージを使用する必要があります。事前設定するには、debconf-set-selections経由で debconf データベースの値をセットします。

以下のキーは、newrelic-php5 パッケージにあります。

名前 タイプ
newrelic-php5/application-name

アプリケーション名。この文字列は、newrelic.ininewrelic.appnameにセットします。

string
newrelic-php5/license-key

あなたのNew Relic のライセンスキー。この文字列は、newrelic.ininewrelic.licenseにセットされます。

string

以下は、ライセンスキーとアプリケーション名をpreseedするためのコマンドの例です。

echo newrelic-php5 newrelic-php5/application-name string "My Application Name" | debconf-set-selections
echo newrelic-php5 newrelic-php5/license-key string "0123456789abcdef0123456789abcdef01234567" | debconf-set-selections

注: パッケージ化された PHP を使用していない場合、これらの設定は無視され、newrelic-install を実行するように要求されます。

さらに詳しい情報

追加のドキュメントリソースは次のとおりです。