Pular para o conteúdo principal
A lista a seguir inclui todas as opções de configuração com o nome da variável de ambiente e o nome da chave no arquivo de configuração. Para mais informações sobre como configurar o AppSignal com um arquivo de configuração ou variáveis de ambiente do sistema, consulte nossa documentação de Configuração.

Opções disponíveis

active

Descrição

Configura se o AppSignal está ativo ou não para um determinado ambiente. Se o AppSignal não estiver ativo, nenhum dado é reportado para o aplicativo no ambiente especificado.

environment

Descrição

O ambiente do aplicativo que será reportado ao AppSignal.
Observação: alterar o nome ou o ambiente de um aplicativo existente criará um novo aplicativo no AppSignal.com.

name

Descrição

Nome do seu aplicativo como deve ser exibido no AppSignal.com.
Observação: alterar o nome ou o ambiente de um aplicativo existente criará um novo aplicativo no AppSignal.com.

push_api_key

Descrição

A chave de autenticação no nível da organização para autenticar-se com a nossa Push API. Leia mais sobre a chave Push API do AppSignal.

bind_address

Descrição

Um endereço IPv4 válido que o agente do AppSignal usa como vínculo para seus servidores TCP e UDP. Use um endereço específico se quiser que o agente escute apenas as requisições feitas para esse endereço. Defina esta opção como 0.0.0.0 para permitir o recebimento de requisições de hosts usando qualquer endereço IP. Por padrão, ele escuta apenas as requisições feitas no mesmo host. Esta opção é aplicada a todos os servidores do agente (StatsD, OpenTelemetry e NGINX).

ca_file_path

Descrição

Use esta opção para apontar para outro arquivo de certificado se houver um problema ao conectar-se à nossa API.
Nota: O caminho especificado não pode conter abstrações de sistema de arquivos específicas do sistema operacional, como o símbolo de diretório home ~ para sistemas *NIX. Isso será visto como um caminho malformado.
Ao usar um coletor externo, esta opção de configuração não tem efeito sobre como a integração se comunica com o coletor externo. Ela ainda será usada na comunicação com os servidores da AppSignal.

collector_endpoint

Descrição

O endereço de um AppSignal Collector implantado externamente. Quando definido, a integração envia seus traces, métricas e logs para o collector nesse endereço. O agente do AppSignal incluído na integração continua em execução ao lado do collector. Ele reporta os dados que não são enviados ao collector: métricas de host, métricas do NGINX, métricas do StatsD e metadados de ambiente.
Esta é uma opção de configuração experimental. O Logging está disponível apenas ao usar um collector externo.

cpu_count

Descrição

A capacidade de CPU disponível do host, em número de CPUs. Isso é usado para calcular a porcentagem de uso de CPU nas métricas do host. Se não for definido, o agente tentará detectar isso automaticamente a partir do cgroups. O número de CPUs pode ser uma fração, por exemplo, 0.5.

disable_default_instrumentations

Descrição

Permite que você desative a instrumentação automática das integrações padrão:
  • aiopg
  • asyncpg
  • celery
  • django
  • flask
  • mysql
  • mysqlclient
  • psycopg
  • psycopg2
  • pymysql
  • redis
  • jinja2
  • requests
  • sqlalchemy
  • sqlite3
  • logging
Ao usar o AppSignal para Python 1.5.4 ou anterior, prefixe cada um desses nomes com opentelemetry.instrumentation.. Por exemplo, jinja2 seria especificado como opentelemetry.instrumentation.jinja2.
Observe que as instrumentações só são habilitadas se a biblioteca de instrumentação correspondente do OpenTelemetry estiver instalada. Para desativar todas as instrumentações automáticas, defina o valor como True.

dns_servers

Descrição

