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

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

newrelic_set_appname (PHPエージェントAPI)

構文

newrelic_set_appname(string $name)
newrelic_set_appname(string $name, string $license[, bool $xmit])

データロールアップを制御するNew Relicアプリ名を設定します。

要件

エージェントのバージョン 3.1.5.111 以上。

説明

New Relic アプリケーション名 を設定し、New Relic UI がデータを正しいアプリケーションに接続するために使用します。

New Relic のアプリケーション名を設定する方法としては、 グローバルまたはディレクトリごとの INI 設定 を使用して、実行開始時にアプリケーションを希望の名前に関連付けることが推奨され、好ましい方法です。

エージェント設定ファイルを編集できない場合 (たとえば、多くの共有ホスティング環境では設定ファイルの編集が許可されていません)、 newrelic_set_appname API 呼び出しを使用してアプリ名を設定できます。 (オプション、複数のアカウントを使用する場合)、および true/false フラグ (オプション、以前に記録されたデータを保持するか破棄するかを決定するため)。 APM トレースの継続性を最大限に確保するには、これをできるだけ早く呼び出します。この API 呼び出しは、現在のすべてのトランザクション データを破棄し、指定されたアプリ名に再接続した後に新しいトランザクションを開始します。

その他のアプリケーション名の付け方については、 Name your PHP application を参照してください。可能な限り、INI ベースのソリューションを推奨します。

通話とロケーションの動作

アプリの監視を開始したらできるだけ早く、コール スタックをできるだけ浅くして、この関数を呼び出すことを強くお勧めします。アプリケーションは APM の個別のエンティティであり、アプリの名前を変更すると、2 つのアプリ名のデータを結びつけるものは何もありません。newrelic_set_appname関数を使用すると、トランザクション追跡が不連続になる可能性があります。つまり、新しいトランザクションは新しいアプリ名に報告され、古いアプリ名に接続されたデータにそれらを結び付けるものは何もありません。

このメソッドは、1回だけ呼び出すことを想定しています。なぜなら、(同じアプリ名であっても)APIを呼び出すたびに、現在のトランザクションデータが破棄され、トランザクションのトレースがさらに不連続になるからです。

パラメーター

パラメータ

説明

function newrelic_set_appname(string $name) : bool

$name

ストリング

必須。アプリのメトリクスの名前は、New Relic ユーザー インターフェイスの下で報告する必要があります。newrelic.appnameと同じ形式を使用し、それぞれをセミコロン;で区切って複数のアプリケーション名を設定できます。

function newrelic_set_appname(string $name, string $license, bool $xmit) : bool

$name

ストリング

必須。アプリのメトリクスの名前は、New Relic ユーザー インターフェイスの下で報告する必要があります。newrelic.appnameと同じ形式を使用し、それぞれをセミコロン;で区切って複数のアプリケーション名を設定できます。

$license

ストリング

必須 (空の文字列にすることができます)。メトリクスを別の New Relic アカウントにレポートするには、別のライセンス キーを指定します。空の文字列に設定すると、エージェントのnewrelic.iniファイルのライセンス キーがデフォルトになります。

$xmit

ブール値

オプション。デフォルトはfalse件です。

falseまたは省略された場合、エージェントは現在のトランザクションを破棄し、この呼び出しまでにキャプチャされたすべてのデータが失われます。

trueの場合、エージェントはこの呼び出しを実行する直前に収集されたデータを送信します。データは古いアプリ名に関連付けられています。エージェントがデータをダンプするのに数ミリ秒かかるため、パフォーマンスにわずかな影響があります。

戻り値

アプリケーション名が正常に変更された場合はtrue 、そうでない場合はfalseを返します。

単一のアプリ名の設定

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_set_appname("App1");
}
...
}

2つのアプリ名を設定

この例では、 複数のアプリ名 を設定しています。

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_set_appname("App1;App2");
}
...
}

アプリ名とライセンスキーの設定

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890");
}
...
}

アプリ名の設定と過去のデータの保持

この例では、アプリ名を設定し、既存のデータを保持しますが、 :

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_set_appname("App1", "", true);
}
...
}

アプリ名やライセンスキーの設定、以前のデータの保持

この例では、アプリ名とライセンスキーを設定し、既存のデータを保持しています。

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890", true);
}
...
}
Copyright © 2024 New Relic株式会社。

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