newrelic_end_transaction (API do agente PHP)

Sintaxe

newrelic_end_transaction([bool $ignore])

Pare de instrumentar a transação atual imediatamente.

Requisitos

Versão do agente 3.0.5.95 ou superior.

Descrição

Pare imediatamente a transação atual instrumentada e envie os dados para o daemon. Esta chamada simula o que o agente normalmente faz quando o PHP encerra a transação atual. O uso mais comum dessa chamada é melhorar a instrumentação do script de linha de comando que trata do processamento da fila de trabalhos. Chame esse método no final de um trabalho específico e, em seguida, chame newrelic_start_transaction() quando uma nova tarefa for retirada da fila.

Normalmente, ao finalizar uma transação você deseja que o agente registre os dados associados. No entanto, você também pode descartar os dados definindo $ignore como true.

Parâmetro

Valores de retorno

Retornará true se a transação foi finalizada com sucesso e os dados foram enviados para o daemon New Relic.

Exemplos

Interrompa uma transação e inicie outra

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
}

Pare totalmente instrumentado

function example() {
    // this code is instrumented
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_end_transaction();
    }
    // this code is ignored
}