Opções de configuração do Collector

O collector pode ser configurado na inicialização usando variáveis de ambiente ou um arquivo de configuração. 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 Collector com um arquivo de configuração ou usando variáveis de ambiente, consulte nossa seção de configuração.

​

Opções disponíveis

• Opções obrigatórias
  • push_api_key
• Opções
  • cpu_count
  • enable_host_metrics
  • files_world_accessible
  • hostname
  • http_port
  • log_level
  • push_api_endpoint
  • running_in_container
  • working_directory_path

​

push_api_key

​

Descrição

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

​

cpu_count

​

Descrição

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

​

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 são desabilitadas por padrão. Isso é feito porque esses sistemas reportam métricas imprecisas a partir dos containers. A coleta de métricas do host nesses sistemas não pode ser habilitada. Para o Heroku, use o Heroku log drain.

​

files_world_accessible

​

Descrição

Se esta opção for definida como true, o diretório de trabalho do AppSignal criado fica acessível para todos os usuários (permissões Unix 0666). Isso geralmente é 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).

​

hostname

​

Descrição

Isto 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_port

​

Descrição

A porta usada pelo servidor HTTP do coletor para receber requisições de exportação do OpenTelemetry.

​

log_level

​

Descrição

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 as mensagens de debug. Definir como “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 de debug habilitada. Valores aceitos:

• error
• warning
• info
• debug
• trace

​

push_api_endpoint

​

Descrição

Configura o endpoint para enviar dados ao AppSignal. Esta configuração não precisa ser alterada.

​

running_in_container

​

Descrição

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

​

working_directory_path

​

Descrição

Substitui o local onde o AppSignal Collector 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 o propósito desse diretório de trabalho. Se você estiver executando várias aplicações 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 executando várias aplicações em um host.