Configura os servidores DNS que o agente do AppSignal deve usar.
Shell
Se você é afetado pelos nossos timeouts de DNS, tente definir um servidor DNS manualmente usando esta opção que não utilize mais de 4 pontos no nome do servidor.
  • Valores aceitáveis: 8.8.8.8, my.custom.local.server.
  • Valores não aceitáveis: foo, my.awesome.custom.local.dns.server.
Se o servidor DNS não puder ser alcançado, o agente recorrerá à configuração de DNS do host e gerará uma mensagem no arquivo appsignal.log: A problem occurred while setting DNS servers.

enable_host_metrics

Descrição

Defina esta opção como false para desativar a coleta de métricas do host. No Heroku e no Dokku, as métricas do host estão desativadas por padrão. Isso é feito porque esses sistemas relatam métricas imprecisas a partir dos containers. A coleta de métricas de host nesses sistemas não pode ser habilitada. Para o Heroku, utilize o Heroku log drain.

enable_minutely_probes

Descrição

Habilita o sistema de probes minutados.

enable_nginx_metrics

Descrição

Defina como true para habilitar o servidor de métricas do NGINX. Consulte a documentação de métricas do NGINX para mais detalhes. Quando habilitado, o agente do AppSignal escutará um servidor vinculado a localhost na porta 27649. Se você estiver executando vários aplicativos instrumentados pelo AppSignal no mesmo servidor, essa opção de configuração só pode ser habilitada em um deles.

enable_statsd

Descrição

Habilita o servidor StatsD no agente do AppSignal. Quando habilitado, o agente do AppSignal escutará um servidor vinculado a localhost na porta 8125. Se você estiver executando vários aplicativos instrumentados pelo AppSignal no mesmo servidor, essa opção de configuração só pode ser habilitada em um deles.

endpoint

Descrição

Configura o endpoint para o qual os dados serão enviados ao AppSignal. Essa configuração não precisará ser alterada.

files_world_accessible

Descrição

Se isso for definido como true, o diretório de trabalho do AppSignal criado fica acessível a todos os usuários (permissões Unix 0666). Isso é frequentemente necessário porque processos do mesmo aplicativo são executados sob usuários diferentes. Defina como false para desativar esse comportamento (permissões Unix 0644).

filter_attributes

Descrição

Lista de atributos de span do OpenTelemetry que serão filtrados pelo AppSignal. Os valores correspondentes são substituídos por [FILTERED]. Leia mais sobre a filtragem de parâmetros.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração filter_parameters para filtrar dados ao usar o agente.

filter_function_parameters

Descrição

Lista de atributos de parâmetros de função que serão filtrados pelo AppSignal. Os valores correspondentes são substituídos por [FILTERED]. Leia mais sobre a filtragem de parâmetros.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração filter_parameters para filtrar dados ao usar o agente.

filter_parameters

Descrição

Lista de chaves de parâmetros que devem ser ignoradas pela filtragem do AppSignal. Seus valores serão substituídos por [FILTERED] quando transmitidos ao AppSignal. Leia mais sobre a filtragem de parâmetros.
Apenas para o agente: ao usar um coletor externo, esta opção de configuração define o valor padrão das opções abaixo e não tem outro efeito.Use as seguintes opções de configuração para controlar como o payload da requisição, os parâmetros de query da requisição e os parâmetros de função são filtrados:

filter_request_payload

Descrição

Lista de atributos de payload de requisição para filtrar com o AppSignal. Os valores correspondentes são substituídos por [FILTERED]. Leia mais sobre filtragem de parâmetros.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração filter_parameters para filtrar dados ao usar o agente.

filter_request_query_parameters

Descrição

Lista de atributos de parâmetros de query da requisição a serem filtrados pelo AppSignal. Os valores correspondentes são substituídos por [FILTERED]. Leia mais sobre filtragem de parâmetros.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração filter_parameters para filtrar dados ao usar o agente.

filter_session_data

Descrição

