Skip to main content
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 Standalone AppSignal Agent com um arquivo de configuração ou usando variáveis de ambiente, consulte nossa seção de configuração.

​
Opções disponíveis

​
app_name

​
Descrição

Nome do seu aplicativo como deve ser exibido no AppSignal.com.
Nota: Alterar o nome ou o ambiente de um aplicativo existente criará um novo aplicativo no AppSignal.com.

​
environment

​
Descrição

O ambiente do aplicativo a ser reportado para o AppSignal.
Nota: 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 em nível de organização para autenticar com nossa Push API. Leia mais sobre a chave da Push API do AppSignal.

​
bind_address

​
Descrição

Um endereço IPv4 válido que o agente do AppSignal utiliza como binding para seus servidores TCP e UDP. Use um endereço específico se você quiser que o agente escute apenas requisições feitas a 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 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

  • Configura o caminho do arquivo de certificado SSL.
Use esta opção para apontar para outro arquivo de certificado caso haja problema ao se conectar à 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á interpretado como um caminho malformado.

​
cpu_count

​
Descrição

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

​
dns_servers

​
Descrição

Configure os servidores DNS para o agente do AppSignal usar.
YAML
Se você for 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 desabilitar a coleta de métricas de host. No Heroku e no Dokku, as métricas de host são desabilitadas por padrão. Isso é feito porque esses sistemas reportarão métricas imprecisas a partir de dentro dos contêineres. A coleta de métricas de host nesses sistemas não pode ser habilitada. Para o Heroku, use o log drain do Heroku em vez disso.

​
enable_http

​
Descrição

Defina esta opção como true para habilitar o servidor HTTP OpenTelemetry. Quando habilitado, o agente do AppSignal escutará em um servidor vinculado a localhost na porta 8099. Se você estiver executando várias aplicações instrumentadas com AppSignal no mesmo servidor, esta opção de configuração só pode ser habilitada em uma delas. Isso é necessário para aplicativos que usam o exportador HTTP do OpenTelemetry para enviar dados ao AppSignal.

​
enable_nginx_metrics

​
Descrição

Defina como true para habilitar o servidor de métricas do NGINX. Veja a documentação de métricas do NGINX para detalhes. Quando habilitado, o agente do AppSignal escutará em um servidor vinculado a localhost na porta 27649. Se você estiver executando várias aplicações instrumentadas com AppSignal no mesmo servidor, esta opção de configuração só pode ser habilitada em uma delas.

​
enable_opentelemetry_http

​
Descrição

Defina esta opção como true para habilitar o servidor HTTP OpenTelemetry. Quando habilitado, o agente do AppSignal escutará em um servidor vinculado a localhost na porta 8099. Se você estiver executando várias aplicações instrumentadas com AppSignal no mesmo servidor, esta opção de configuração só pode ser habilitada em uma delas. Isso é necessário para aplicativos que usam o exportador HTTP do OpenTelemetry para enviar dados ao AppSignal.

​
enable_statsd

​
Descrição

Habilita o servidor StatsD no agente do AppSignal. Quando habilitado, o agente do AppSignal escutará em um servidor vinculado a localhost na porta 8125. Se você estiver executando várias aplicações instrumentadas com AppSignal no mesmo servidor, esta opção de configuração só pode ser habilitada em uma delas.

​
filter_parameters

​
Descrição

Lista de chaves de parâmetros que devem ser ignoradas usando a filtragem do AppSignal. Seus valores serão substituídos por [FILTERED] quando transmitidos para o AppSignal.
TOML
Leia mais sobre filtragem de parâmetros.

​
filter_session_data

​
Descrição

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

​
host_role

​
Descrição

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

​
hostname

​
Descrição

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

​
http_proxy

​
Descrição

Se você precisar que o agente se conecte à Internet por meio de um proxy, defina a URL completa do proxy nesta chave de configuração.

​
ignore_actions

​
Descrição

Com esta opção de configuração você pode especificar uma lista de ações que serão ignoradas pelo AppSignal. Tudo o que acontece, incluindo exceções, não será transmitido para o AppSignal. Isso pode ser útil para ignorar endpoints de health check ou outras ações que você não quer monitorar. Leia mais sobre ignorar ações.

​
ignore_errors

​
Descrição

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

​
ignore_namespaces

​
Descrição

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

​
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. Configurar para os níveis “debug” ou “trace” geralmente só é necessário a pedido do suporte. Definir o nível como “debug”/“trace” pode ter um leve impacto no uso de disco e IO, especialmente em sites de alto tráfego. A sobrecarga de CPU é mínima com a opção debug habilitada. Valores aceitos:
  • error
  • warning
  • info
  • debug
  • trace

​
nginx_port

​
Descrição

Configure 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árias aplicações instrumentadas com AppSignal no mesmo servidor com métricas do NGINX habilitadas, use esta opção para configurar cada aplicação 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 AppSignal. Configure esta porta se outro processo já estiver em execução na máquina utilizando essa mesma porta, para evitar conflitos.

​
push_api_endpoint

​
Descrição

Configure o endpoint para envio de dados ao AppSignal. Esta configuração não precisará ser alterada.

​
running_in_container

​
Descrição

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

​
send_environment_metadata

​
Descrição

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

​
send_params

​
Descrição

Define se o envio de parâmetros de requisição para o AppSignal deve ser ignorado. Para mais informações, leia sobre send_params na filtragem de parâmetros de requisição.

​
send_session_data

​
Descrição

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

​
statsd_port

​
Descrição

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

​
working_dir_path

​
Descrição

Sobrescreve o local onde o Agente Standalone do AppSignal pode armazenar arquivos temporários. Use esta opção se o local padrão não for adequado. Veja nossa página como o AppSignal opera para mais informações sobre a finalidade deste diretório de trabalho.
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á interpretado como um caminho malformado.