• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

application_settings (API do agente Python)

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

name

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, value

Cada name será o caminho pontilhado completo para essa configuração.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.