構文
newrelic_start_transaction(string $appname[, string $license])
通常、手動でトランザクションを終了した後に、新しいトランザクションを開始します。
要件
エージェントのバージョン 3.0.5.95 以上。
説明
新しいトランザクションを手動で開始します。通常、 newrelic_end_transaction()
でトランザクションを手動で終了した後に使用されます。たとえば、ジョブ キュー マネージャーでタスクを分離する場合などです。この新しいトランザクションを計測するとき、エージェントはスクリプトが最初に開始されたときと同じ操作を実行します。
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必須。このトランザクションからのデータに関連付けるアプリケーション名。 このオプションは必須ですが、 |
ストリング | オプション。デフォルトは New Relic エージェントの 別のものを提供する トランザクションを別の 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"); } ...}