Syntaxe
newrelic_start_transaction(string $appname[, string $license])
Démarre une nouvelle transaction, généralement après avoir terminé manuellement une transaction.
Exigences
Version de l'agent 3.0.5.95 ou supérieure.
Description
Démarrer une nouvelle transaction manuellement. Généralement utilisé après avoir terminé manuellement une transaction avec newrelic_end_transaction()
, par exemple lors de la séparation des tâches dans un gestionnaire de files d'attente de travaux. Lorsque cette nouvelle transaction est instrumentée, l' agent effectue les mêmes opérations que lors du premier démarrage du script .
Paramètres
paramètres | Description |
---|---|
chaîne | Requis. Le nom de l'application à associer aux données de cette transaction. Utilise le même format que Bien que cette option soit obligatoire, vous pouvez lire le nom de l'application à partir de |
chaîne | Facultatif. La valeur par défaut est définie dans le fichier Fournissez un différent si vous souhaitez que la transaction soit signalée à un autre compte New Relic. Si elle est définie, cette licence remplacera toutes les licences par répertoire et par défaut globales configurées dans les fichiers INI. |
Valeurs de retour
Cette fonction renverra true
si la transaction a été démarrée avec succès.
Exemples
Arrêter une transaction, puis en démarrer une autre
Pour les gestionnaires de files d'attente de tâches, vous pouvez utiliser newrelic_end_transaction()
et newrelic_start_transaction()
ensemble pour séparer manuellement les transactions. Cet exemple utilise ini_get
pour lire le nom de l'application à partir du fichier de configuration.
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}
Démarrer une nouvelle transaction avec une nouvelle clé de licence
Cet exemple spécifie manuellement le nom de l'application et le :
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_start_transaction("App1", "01234567890abcde01234567890abcde01234567890"); } ...}