application (Python API d'agent)

Syntaxe

newrelic.agent.application_settings(name=None)

Renvoie un objet de paramètres d'application.

Description

Cela renvoie une référence à l’objet des paramètres de l’application. global_settings L'objet contient les paramètres du configuration fichier et les variables d'environnement ; cet application_settings objet inclut en outre les configuration modifications définies côté serveur via l'UI New Relic.

Les paramètres renvoyés sont des objets hiérarchiques imbriqués et les noms des paramètres correspondent aux noms du fichier de configuration de l'agent. La principale raison d'exposer les paramètres de l'application est si vous souhaitez que votre instrumentation référence la configuration locale spécifique à l'agent et non celle définie côté serveur.

Si la valeur name n'est pas définie, l'appel utilise le nom de l'application spécifié dans le fichier de configuration de l'agent ou via la variable d'environnement NEW_RELIC_APP_NAME .

Si l'application n'a pas été enregistrée auprès du collecteur de données lorsque cet appel est effectué, elle renvoie la valeur None. Lorsqu'un appel est effectué avec succès et renvoie des valeurs, il reflète les valeurs de toute configuration locale superposée à la configuration côté serveur pour cette application obtenue lors de l'enregistrement.

Paramètres

Valeurs de retour

Renvoie un objet de paramètres d'application. L'objet lui-même ne présente aucune API publique ; certains autres appels nécessitent qu'il soit transmis.

Exemples

Utilisation d'une instruction IF

Vous souhaiterez peut-être vérifier les paramètres de configuration pour déterminer quelle instrumentation personnalisée implémenter. Voici un exemple d'utilisation d'une instruction if avec l'objet de paramètres d'application :

settings = newrelic.agent.application_settings()

if settings and settings.error_collector.enabled:
    ...

Passer les résultats dans le dictionnaire

Si vous effectuez un débogage ou un logging et que vous avez besoin des paramètres globaux en tant qu'objet de dictionnaire Python traditionnel, vous pouvez transmettre le résultat dans un dict. Par exemple:

settings_dict = dict(newrelic.agent.application_settings())

for name, value in settings_dict.items():
    print name, value

Chaque name sera le chemin complet en pointillés pour ce paramètre.