Sintaxe
newrelic.agent.application_settings(name=None)Retorna um objeto de configurações do aplicativo.
Descrição
Isso retorna uma referência ao objeto de configurações do aplicativo. O objeto global_settings contém configurações no arquivo de configuração e variáveis de ambiente; este objeto application_settings inclui adicionalmente alterações de configuração definidas no lado do servidor por meio da interface do New Relic.
As configurações retornadas são objetos hierárquicos aninhados e os nomes das configurações correspondem aos nomes no arquivo de configuração do agente. O principal motivo para expor as configurações do aplicativo é se você deseja que sua instrumentação faça referência à configuração local específica do agente e não ao que está definido no lado do servidor.
Se o valor name não estiver definido, a chamada usará o nome do aplicativo especificado no arquivo de configuração do agente ou por meio da variável de ambiente NEW_RELIC_APP_NAME .
Se o aplicativo não tiver sido registrado no coletor de dados quando esta chamada for feita, ele retornará o valor None. Quando uma chamada é feita com sucesso e retorna valores, ela refletirá os valores de qualquer configuração local sobreposta à Configuração no lado do servidor daquela aplicação obtida durante o registro.
Importante
Não faça alterações no objeto de configurações do aplicativo. Não armazene em cache o objeto de configurações porque ele será invalidado e substituído se uma alteração na configuração do lado do servidor fizer com que o agente registre novamente o aplicativo no coletor de dados.
Parâmetro
Parâmetro | Descrição |
|---|---|
corda | Opcional. O nome do aplicativo. Se não for definido, o nome corresponderá ao nome definido na configuração do agente Python para esse aplicativo. |
Valores de retorno
Retorna um objeto de configurações do aplicativo. O objeto em si não apresenta nenhuma API pública; algumas outras chamadas exigem que ela seja aprovada.
Exemplos
Usando uma instrução IF
Você pode querer verificar as definições de configuração para determinar qual instrumentação personalizada implementar. Aqui está um exemplo de uso de uma instrução if com o objeto de configurações do aplicativo:
settings = newrelic.agent.application_settings()
if settings and settings.error_collector.enabled: ...Passando resultados para dict
Se você estiver depurando ou registrando e precisar das configurações globais como um objeto de dicionário Python tradicional, poderá passar o resultado para um dict. Por exemplo:
settings_dict = dict(newrelic.agent.application_settings())
for name, value in settings_dict.items(): print name, valueCada name será o caminho pontilhado completo para essa configuração.