• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

newrelic_start_transaction (PHP エージェント API)

構文

newrelic_start_transaction(string $appname[, string $license])

通常、手動でトランザクションを終了した後に、新しいトランザクションを開始します。

要件

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

説明

新しいトランザクションを手動で開始します。通常、 newrelic_end_transaction()でトランザクションを手動で終了した後に使用されます。たとえば、ジョブ キュー マネージャーでタスクを分離する場合などです。この新しいトランザクションを計測するとき、エージェントはスクリプトが最初に開始されたときと同じ操作を実行します。

パラメーター

パラメータ

説明

$appname

ストリング

必須。このトランザクションからのデータに関連付けるアプリケーション名newrelic.appnameと同じ形式を使用し、それぞれをセミコロン;で区切って複数のアプリケーション名を設定できます。

このオプションは必須ですが、 ini_get("newrelic.appname") } を使用してnewrelic.iniからアプリ名を読み取ることができます。

$license

ストリング

オプション。デフォルトは、New Relic エージェントのnewrelic.iniファイルに設定されているライセンス キーです。

トランザクションを別の New Relic アカウントに報告したい場合は、別の ライセンスキー を提供してください。設定された場合、このライセンスは、INI ファイルで設定されたディレクトリごとおよびグローバルなデフォルトライセンスに優先します。

戻り値

トランザクションが正常に開始された場合、この関数はtrueを返します。

トランザクションを停止してから別のトランザクションを開始する

タスク キュー マネージャーの場合、 newrelic_end_transaction()newrelic_start_transaction()を一緒に使用して、手動でトランザクションを分離できます。この例では、 ini_getを使用して構成ファイルからアプリケーション名を読み取ります。

function example() {
... // queuing logic
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_end_transaction(); // stop recording the current transaction
newrelic_start_transaction(ini_get("newrelic.appname")); // start recording a new transaction
}
... // more queuing logic
}

新しいライセンス・キーで新しいトランザクションを開始する

この例では、アプリ名とライセンスキーを手動で指定しています。

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_start_transaction("App1", "01234567890abcde01234567890abcde01234567890");
}
...
}
Copyright © 2023 New Relic Inc.

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