Lista de chaves de dados de sessão que devem ser ignoradas pela filtragem do AppSignal. Seus valores serão substituídos por [FILTERED] quando transmitidos ao AppSignal. Leia mais sobre a filtragem de dados de sessão.

host_role

Descrição

Agrupa hosts por função e gera métricas com base nessa função. Uma dessas métricas é a métrica de contador reporting_hosts. Uma boa função indica qual é o papel principal do servidor, como “webserver”, “processor”, “api”, “database”, “loadbalancer”, etc.

hostname

Descrição

Isso substitui o hostname do servidor. Útil quando você não consegue definir um hostname personalizado ou quando um id pouco descritivo é gerado para você em serviços de hospedagem.

http_proxy

Descrição

Se você precisa que o agente se conecte à Internet via proxy, defina a URL completa do proxy nesta chave de configuração.
Ao usar um coletor externo, esta opção de configuração não tem efeito sobre como a integração se comunica com o coletor externo. Ela ainda será usada na comunicação com os servidores da AppSignal.

ignore_actions

Descrição

Com essa opção de configuração, você pode especificar uma lista de ações que serão ignoradas pelo AppSignal. Tudo o que acontecer, incluindo exceções, não será transmitido ao AppSignal. Isso pode ser útil para ignorar endpoints de verificação de saúde ou outras ações que você não deseja monitorar. Leia mais sobre ignorar ações.

ignore_errors

Descrição

Lista de classes de erro que serão ignoradas. Qualquer exceção lançada com essa classe de erro não será transmitida ao AppSignal. Leia mais sobre ignorar erros.

ignore_logs

Descrição

Lista de mensagens de log que serão ignoradas. Qualquer mensagem de log que contenha algum dos elementos da lista não será transmitida ao AppSignal. Um pequeno subconjunto da sintaxe de regex é suportado. Leia mais sobre isso em nosso guia Ignore Logs.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.

ignore_namespaces

Descrição

Lista de namespaces que serão ignorados. Qualquer erro lançado ou requisição lenta que ocorra nesse namespace não será enviado ao AppSignal. Leia mais sobre namespaces.

log

Descrição

Esta opção configura qual logger a funcionalidade de logging interna do AppSignal utilizará e não afeta o recurso de logging.Observação: o agente do AppSignal, que é utilizado pela integração, sempre escreverá no arquivo “appsignal.log”.
Selecione qual logger a integração do AppSignal usará. Os valores aceitos são file e stdout. Veja também a configuração log_path.
  • file (padrão)
    • Escreve todos os logs do AppSignal no sistema de arquivos.
  • stdout (padrão no Heroku)
    • Imprime os logs do AppSignal no STDOUT do processo pai, em vez de em um arquivo. Útil com soluções de hospedagem como sistemas de containers e Heroku.
Ao usar um coletor externo, esta opção de configuração não tem efeito sobre como o coletor emitirá logs. A integração ainda seguirá esta opção de configuração ao emitir logs.

log_level

Descrição

Esta opção define o nível de severidade do logger interno do AppSignal e não afeta o recurso de logging.
Define o nível de severidade do logger interno do AppSignal. Se estiver configurado como “info”, ele registrará todas as mensagens de erro, aviso e info, mas não registrará as mensagens de debug. Definir os níveis como “debug” ou “trace” normalmente só é necessário a pedido do suporte. Definir o nível como “debug”/“trace” pode ter um leve impacto no uso do disco e no IO, especialmente em sites de alto tráfego. A sobrecarga de CPU é mínima com a opção debug ativada. Valores aceitos:
  • error
  • warning
  • info
  • debug
  • trace
Ao usar um coletor externo, esta opção de configuração não tem efeito sobre como o coletor emitirá logs. A integração ainda seguirá esta opção de configuração ao emitir logs.

log_path

Descrição

