• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

PHPエージェントの設定

PHPエージェントには、レポートされたデータのタイプと量を微調整するための多くの設定があります。ほとんどのユーザーにとっては、デフォルト値で最善のオーバーヘッドと使用しやすさが実現されます。ただし、特定のニーズに対する設定は変更できます。

重要

INI設定を変更後は、必ずウェブサーバーを再起動してください。再起動しないと、すぐに有効になりません

優先度の設定

以下の簡単な図は、PHPエージェントが設定で従う優先度です。サーバー側の設定には適用されません。PHPエージェントを使用してアプリのUIで変更できる唯一の値は、アプリのエイリアスとApdex-T値です。

New RelicのPHPエージェントを使用すると、API設定はディレクトリごとの設定を上書きします。ディレクトリごとの設定は、php.iniファイル設定を上書きします。サーバー側の設定には適用されません。

設定ファイルの変数

インストール中、newrelic-installスクリプトは、作成された設定ファイルまたは編集が必要なファイルのリストについての情報を提供します。デフォルトでは、newrelic.iniという名前の設定ファイルを作成しようとします。

場合によっては、設定オプションをphp.iniファイルに追加するよう指示されます。必要に応じて、そうしてください。どのファイルを編集する必要があるかは、PHPの特定のバージョン(1つまたは複数)が設定されている方法によって異なります。

2つの最も一般的な設定は、次のとおりです。

  • 単一のnewrelic.iniファイルを使用します。特別のオプションなしでPHPを自分でインストールまたはコンパイルした場合は、これが通常デフォルトとなります。
  • すべての.iniファイルについて所定のディレクトリをスキャンします。

どのファイルを編集するか分からない場合:

  • コマンドラインから、php -iの出力を見直します。

  • ブラウザで、次のスクリプトを含むページの出力を見直します:

    <?php phpinfo(); ?>
  • newrelic.iniファイルが表示されたら、それを使用します。

変数の範囲

newrelic.iniファイルの各変数には、定義された範囲があります。範囲は、設定をどこで確立または変更できるかを制御します。

New Relic設定にサポートされている2つの範囲は、次のとおりです。

  • SYSTEM

    :値はグローバルnewrelic.iniファイルでグローバルに設定されます。

  • PERDIR

    :値はディレクトリごとに設定されます。

それぞれを、より一般的なレベルで設定することもできます。それぞれの有効なロケーションは、次のとおりです。

Can be set for:

SYSTEM

PERDIR

グローバルnewrelic.iniファイルで設定します。

ディレクトリごとに設定します。

重要

New Relic設定に、ini_set()は使用できません。

変数のタイプ

newrelic.iniファイルの各変数には、定義されたタイプがあります。タイプによって使用する値の構文が指定されます。

Variable type

Formatting and contents

String

文字列値には、英数字とピリオドを含めることができます。値は引用符で区切られます。

Boolean

論理的な真偽設定。有効な値は、次のとおりです。

  • trueまたはenabledの場合:ontrue、番号1
  • falseまたはdisabledの場合:offfalse、番号0

Number

数値には、桁数に加え、フロートを表すピリオドのみを含めることができます。別途記載がある場合を除き、すべての数字はフロートではなく整数です。

Duration

期間を表す、引用符で区切られた文字列の値。文字フラグを使用して、時間コンポーネントを区切ります。フラグがない場合、時間はミリ秒となります。

  • w\= 週数

  • d\= 日数

  • h\= 時間

  • m\= 分

  • s\= 秒

  • ms\= ミリ秒

  • us\= マイクロ秒

    期間の例:

  • "1w3d23h10m"\= 1週、3日、23時間、10分

  • "5h30m"\= 5時間30分

  • "500"\= 500ミリ秒

一般構成設定

これらの設定は、newrelic.iniファイルで使用できます。

New Relic CodeStreamを使用してIDEからパフォーマンスを監視する場合は、リポジトリをサービスに関連付けビルドSHAまたはリリースタグをエラーに関連付ける必要があります。

Daemon .ini 設定

これらの設定の値は、デーモン起動を制御します。デーモンの起動が必要なことをエージェントが検知すると、これらのオプションが、デーモンに適切なコマンドラインオプションに変換します。

これらのすべての設定は、newrelic.cfgファイルの設定を反映します。すべての .ini設定を1か所に保管するため、これらはここで繰り返されます。newrelic.cfgの各設定ではここに、プレフィックスとしてnewrelic.daemon.が付いた相手があります。たとえば、newrelic.cfgssl設定は.iniファイルのnewrelic.daemon.sslです。

