Syntaxe
newrelic.agent.initialize(config_file=None, environment=None, ignore_errors=None, log_file=None, log_level=None)Initialise l'agent Python avec un fichier de configuration spécifié lors d'un processus d'intégration manuel.
Description
Ceci est appelé pour initialiser l'agent Python avec un fichier de configuration spécifié lorsque l'agent est intégré manuellement à une application Python.
Pour de meilleurs résultats d’instrumentation, effectuez cet appel le plus tôt possible dans le code de votre application. Contrairement aux fonctionnalités Python typiques, l’ordre d’importation est important. Pour les fichiers de script WSGI et d'application, placez l'appel initialize avant toutes les importations, à l'exception de l'importation sys et des mises à jour de sys.path. Si vous appelez initialize plusieurs fois, l'agent ignore les appels après le premier si le fichier de configuration et les options d'environnement sont identiques. Si les options diffèrent, une exception est levée.
Si vous appelez initialize sans argument, vous devez déjà avoir spécifié votre avec la variable d'environnement NEW_RELIC_LICENSE_KEY . Alternativement, vous pouvez définir NEW_RELIC_CONFIG_FILE et NEW_RELIC_ENVIRONMENT. L'agent lira ensuite ces valeurs à la place des arguments manquants.
Paramètres
paramètres | Description |
|---|---|
chaîne | Facultatif. Le chemin vers le fichier de configuration de l'agent. Si vous fournissez un fichier de configuration, vous pouvez remplacer les éléments de ce fichier de configuration avec le paramètre facultatif |
chaîne | Facultatif. Indique le nom de l'environnement. Si vous utilisez un fichier de configuration, vous pouvez remplacer les paramètres de ce fichier par |
booléen | Facultatif. Indique s'il faut ignorer les erreurs de démarrage. La valeur par défaut est |
chaîne | Facultatif. Chemin vers le agent fichier de log. Accepte également |
int ou type de paramètre de logging applicable | Facultatif. Définit le niveau de logging. L'agent utilise le module de logging de Python. Les options sont les mêmes que pour l'option |
Valeurs de retour
Aucun.
Exemples
Initialisation avec le fichier de configuration et l'environnement
Voici un exemple d'initialisation de l'agent Python avec un fichier de configuration et une chaîne d'environnement :
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production')Utilisation de toutes les valeurs de paramètres
Appel avec toutes les valeurs de paramètres :
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production', ignore_errors=False, log_file='/var/log/newrelic.log', log_level=logging.DEBUG)