global_settings (Python API d'agent)

Syntaxe

newrelic.agent.global_settings()

Cet appel renvoie une référence à l'objet de paramètres globaux de l'agent Python.

Description

Cet appel renvoie une référence à l'objet de paramètres de l'agent global, que vous pouvez ensuite utiliser pour apporter des modifications aux paramètres disponibles. L'objet de paramètres renvoyé contient des objets imbriqués et hiérarchiques. Les noms des paramètres correspondent aux noms des paramètres globaux dans le fichier de configuration de l'agent.

L'objet global_settings contient les paramètres du fichier de configuration et des variables d'environnement ; l'objet application_settings contient des modifications de configuration supplémentaires provenant de la configuration côté serveur.

Si vous mettez à jour les paramètres globaux à l'aide de l'objet Paramètres globaux, les modifications ne prendront effet que la prochaine fois que l'agent Python sera enregistré auprès du collecteur pour cette application spécifique.

Si vous y accédez avant l'initialisation de l'agent, les paramètres globaux auront les paramètres de configuration par défaut, ainsi que tous les remplacements des variables d'environnement utilisateur. Si vous y accédez après l'initialisation de l'agent, les paramètres globaux contiennent tous les paramètres du fichier de configuration de l'agent qui sont également des paramètres globaux (car le fichier de configuration contient moins de paramètres que l'objet de paramètres globaux).

Valeurs de retour

Renvoie une référence à l’objet de paramètres de l’agent global.

Exemples

Affectation de divers paramètres

Voici quelques exemples d'attribution des paramètres proxy_host, proxy_port, slow_sql.enabled et browser_monitoring.auto_instrument :

settings = newrelic.agent.global_settings()

settings.proxy_host = 'proxy.intranet' 
settings.proxy_port = 8888
settings.slow_sql.enabled = False
settings.browser_monitoring.auto_instrument = False

Passer des paramètres dans un 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. Voici un exemple :

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

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

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