newrelic_set_appname (API d'agent PHP)

Syntaxe

newrelic_set_appname(string $name)
newrelic_set_appname(string $name, string $license[, bool $xmit])

Définit le nom de l'application New Relic, qui contrôle rollup des données.

Exigences

Version de l'agent 3.1.5.111 ou supérieure.

Description

Définissez le New Relic application nom, que l’ New Relic UI utilise pour connecter vos données à l’ application appropriée.

La méthode recommandée et préférée pour définir le nom de l'application New Relic consiste à utiliser des paramètres INI globaux ou par répertoire pour associer votre application au nom souhaité au début de l'exécution.

Si vous ne pouvez pas modifier votre agent fichier de configuration (par exemple, de nombreux environnements d'hébergement partagé ne vous permettent pas de modifier les fichiers de configuration), l'appel d'newrelic_set_appname API peut être utilisé pour configurer le nom de l'application, clé de licence(facultatif, si vous utilisez plusieurs comptes) et un indicateur vrai/faux (facultatif, pour déterminer s'il faut conserver ou supprimer les données précédemment enregistrées). Pour assurer une continuité maximale de la trace APM, appelez ce service le plus tôt possible. Cet appel d'API supprimera toutes les données de transaction actuelles et démarrera une nouvelle transaction après s'être reconnecté avec le nom d'application donné.

Pour d'autres options de dénomination d'application, voir Nommez votre application PHP. Lorsque cela est possible, des solutions basées sur INI sont recommandées.

Comportement d'appel et de localisation

Nous vous recommandons vivement d'appeler cette fonction dès que possible après avoir commencé monitoring votre application et dans une stack d'appels aussi peu profonde que possible. les applications sont des entités discrètes dans APM, et lorsque vous modifiez le nom d'une application, rien ne permet de lier les données des deux noms d'application. L'utilisation de la fonction newrelic_set_appname peut entraîner une discontinuité de votre trace de transaction. En d’autres termes, les nouvelles transactions sont signalées sous le nouveau nom de l’application et rien ne permet de les lier aux données connectées à l’ancien nom de l’application.

Cette méthode est destinée à être appelée une fois, car chaque appel à l' API (même avec le même nom d'application) entraînera la suppression des données de transaction actuelles et conduira à une nouvelle discontinuité du suivi de la transaction.

Paramètres

function newrelic_set_appname(string $name) : bool

function newrelic_set_appname(string $name, string $license, bool $xmit) : bool

Valeurs de retour

Renvoie true si le nom de l'application a été modifié avec succès, ou false dans le cas contraire.

Exemples

Définir un nom d'application unique

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1");
    }
    ...
}

Définir deux noms d’application

Cet exemple définit plusieurs noms d’application:

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1;App2");
    }
    ...
}

Définir le nom de l'application et la clé de licence

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890");
    }
    ...
}

Définir le nom de l'application et conserver les données précédentes

Cet exemple définit un nom d'application et conserve les données existantes, mais ne modifie pas le clé de licence:

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "", true);
    }
    ...
}

Définissez le nom de l'application et la clé de licence, et conservez les données précédentes

Cet exemple définit le nom de l'application et la clé de licence, et conserve les données existantes :

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890", true);
    }
    ...
}