Sintaxis
newrelic.agent.initialize(config_file=None, environment=None, ignore_errors=None, log_file=None, log_level=None)Inicializa el agente Python con un archivo de configuración especificado durante un proceso de integración manual.
Descripción
Esto se llama para inicializar el agente Python con un archivo de configuración específico cuando el agente se integra manualmente con una aplicación Python.
Para obtener mejores resultados de instrumentación, realice esta llamada lo antes posible en el código de su aplicación. A diferencia de la funcionalidad típica de Python, el orden de importación importa. Para archivos de script de aplicación y WSGI, coloque la llamada initialize antes de todas las importaciones, con la excepción de la importación sys y las actualizaciones de sys.path. Si llama a initialize varias veces, el agente ignora las llamadas después de la primera si el archivo de configuración y las opciones de entorno son las mismas. Si las opciones difieren, se plantea una excepción.
Si llama a initialize sin argumentos, ya debe haber especificado su con la variable de entorno NEW_RELIC_LICENSE_KEY . Alternativamente, puede configurar NEW_RELIC_CONFIG_FILE y NEW_RELIC_ENVIRONMENT. Luego, el agente leerá esos valores en lugar de los argumentos que faltan.
Parámetros
Parámetro | Descripción |
|---|---|
cadena | Opcional. La ruta al archivo de configuración del agente. Si proporciona un archivo de configuración, puede anular elementos de ese archivo de configuración con el parámetro opcional |
cadena | Opcional. Indica el nombre del entorno. Si está utilizando un archivo de configuración, puede anular la configuración de ese archivo con |
booleano | Opcional. Indica si se ignoran los errores de inicio. El valor predeterminado es |
cadena | Opcional. Ruta al archivo de registro del agente. También acepta |
int o tipo de parámetro de registro aplicable | Opcional. Establece el nivel de registro. El agente utiliza el módulo de registro de Python. Las opciones son las mismas que para la opción |
Valores de retorno
Ninguno.
Ejemplos
Inicializando con el archivo de configuración y el entorno
A continuación se muestra un ejemplo de cómo inicializar el agente Python con un archivo de configuración y una cadena de entorno:
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production')Usando todos los valores de parámetros
Llamando con todos los valores de parámetros:
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production', ignore_errors=False, log_file='/var/log/newrelic.log', log_level=logging.DEBUG)