PHPエージェントとHeroku

Heroku は、PHP をはじめとするさまざまな言語のウェブアプリケーションをホスティングする PaaS（Platform as a Service）ソリューションです。New Relicを使用すると、 APM やブラウザモニタリングからのメトリクスを使ってHerokuを拡張することができます。

アプリケーションの準備

PHP エージェントをインストールする前に、PHP ウェブアプリケーションが Heroku にインストールされて実行されていることを確認してください。詳細については、 Getting Started with PHP on Heroku を参照してください。

PHPアプリをHerokuにデプロイした後、PHPエージェントをインストールします。

HerokuのウェブサイトからNew Relicアドオンをインストールする場合。

New Relic Add-on Page から、サブスクリプションプランを選択します。
Select an app ドロップダウンから、アプリを選択します。
このHeroku toolbeltコマンドを使って、アプリケーションに記述的な名前を付けます。
```
heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'
```
ビルド中に PHP 拡張機能を有効にするには、Heroku に変更 ( git commit --allow-emptyなど) をプッシュします。
あなたのアプリにトラフィックをもたらします。

Heroku toolbeltでNew Relicアドオンをインストールするには。

Heroku toolbeltを介して、以下のコマンドを実行し、適切なサブスクリプションプランを代入します。
```
heroku addons:create newrelic:YOUR_PLAN_LEVEL
```
このHeroku toolbeltコマンドを使って、アプリケーションに記述的な名前を付けます。
```
heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'
```
ビルド中に PHP 拡張機能を有効にするには、Heroku に変更 ( git commit --allow-emptyなど) をプッシュします。
あなたのアプリにトラフィックをもたらします。

数分以内に、 APM Summary page にデータが表示され始めるはずです。データが表示されない場合は、本文書の検証およびトラブルシューティングの手順を参照してください。

Herokuはあなたのアプリのためにデフォルトの環境変数を自動的に設定します。設定をカスタマイズするには、 newrelic.ini ファイルを作成してHerokuにアップロードします。

"クリーンな" コピー newrelic.ini_.heroku [INI | 16KB] をダウンロードしてください。
newrelic.ini_.heroku のファイル名を newrelic.ini に変更します。
newrelic.ini をプロジェクトリポジトリのルートディレクトリにコピーします。
PHPエージェントの設定で説明されているように、設定をカスタマイズしてください。
注意
newrelic.license, newrelic.loglevel, newrelic.appname は変更しないでください。これらの設定は、Heroku toolbeltによって行われます。
設定ファイルの変更をリポジトリにコミットして、Herokuに変更をプッシュします。
このHeroku toolbeltコマンドで、カスタマイズした設定ファイルを使用するようにHerokuに指示します。
```
heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini
```

各アプリからのメトリクスが別々に報告されるようにするために、各アプリに記述的な名前を付けてください。アプリケーション名のデフォルトは、 PHP Application on Heroku です。

New Relic はアプリ名を使ってデータを集約します。この名前を変更しない場合、New Relic は、この同じ名前で追加インストールした各 PHP アプリのデータを集約します。

アプリケーションに名前を付けるには、このHeroku toolbeltコマンドを実行します。
```
heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'
```
アプリの名前変更を確認するには、次のように実行します。
```
heroku run env | grep NEW_RELIC_APP_NAME
```

確認画面で新しいアプリ名が表示されることを確認します。

NEW_RELIC_APP_NAME=YOUR_APP_NAME

HerokuがNew Relicアドオンをインストールしたことを確認するには、このHeroku toolbeltコマンドを実行します。

heroku run env | grep NEW_RELIC

これにより、Heroku の New Relic 環境変数のリストが生成されます。エージェントはこれらの環境変数を使用して、どのアカウントにデータを報告するかを決定します。少なくとも以下の変数が表示されるはずです。

NEW_RELIC_LICENSE_KEY='YOUR_LICENSE_KEY'
NEW_RELIC_LOG_LEVEL="warning"
NEW_RELIC_APP_NAME="YOUR_APP_NAME"

HerokuのPHPエージェントをトラブルシューティングするには、Herokuのウェブサーバーのログに保存されているログファイルを調べます。

Webサーバーのログを見るには、このHeroku toolbeltコマンドを実行します。
```
heroku logs -t | tee newrelic.log
```
ログファイルを使用して問題を解決してください。
さらにサポートが必要な場合は、 support.newrelic.com でサポートを受けてください。

PHP エージェントのデフォルトはwarningログレベルです。New Relic サポートは、 verbosedebugログレベルでログを要求する場合もあります。ログレベルをverbosedebugに変更するには、次の Heroku ツールベルトコマンドを実行します。

heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

verbosedebugログレベルでは、すぐに大量のデータが生成されます。この設定は、New Relic サポートが要求した場合にのみ使用し、次の Heroku ツールベルトコマンドを実行して出力を収集したらすぐにこの設定を削除します。

heroku config:unset NEW_RELIC_LOG_LEVEL