newrelic_end_transaction (API d'agent PHP)

Syntaxe

newrelic_end_transaction([bool $ignore])

Arrêtez immédiatement la transaction instrumentée en cours.

Exigences

Version de l'agent 3.0.5.95 ou supérieure.

Description

Arrêtez immédiatement la transaction instrumentée en cours et envoyez les données au daemon. Cet appel simule ce que l'agent fait normalement lorsque PHP termine la transaction en cours. L'utilisation la plus courante de cet appel est d'améliorer instrumentation du script de ligne de commande qui gère le traitement de la file d'attente des tâches. Appelez cette méthode à la fin d’une tâche particulière, puis appelez newrelic_start_transaction() lorsqu’une nouvelle tâche est retirée de la file d’attente.

Normalement, lorsque vous terminez une transaction, vous souhaitez que l'agent enregistre les données associées. Cependant, vous pouvez également supprimer les données en définissant $ignore sur true.

Paramètres

Valeurs de retour

Renvoie true si la transaction a été terminée avec succès et que les données ont été envoyées au daemon New Relic.

Exemples

Arrêter une transaction, puis en démarrer une autre

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
}

Arrêter l'instrumentation complètement

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