application_settings (API del agente Python)

Sintaxis

newrelic.agent.application_settings(name=None)

Devuelve un objeto de configuración de la aplicación.

Descripción

Esto devuelve una referencia al objeto de configuración de la aplicación. El objeto global_settings contiene configuraciones en el archivo de configuración y variables de entorno; Este objeto application_settings incluye además cambios de configuración establecidos en el lado del servidor a través de la UI de New Relic.

Las configuraciones devueltas son objetos jerárquicos anidados y los nombres de las configuraciones coinciden con los nombres en el archivo de configuración del agente. La razón principal para exponer la configuración de la aplicación es si desea que su instrumentación haga referencia a la configuración local específica del agente y no a lo que está configurado en el lado del servidor.

Si no se establece el valor name , la llamada utiliza el nombre de la aplicación especificado en el archivo de configuración del agente o mediante la variable de entorno NEW_RELIC_APP_NAME .

Si la aplicación no se ha registrado con el recolector de datos cuando se realiza esta llamada, devuelve el valor None. Cuando una llamada se realiza correctamente y devuelve valores, reflejará los valores de cualquier configuración local superpuestos con la configuración del lado del servidor para esa aplicación obtenida durante el registro.

Parámetros

Valores de retorno

Devuelve un objeto de configuración de la aplicación. El objeto en sí no presenta ninguna API pública; algunas otras convocatorias requieren que se apruebe.

Ejemplos

Usando una declaración IF

Es posible que desee comprobar los ajustes de configuración para determinar qué instrumentación personalizada implementar. A continuación se muestra un ejemplo del uso de una declaración if con el objeto de configuración de la aplicación:

settings = newrelic.agent.application_settings()

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

Pasar resultados a dict

Si está depurando o iniciando sesión y requiere la configuración global como un objeto de diccionario tradicional de Python, puede pasar el resultado a un dict. Por ejemplo:

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

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

Cada name será la ruta de puntos completa para esa configuración.