Sintaxe
newrelic_start_transaction(string $appname[, string $license])
Inicia uma nova transação, geralmente após encerrar manualmente uma transação.
Requisitos
Versão do agente 3.0.5.95 ou superior.
Descrição
Inicie uma nova transação manualmente. Geralmente usado após finalizar manualmente uma transação com newrelic_end_transaction()
, por exemplo, ao separar tarefas em um gerenciador de filas de trabalhos. Ao instrumentar esta nova transação, o agente executa as mesmas operações de quando o script foi iniciado pela primeira vez.
Parâmetro
Parâmetro | Descrição |
---|---|
corda | Obrigatório. O nome do aplicativo a ser associado aos dados desta transação. Usa o mesmo formato de Embora esta opção seja obrigatória, você pode ler o nome do aplicativo de |
corda | Opcional. O padrão é definido no arquivo Forneça um diferente se desejar que a transação seja reportada a uma conta New Relic diferente. Se definida, esta licença substituirá todas as licenças por diretório e padrão global configuradas em arquivos INI. |
Valores de retorno
Esta função retornará true
se a transação foi iniciada com sucesso.
Exemplos
Interrompa uma transação e inicie outra
Para gerenciadores de filas de tarefas, é possível usar newrelic_end_transaction()
e newrelic_start_transaction()
juntos para separar manualmente a transação. Este exemplo usa ini_get
para ler o nome do aplicativo no arquivo de configuração.
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}
Inicie uma nova transação com uma nova chave de licença
Este exemplo especifica manualmente o nome do aplicativo e o :
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_start_transaction("App1", "01234567890abcde01234567890abcde01234567890"); } ...}