Esta opção configura a localização do arquivo de logging interno do AppSignal e não afeta o recurso de logging.
Observação: o caminho especificado não pode conter abstrações do sistema de arquivos específicas do sistema operacional, como o símbolo de diretório home ~ para sistemas *NIX. Isso será visto como um caminho mal formado.
Substitua a localização do caminho (diretório) onde o arquivo appsignal.log pode ser gravado.
Ao usar um coletor externo, esta opção de configuração não tem efeito sobre como o coletor emitirá logs. A integração ainda seguirá esta opção de configuração ao emitir logs.

logging_endpoint

Descrição

Configure o endpoint para o qual o AppSignal envia logs e check-ins. Essa configuração não precisará ser alterada.

nginx_port

Descrição

Configura a porta na qual o servidor de métricas do NGINX é exposto. Quando o AppSignal recebe métricas do NGINX, ele escuta em um servidor vinculado a localhost, por padrão na porta 27649. Se você estiver executando vários aplicativos instrumentados pelo AppSignal no mesmo servidor com métricas do NGINX habilitadas, use esta opção para configurar cada aplicativo para escutar em uma porta diferente.

opentelemetry_port

Descrição

Defina esta opção para configurar a porta do servidor HTTP do OpenTelemetry do processo do agente do AppSignal. Configure esta porta se outro processo já estiver em execução na máquina e também estiver usando esta porta, para evitar conflitos.
Apenas agente: ao usar um coletor externo, esta opção de configuração não tem nenhum efeito. A porta a ser usada para enviar dados do OpenTelemetry ao coletor externo pode ser especificada como parte da opção de configuração collector_endpoint.

request_headers

Descrição

A opção de configuração request_headers contém uma lista de cabeçalhos HTTP da requisição que são lidos e armazenados pelo pacote AppSignal para Python. Essa opção de configuração request_headers é uma allowlist, o que significa que ela só reportará os cabeçalhos especificados nesta opção de configuração. Se essa opção de configuração não estiver configurada, será usado o padrão do AppSignal. Defini-la como None não reporta nenhum cabeçalho de requisição, o mesmo que defini-la como uma lista vazia. Isso acontece porque o AppSignal só registra um cabeçalho se esta opção o nomear. Para personalizar esta lista, adicione a opção de configuração com todos os cabeçalhos que você deseja reportar. Todos os nomes de cabeçalhos devem ser escritos em letras minúsculas. Se o nome do cabeçalho for X-Custom-Header, adicione-o a esta lista como x-custom-header. Leia nosso guia sobre coleta de cabeçalhos de requisição para mais informações. Para configurar o AppSignal para não armazenar nenhum cabeçalho HTTP de requisição nos traces do AppSignal, configure a opção com uma lista vazia.
Python

response_headers

Descrição

A opção de configuração response_headers contém uma lista de cabeçalhos HTTP de resposta que são lidos e armazenados pelo pacote AppSignal para Python. Essa opção de configuração response_headers é uma allowlist, o que significa que ela só reportará os cabeçalhos especificados nesta opção de configuração. Por padrão, nenhum cabeçalho é definido, portanto nenhum cabeçalho de resposta é reportado até que um seja adicionado. Para personalizar esta lista, adicione a opção de configuração com todos os cabeçalhos que você deseja reportar. Todos os nomes de cabeçalhos devem ser escritos em letras minúsculas. Se o nome do cabeçalho for X-Custom-Header, adicione-o a esta lista como x-custom-header.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.

revision

Descrição

