Pular para o conteúdo principal
Esta documentação descreve como a configuração do AppSignal é carregada na sua aplicação Python. Existem dois métodos diferentes para configurar sua integração com o AppSignal, que podem ser usados simultaneamente:
  • Arquivo de configuração (__appsignal__.py)
  • Variáveis de ambiente
Uma lista das opções disponíveis pode ser encontrada na documentação de Opções de configuração.

Ordem de carregamento

A configuração é carregada em um processo de quatro etapas:
  1. Padrões do pacote - default
  2. Configurações detectadas pelo sistema - system
  3. Variáveis de ambiente - env
  4. Configuração inicial - initial

1. Padrões do pacote

Primeiro, a configuração padrão é carregada, que define caminhos e habilita determinados recursos. Essa fonte será listada como default na configuração da sua aplicação e é visível no relatório do Diagnose.

2. Configurações detectadas pelo sistema

O pacote detecta em que tipo de sistema está rodando e se configura de acordo. Por exemplo, se estiver rodando em um sistema baseado em contêiner como Docker ou Heroku, a opção de configuração running_in_container é definida como true. Essa fonte será listada como system na configuração da sua aplicação e é visível no relatório do Diagnose.

3. Variáveis de ambiente

O AppSignal procurará por opções de configuração definidas via variáveis de ambiente. O valor da variável de ambiente substituirá os valores das mesmas opções de configuração definidas em etapas anteriores.
export APPSIGNAL_APP_NAME="my custom app name"
# start your app here
Essa fonte será listada como env na configuração da sua aplicação e é visível no relatório do Diagnose.

4. Configuração inicial fornecida ao Appsignal

Por fim, a configuração inicial é carregada via a função Appsignal chamada a partir do arquivo de configuração __appsignal__.py:
# __appsignal__.py
appsignal = Appsignal(
    active=True,
    name="My app name",
    push_api_key="00000000-0000-0000-0000-000000000000"
)
Os valores das opções de configuração definidas nesta etapa substituirão os valores das mesmas opções de configuração definidas em etapas anteriores. Essa fonte será listada como initial na configuração da sua aplicação e é visível no relatório do Diagnose.