構文
newrelic_end_transaction([bool $ignore])
現在のトランザクションのインストルメントを直ちに停止する。
要件
エージェントのバージョン 3.0.5.95 以上。
説明
現在のトランザクションの計測をすぐに停止し、データをデーモンに送信します。この呼び出しは、PHP が現在のトランザクションを終了するときにエージェントが通常行うことをシミュレートします。この呼び出しの最も一般的な用途は、ジョブ キューの処理を処理するコマンド ライン スクリプトのインストルメンテーションを改善することです。特定のジョブの最後にこのメソッドを呼び出し、新しいタスクがキューから取り出されたときにnewrelic_start_transaction()
を呼び出します。
通常、トランザクションを終了するときに、エージェントに関連データを記録させます。ただし、 $ignore
をtrue
に設定してデータを破棄することもできます。
ヒント
newrelic_end_of_transaction()
を比較します。これは、トランザクションのタイミングを停止しますが、計測は続けます。
パラメーター
パラメータ | 説明 |
---|---|
ブール値 | オプション。デフォルトは
|
戻り値
トランザクションが正常に終了し、データが New Relic デーモンに送信された場合、 true
を返します。
例
トランザクションを停止してから別のトランザクションを開始する
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() { // this code is instrumented if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_end_transaction(); } // this code is ignored}