PHPエージェントとHeroku

Herokuは、PHP を含むさまざまな言語で Web アプリケーションをホストするための Platform as a Service (PaaS) ソリューションです。 New Relic を使用すると、 APMとブラウザ監視のメトリクスを使用して Heroku を拡張できます。

アプリケーションの準備

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

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

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

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

Herokuでのエージェントの設定

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

1. newrelic.ini_.heroku の「クリーン」コピーをダウンロードします [INI | 16KB]。

2. ファイルの名前を newrelic.ini_.heroku から newrelic.iniに変更します。

3. newrelic.ini をプロジェクト リポジトリのルート ディレクトリにコピーします。

4. PHPエージェントの設定 で説明されているように、設定をカスタマイズしてください。

   注意

   newrelic.license、 newrelic.loglevel、または newrelic.appnameは変更しないでください。これらの設定は Heroku ツールベルトによって構成されます。

5. 設定ファイルの変更をリポジトリにコミットして、Herokuに変更をプッシュします。

6. このHeroku toolbeltコマンドで、カスタマイズした設定ファイルを使用するようにHerokuに指示します。

   bash

   コピー

   $
   heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

アプリケーション名

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

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

1. アプリケーションに名前を付けるには、このHeroku toolbeltコマンドを実行します。

   bash

   コピー

   $
   heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'

2. アプリの名前変更を確認するには、次のように実行します。

   bash

   コピー

   $
   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"

phpinfoを使用して、アプリがインストゥルメントされていることを確認することもできます。

Herokuでのエージェントのトラブルシューティング

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

1. Webサーバーのログを見るには、このHeroku toolbeltコマンドを実行します。

   bash

   コピー

   $
   heroku logs -t | tee newrelic.log

2. ログファイルを使用して問題を解決してください。

3. さらにサポートが必要な場合は、 support.newrelic.com でサポートを受けてください。

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

$
heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

$
heroku config:unset NEW_RELIC_LOG_LEVEL