重要

ファイル/etc/newrelic/newrelic.cfgがある場合、エージェントはこれらの設定を無視し、デーモンを自動的に起動しません

デーモンの起動方法および外部設定ファイルをいつ使用するかの詳細については、PHPデーモン起動モードを参照してください。

Logs in Context

PHPエージェントのバージョン10.1.0では、APM logs in ContextとともにPHPログを転送できます。バージョン10.3.0以降は、ログメトリクスとエージェントログ転送機能がデフォルトで有効になっています。この値newrelic.application_logging.enabledは、Logs in Context機能の有効化または無効化を制御します。

ローカルエージェント設定ファイル(newrelic.ini)の設定を変更するには、ウェブサーバーを再起動し、設定変更を有効化する必要があります。再起動しないと、変更がすぐに有効にならない場合があります。

ログの転送

サポート対象のロギングフレームワークを使用している場合は、アプリのログをNew Relicに転送するようにエージェントに指示できます。

  • newrelic.application_logging.forward.enabled ログ転送を有効または無効にする
  • newrelic.application_logging.forwarding.max_samples_stored アプリからNew Relicに転送するログの数を制限する
  • newrelic.application_logging.forwarding.log_level アプリからNew Relicに転送するログの種類を選択する

ログコンテキストデータ

PHPエージェントは、Monologライブラリのコンテキストデータをキャプチャし、そのコンテキストを属性として転送されたログに追加します。エージェントが追加するコンテキストを制御するには、forwardingセクション内のcontext_dataセクションの設定を使用します。

  • newrelic.application_logging.forwarding.context_data.enabled Monologからのコンテキストデータをログ属性に追加する
  • newrelic.application_logging.forwarding.context_data.include 転送されたログで見つかる属性キーを定義する
  • newrelic.application_logging.forwarding.context_data.exclude 転送されたログで除外される属性キーを定義する

重要

PHPエージェントは、文字列キーと文字列またはスカラー(int、double、boolean)の値を持つログコンテキストデータのみを転送します。

ログ装飾

PHPエージェントは、リンクメタデータを収集しMonologログレコードに追加して、コンテキスト内のログが、サードパーティのログフォワーダーによって転送されたログデータと連携できるようにすることができます。この機能を有効にするには、newrelic.application_logging.local_decorating.enableオプションを使用します。

ログメトリクス

PHPエージェントは、サポート対象のロギングフレームワークのログイベントに関連するメトリクスを収集できます。newrelic.application_logging.metrics.enableオプションで、これらのメトリクスの作成が制御されます。

重要

既存のログ転送ソリューションがあり、コンテキストに応じて自動ログを使用するようにエージェントを更新する場合は、disable your manual log forwarderにしてください。そうしないと、アプリは重複したログデータを送信します。アカウントによっては、二重請求が発生する可能性があります。 詳細については、手順に従い、特定のログフォワーダーを無効にしてください。

トランザクショントレーサー .ini 設定

これらの設定値を使用して、トランザクショントレースを制御します。

その他のトレーサー .ini 設定

これらの設定値を使用して、さまざまなトレーサー機能を制御します。

属性の設定

このセクションには、属性の収集とレポートに影響を与える設定が一覧記載されています。

カスタムイベント

このセクションでは、カスタムイベントのレポートに影響する設定を示します。

コードレベルのメトリクス

このセクションでは、コードレベルのメトリクスのレポートに影響する設定を示します。

エラーインボックスの設定

次のタグのいずれかを設定すると、エラーが発生しているソフトウェアのバージョンを特定するのに役立ちます。

  • NEW_RELIC_METADATA_SERVICE_VERSION デプロイされているコードのバージョン(多くの場合、1.2.3などのセマンティックバージョン)を含むイベントデータにtags.service.versionが作成されますが、常にそうとは限りません。
  • NEW_RELIC_METADATA_RELEASE_TAG リリースタグを含むイベントデータにtags.releaseTagを作成します(v0.1.209またはリリース-209など)。
  • NEW_RELIC_METADATA_COMMIT コミットSHAを含むイベントデータに対してtags.commitを作成します。SHA全体、または最初の7文字(例:734713b)のみを使用することもできます。

エラーインボックスの今後のリリースでは、ソフトウェアのどのバージョンでエラーが発生しているかを自動追跡します。どのバージョンデータもCodeStreamに表示されます。

その他の .ini 設定

このセクションには、残りのnewrelic.ini設定が一覧記載されています。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.