New Relic for PHP では、New Relic に報告されたり、New Relic に表示されたりするアプリケーション名を変更する方法がいくつかあります。このドキュメントでは、それらのネーミングオプションの概要を説明します。
APMアプリのネーミングに関する一般的な概要(PHPに特化したものではありません)については、 Name your application を参照してください。
アプリ名の設定・変更
New Relic では、アプリケーションをその名前で区別しています。アプリケーションのレポート名を変更すると、New Relic は新しいアプリケーションのエンティティを作成し、新旧のエンティティ間のデータの連続性を壊します。データの連続性を壊さずにアプリケーションの名前を変更するには、UIエイリアス変更オプションを使用します。
ここでは、New Relic で PHP アプリケーションの名前を変更する方法をご紹介します。
newrelic.appname
を使用してnewrelic.ini
ファイルを構成: 推奨され、最も一般的に使用されるオプションです。- Set per-directory INI settings: 1つのウェブサーバーで複数のアプリケーションを提供していて、それぞれに異なる設定や名前をつけたい場合に便利です。( Apache 、 PHP-FPM 、 NGINX in PHP-FPM の手順が記載されています)。
- Change alias via UI: これは、レポートされる基本的なアプリ名ではなく、UIのエイリアスのみを変更します。(このオプションは、APMでのデータの継続性を壊しません)。
- APIによる変更: アプリケーションコードを変更できる環境があり、直接インスツルメンテーションすることに問題がなく、この呼び出しによるトレースの継続性に問題がない場合のオプションです。
複数のアプリ名を使用する
複数のアプリ名を使用すると、APM で複数のアプリケーションのデータを同じ名前で集約することができます("rolling up" your data と呼ばれることもあります)。複数のアプリ名の仕組みについては、 Use multiple app names をご覧ください。
PHPの場合、最大で3つのアプリケーション名を設定できます。プライマリアプリケーション名が最初にあり、2番目と3番目の名前は、より一般的なデータ集計のカテゴリに使用されます。