Defina a revisão do aplicativo para reportar a versão atualmente em execução do seu aplicativo. O AppSignal criará um marcador de deploy quando este valor mudar e marcará todos os dados recebidos com a revisão atual. A integração do AppSignal detecta automaticamente o commit do Git implantado e o usa como revisão quando você faz deploy usando as seguintes ferramentas ou provedores: Defina a opção de configuração revision para substituir a revisão detectada. Use um único valor sem espaços, como um SHA de commit do Git (abc0123) ou um número de versão (1.2.3). O AppSignal cria links para o seu código-fonte a partir desse valor. Saiba mais em Escolhendo um valor de revisão. Leia mais sobre marcadores de deploy no tópico de marcadores de deploy. Quando mais de uma fonte define a revisão, a gem Ruby usa a primeira desta lista que estiver definida:
  1. A opção de configuração revision ou a variável de ambiente APP_REVISION.
  2. A variável de ambiente definida pelo Heroku (HEROKU_BUILD_COMMIT ou HEROKU_SLUG_COMMIT), Render (RENDER_GIT_COMMIT), Kamal (KAMAL_VERSION) ou Scalingo (CONTAINER_VERSION), nessa ordem.
  3. O arquivo REVISION no diretório raiz da aplicação.

running_in_container

Descrição

O AppSignal espera estar sendo executado na mesma máquina entre deploys diferentes. Defina esta chave como true se o aplicativo estiver sendo executado em um container, como com o Docker. Versões mais recentes da integração do AppSignal detectam automaticamente seu ambiente de container, portanto, nenhuma configuração manual é necessária. Se estiver tendo problemas com a detecção automática, entre em contato com o suporte. Esta opção é definida como true automaticamente no Heroku.

send_environment_metadata

Descrição

Envia metadados do ambiente sobre o aplicativo. Para mais informações, leia sobre metadados de ambiente.

send_function_parameters

Descrição

Se deve enviar parâmetros de função ao AppSignal.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração send_params para enviar dados quando não estiver usando o agente.

send_params

Descrição

Se deve pular o envio de parâmetros da requisição ao AppSignal. Para mais informações, leia sobre send_params na filtragem de parâmetros de requisição.
Apenas para o agente: ao usar um coletor externo, esta opção de configuração define o padrão para as opções abaixo e não tem nenhum outro efeito.Defina as seguintes opções de configuração para controlar se os payloads da requisição, os parâmetros de query da requisição e os parâmetros de função são enviados:

send_request_payload

Descrição

Se deve enviar o payload da requisição ao AppSignal.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração send_params para enviar dados quando não estiver usando o agente.

send_request_query_parameters

Descrição

Define se deve enviar os parâmetros de query da requisição para o AppSignal.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.Consulte a opção de configuração send_params para enviar dados quando não estiver usando o agente.

send_session_data

Descrição

Defina esta opção como false para não enviar nenhum dado de sessão com traces de exceção e de desempenho. Para mais informações, leia sobre filtragem de dados de sessão da requisição.

service_name

Descrição

O nome do serviço ajuda o AppSignal a reconhecer diferentes serviços para os traces e agrupa os traces automaticamente em um namespace com base no nome do serviço. Escolha um nome que se adeque ao seu aplicativo, como web-server, background-worker, email-service ou authentication-service.
Apenas para o coletor: esta opção de configuração só terá efeito ao usar um coletor externo.

statsd_port

Descrição

Defina esta opção para configurar a porta do servidor HTTP do StatsD do processo do agente do AppSignal. Configure esta porta se outro processo já estiver em execução na máquina e também estiver usando esta porta, para evitar conflitos.

working_directory_path

Descrição

Substitui a localização onde o AppSignal para Python pode armazenar arquivos temporários. Use esta opção se a localização padrão não for adequada. Consulte nossa página como o AppSignal opera para mais informações sobre o propósito desse diretório de trabalho. Se você estiver executando vários aplicativos usando o AppSignal no mesmo servidor, use esta opção de configuração para selecionar diretórios de trabalho diferentes para cada instância do AppSignal; caso contrário, as duas instâncias podem entrar em conflito. Para mais informações sobre esse cenário, consulte nossa documentação de executando vários aplicativos em um único host.
Python
Observação: o caminho especificado não pode conter abstrações do sistema de arquivos específicas do sistema operacional, como o símbolo de diretório home ~ para sistemas *NIX. Isso será visto como um caminho mal formado.