newrelic_end_of_transaction (PHP エージェント API)

構文

newrelic_end_of_transaction()

現在のトランザクションのタイミングを止めるが、インストルメントは続ける。

要件

すべてのAgentバージョンに対応しています。

説明

Web トランザクションのタイミングを直ちに停止します。ページがアプリのコードを完了し、データをストリーミング（ファイルのダウンロード、オーディオまたはビデオのストリーミングなど）しようとしているときに便利で、ストリーミング時間をトランザクションの実行時間の一部としてカウントしたくない場合に使用します。エージェントは、トランザクションの終了時にデーモンにデータを送信します。

これは、操作を完了するのにかかる時間が、アプリケーションの範囲外である場合に特に関係します。例えば、接続速度が非常に遅いユーザーは、小さなファイルをダウンロードするのにも非常に長い時間がかかる可能性があり、そのダウンロード時間が実際のトランザクション時間を歪めてしまうことは避けなければなりません。

パラメーター

このコールはパラメータを受け取りません。

例

データを流した後にタイミングを止める［#ストリーミングの例］

function example() { 
    // computational logic
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_end_of_transaction(); // Used to stop recording the transaction after computing for the transaction is complete, typically when streaming data 
    }
    //streaming data
}