PHPエージェントとHeroku

Heroku 、PHP を含むさまざまな言語で Web アプリケーションをホストするためのサービスとしてのプラットフォーム (PaaS) ソリューションです。 New Relic を使用すると、とのメトリクスを使用して 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コマンドを使って、アプリケーションに記述的な名前を付けます。
bash
```
$heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'
```
ビルド中に PHP 拡張機能を有効にするには、Heroku に変更 ( git commit --allow-emptyなど) をプッシュします。
あなたのアプリにトラフィックをもたらします。

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

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

数分以内に、 APM Summaryページにデータが表示され始めます。データが表示されない場合は、このドキュメントの検証およびトラブルシューティングの手順を参照してください。

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

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

各アプリからのメトリックが個別にレポートされるようにするには、各アプリにわかりやすい名前を付けます。アプリケーション名のデフォルトはPHP Application on Herokuです。

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

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

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

NEW_RELIC_APP_NAME=YOUR_APP_NAME

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

bash

$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コマンドを実行します。
bash
```
$heroku logs -t | tee newrelic.log
```
ログファイルを使用して問題を解決してください。
さらにサポートが必要な場合は、 support.newrelic.com でサポートを受けてください。

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

bash

$heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

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

bash

$heroku config:unset NEW_RELIC_LOG_LEVEL