Sintaxe
newrelic.agent.initialize(config_file=None, environment=None, ignore_errors=None, log_file=None, log_level=None)Inicializa o agente Python com um arquivo de configuração especificado durante um processo de integração manual.
Descrição
Isso é chamado para inicializar o agente Python com um arquivo de configuração especificado quando o agente está sendo integrado manualmente a um aplicativo Python.
Para obter melhores resultados de instrumentação, faça essa chamada o mais cedo possível no código do seu aplicativo. Ao contrário da funcionalidade típica do Python, a ordem de importação é importante. Para arquivos WSGI e de script de aplicativo, faça a chamada initialize antes de todas as importações, com exceção da importação sys e das atualizações para sys.path. Se você chamar initialize diversas vezes, o agente ignorará as chamadas após a primeira se o arquivo de configuração e as opções de ambiente forem iguais. Se as opções forem diferentes, uma exceção será levantada.
Se você chamar initialize sem argumentos, você já deverá ter especificado seu com a variável de ambiente NEW_RELIC_LICENSE_KEY . Alternativamente, você pode definir NEW_RELIC_CONFIG_FILE e NEW_RELIC_ENVIRONMENT. O agente então lerá esses valores no lugar dos argumentos ausentes.
Parâmetro
Parâmetro | Descrição |
|---|---|
corda | Opcional. O caminho para o arquivo de configuração do agente. Se você fornecer um arquivo de configuração, poderá substituir elementos desse arquivo de configuração pelo parâmetro |
corda | Opcional. Indica o nome do ambiente. Se estiver usando um arquivo de configuração, você poderá substituir as configurações desse arquivo por |
boleano | Opcional. Indica se os erros de inicialização devem ser ignorados. O padrão é |
corda | Opcional. Caminho para o arquivo de log do agente. Também aceita |
int ou tipo de parâmetro de registro aplicável | Opcional. Define o nível de logging. O agente usa o módulo de registro do Python. As opções são as mesmas da opção |
Valores de retorno
Nenhum.
Exemplos
Inicializando com arquivo de configuração e ambiente
Aqui está um exemplo de inicialização do agente Python com um arquivo de configuração e uma string de ambiente:
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production')Usando todos os valores dos parâmetros
Chamando com todos os valores dos parâmetros:
newrelic.agent.initialize('/etc/newrelic/newrelic.ini', 'production', ignore_errors=False, log_file='/var/log/newrelic.log', log_level=logging.DEBUG)