> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Opções de configuração do pacote Node.js 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 nosso tópico de [Configuração](/nodejs/3.x/configuration). ## Opções disponíveis * Opções obrigatórias * [`active`](#option-active) * [`environment`](#option-environment) * [`name`](#option-name) * [`pushApiKey`](#option-pushapikey) * Opções * [`additionalInstrumentations`](#option-additionalinstrumentations) * [`bindAddress`](#option-bindaddress) * [`caFilePath`](#option-cafilepath) * [`cpuCount`](#option-cpucount) * [`debug`](#option-debug) * [`disableDefaultInstrumentations`](#option-disabledefaultinstrumentations) * [`dnsServers`](#option-dnsservers) * [`enableHostMetrics`](#option-enablehostmetrics) * [`enableMinutelyProbes`](#option-enableminutelyprobes) * [`enableNginxMetrics`](#option-enablenginxmetrics) * [`enableOpentelemetryHttp`](#option-enableopentelemetryhttp) * [`enableStatsd`](#option-enablestatsd) * [`filesWorldAccessible`](#option-filesworldaccessible) * [`filterParameters`](#option-filterparameters) * [`filterSessionData`](#option-filtersessiondata) * [`hostname`](#option-hostname) * [`hostRole`](#option-hostrole) * [`httpProxy`](#option-httpproxy) * [`ignoreActions`](#option-ignoreactions) * [`ignoreErrors`](#option-ignoreerrors) * [`ignoreLogs`](#option-ignorelogs) * [`ignoreNamespaces`](#option-ignorenamespaces) * [`log`](#option-log) * [`logLevel`](#option-loglevel) * [`logPath`](#option-logpath) * [`nginxPort`](#option-nginxport) * [`opentelemetry_port`](#option-opentelemetry_port) * [`requestHeaders`](#option-requestheaders) * [`revision`](#option-revision) * [`runningInContainer`](#option-runningincontainer) * [`sendEnvironmentMetadata`](#option-sendenvironmentmetadata) * [`sendParams`](#option-sendparams) * [`sendSessionData`](#option-sendsessiondata) * [`statsdPort`](#option-statsdport) * [`workingDirectoryPath`](#option-workingdirectorypath) ## active | Campo | Valor | | ---------------------------------------- | -------------------------- | | Chave do arquivo de configuração | `active` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ACTIVE` | | Obrigatório | sim | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `false` | ### Descrição Configure o AppSignal para estar ativo ou não em um determinado ambiente. Mais comumente usado na [configuração por arquivo](/nodejs/3.x/configuration) por ambiente. ## environment | Campo | Valor | | ---------------------------------------- | ------------------------------------------------------------------- | | Chave do arquivo de configuração | `environment` | | Chave de variável de ambiente do sistema | `APPSIGNAL_APP_ENV` | | Obrigatório | sim | | Tipo | `String` | | Valor padrão | `Lido da variável de ambiente `NODE\_ENV`, padrão é "development".` | ### Descrição O ambiente da aplicação a ser reportado ao AppSignal. **Nota**: Alterar o [nome](#option-name) ou o ambiente de uma aplicação existente criará uma nova aplicação no AppSignal.com. ## name | Campo | Valor | | ---------------------------------------- | -------------------- | | Chave do arquivo de configuração | `name` | | Chave de variável de ambiente do sistema | `APPSIGNAL_APP_NAME` | | Obrigatório | sim | | Tipo | `String` | | Valor padrão | `nil` | ### Descrição Nome do seu aplicativo como ele deve ser exibido no AppSignal.com. **Nota**: Alterar o nome ou o [ambiente](#option-env) de um aplicativo existente criará um novo aplicativo no AppSignal.com. ## pushApiKey | Campo | Valor | | ---------------------------------------- | --------------------------------------------------------------------------------------- | | Chave do arquivo de configuração | `pushApiKey` | | Chave de variável de ambiente do sistema | `APPSIGNAL_PUSH_API_KEY` | | Obrigatório | sim | | Tipo | `String` | | Valor padrão | `null` (não definido por padrão) | | Disponível desde a versão | `2.2.5` | | | | ### Descrição A chave de autenticação em nível de organização para autenticar com nossa Push API. Saiba mais sobre a [chave da Push API do AppSignal](/appsignal/terminology#push-api-key). ## additionalInstrumentations | Campo | Valor | | -------------------------------- | ---------------------------- | | Chave do arquivo de configuração | `additionalInstrumentations` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | | Disponível desde a versão | `3.0.0` | ### Descrição Lista de instrumentações adicionais do OpenTelemetry para usar com o AppSignal, por meio de bibliotecas de terceiros ou suas próprias integrações. ## bindAddress | Campo | Valor | | ---------------------------------------- | ------------------------ | | Chave do arquivo de configuração | `bindAddress` | | Chave de variável de ambiente do sistema | `APPSIGNAL_BIND_ADDRESS` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `127.0.0.1` | | Disponível desde a versão | `3.0.15` | ### Descrição Um endereço IPv4 válido que o agente AppSignal usa como vínculo para seus servidores TCP e UDP. Use um endereço específico se você quiser apenas que o agente escute solicitações feitas a esse endereço. Defina essa opção como `0.0.0.0` para permitir o recebimento de solicitações de hosts usando qualquer endereço IP. Por padrão, ele só escuta solicitações feitas no mesmo host. Essa opção é aplicada a todos os servidores do agente ([StatsD](#option-enable_statsd), [OpenTelemetry](#option-enable_opentelemetry_http) e [NGINX](#option-enable_nginx_metrics)). ## caFilePath | Campo | Valor | | ---------------------------------------- | ------------------------------------------- | | Chave do arquivo de configuração | `caFilePath` | | Chave de variável de ambiente do sistema | `APPSIGNAL_CA_FILE_PATH` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | Caminho do arquivo `cacert.pem` empacotado. | ### Descrição Use essa opção para apontar para outro arquivo de certificado se houver um 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 homedir `~` para sistemas \*NIX. Isso será visto como um caminho malformado. ## cpuCount | Campo | Valor | | ---------------------------------------- | --------------------- | | Chave do arquivo de configuração | `cpuCount` | | Chave de variável de ambiente do sistema | `APPSIGNAL_CPU_COUNT` | | Obrigatório | não | | Tipo | `Float` | | Valor padrão | `undefined` | | Disponível desde a versão | `3.3.2` | ### 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 dos cgroups. O número de CPUs pode ser uma fração, por exemplo, `0.5`. ## debug | Campo | Valor | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | Chave do arquivo de configuração | `debug` | | Chave de variável de ambiente do sistema | `APPSIGNAL_DEBUG` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `false` | | Disponível desde a versão | `1.0.0` | | | | ### Descrição **Aviso**: Esta opção de configuração está obsoleta no pacote Node.js 2.2.6. Use a opção [`logLevel`](#option-loglevel) em vez disso para o pacote Node.js 2.2.6 e mais recentes. Ativa o logging de debug, isso geralmente só é necessário a pedido do suporte. Com essa opção ativada, o AppSignal registrará muito mais informações sobre as decisões tomadas durante a coleta de métricas e quando os dados são enviados aos servidores do AppSignal.com. Ativar o logging de debug 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 ativada. Esta opção define o nível de severidade do logger interno do AppSignal. Essa opção de configuração não afeta o [recurso de logging](/logging). ## disableDefaultInstrumentations | Campo | Valor | | ---------------------------------------- | -------------------------------------------- | | Chave do arquivo de configuração | `disableDefaultInstrumentations` | | Chave de variável de ambiente do sistema | `APPSIGNAL_DISABLE_DEFAULT_INSTRUMENTATIONS` | | Obrigatório | não | | Tipo | `list(String)` ou Boolean (`true` / `false`) | | Valor padrão | `false` | | Disponível desde a versão | `3.0.0` | ### Descrição Permite desabilitar a instrumentação automática das integrações padrão: * @appsignal/opentelemetry-instrumentation-bullmq * @opentelemetry/instrumentation-amqplib * @opentelemetry/instrumentation-express * @opentelemetry/instrumentation-fastify * @opentelemetry/instrumentation-graphql * @opentelemetry/instrumentation-http * @opentelemetry/instrumentation-ioredis * @opentelemetry/instrumentation-knex * @opentelemetry/instrumentation-koa * @opentelemetry/instrumentation-mongodb * @opentelemetry/instrumentation-mongoose * @opentelemetry/instrumentation-mysql2 * @opentelemetry/instrumentation-mysql * @opentelemetry/instrumentation-nestjs-core * @opentelemetry/instrumentation-pg * @opentelemetry/instrumentation-redis * @opentelemetry/instrumentation-redis-4 * @opentelemetry/instrumentation-restify * @opentelemetry/instrumentation-undici * @prisma/instrumentation Para desabilitar todas as instrumentações, defina o valor como `true`. ## dnsServers | Campo | Valor | | ---------------------------------------- | ----------------------- | | Chave do arquivo de configuração | `dnsServers` | | Chave de variável de ambiente do sistema | `APPSIGNAL_DNS_SERVERS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | ### Descrição Configure servidores DNS para o agente AppSignal usar. ```sh Shell theme={null} # No ambiente do host export APPSIGNAL_DNS_SERVERS="8.8.8.8,8.8.4.4" ``` Se você é afetado por nossos [timeouts de DNS](/support/known-issues#dns-timeouts), tente definir um servidor DNS manualmente usando essa opção que não use 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 exibirá uma mensagem no arquivo `appsignal.log`: `A problem occurred while setting DNS servers`. ## enableHostMetrics | Campo | Valor | | ---------------------------------------- | ----------------------------------- | | Chave do arquivo de configuração | `enableHostMetrics` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_HOST_METRICS` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | \`\`true` / detectado pelo sistema` | ### Descrição Defina essa opção como `false` para desabilitar a coleta de [métricas de host](/metrics/host-metrics). No Heroku e Dokku, as métricas de host estão desabilitadas por padrão. Isso é feito porque esses sistemas reportarão métricas imprecisas de dentro dos containers. A coleta de métricas de host nesses sistemas não pode ser ativada. Para Heroku, use o [Heroku log drain](/heroku/host-metrics) em vez disso. ## enableMinutelyProbes | Campo | Valor | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Chave do arquivo de configuração | `enableMinutelyProbes` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_MINUTELY_PROBES` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `0.4.0` | | | | ### Descrição Habilita o sistema de [probes a cada minuto](/nodejs/3.x/instrumentation/minutely-probes). ## enableNginxMetrics | Campo | Valor | | ---------------------------------------- | -------------------------------- | | Chave do arquivo de configuração | `enableNginxMetrics` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_NGINX_METRICS` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `false` | | Disponível desde a versão | `3.0.8` | ### 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.](/metrics/nginx) Quando habilitado, o agente 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, essa opção de configuração só pode ser habilitada em uma delas. ## enableOpentelemetryHttp | Campo | Valor | | ---------------------------------------- | ------------------------------------- | | Chave do arquivo de configuração | `enableOpentelemetryHttp` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_OPENTELEMETRY_HTTP` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `3.1.0` | ### Descrição Defina essa opção como `true` para habilitar o [servidor HTTP do OpenTelemetry](/standalone-agent/installation). Quando habilitado, o agente 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, essa opção de configuração só pode ser habilitada em uma delas. Isso é necessário para aplicações que usam o exporter HTTP do OpenTelemetry para reportar dados ao AppSignal. ## enableStatsd | Campo | Valor | | ---------------------------------------- | -------------------------- | | Chave do arquivo de configuração | `enableStatsd` | | Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_STATSD` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `false` | | Disponível desde a versão | `2.2.2` | ### Descrição Habilita o [servidor StatsD](/standalone-agent/statsd) no agente AppSignal. Quando habilitado, o agente 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, essa opção de configuração só pode ser habilitada em uma delas. ## filesWorldAccessible | Campo | Valor | | ---------------------------------------- | ---------------------------------- | | Chave do arquivo de configuração | `filesWorldAccessible` | | Chave de variável de ambiente do sistema | `APPSIGNAL_FILES_WORLD_ACCESSIBLE` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `2.2.4` | ### Descrição Se isso for definido como `true`, o [diretório de trabalho do AppSignal](/appsignal/how-appsignal-operates#working-directory) que é criado fica acessível para todos os usuários (permissões Unix `0666`). Isso é frequentemente necessário porque os processos da mesma aplicação rodam sob usuários diferentes. Defina como `false` para desabilitar esse comportamento (permissões Unix `0644`). ## filterParameters | Campo | Valor | | ---------------------------------------- | ----------------------------- | | Chave do arquivo de configuração | `filterParameters` | | Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_PARAMETERS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | | Disponível desde a versão | `2.2.5` | ### 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. Leia mais sobre [filtragem de parâmetros](/application/parameter-filtering). ## filterSessionData | Campo | Valor | | ---------------------------------------- | ------------------------------- | | Chave do arquivo de configuração | `filterSessionData` | | Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_SESSION_DATA` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | | Disponível desde a versão | `2.2.5` | ### 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. Leia mais sobre [filtragem de dados de sessão](/application/session-data-filtering). ## hostname | Campo | Valor | | ---------------------------------------- | ----------------------------- | | Chave do arquivo de configuração | `hostname` | | Chave de variável de ambiente do sistema | `APPSIGNAL_HOSTNAME` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | detectado a partir do sistema | ### Descrição Isso sobrescreve 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. ## hostRole | Campo | Valor | | ---------------------------------------- | -------------------------------- | | Chave do arquivo de configuração | `hostRole` | | Chave de variável de ambiente do sistema | `APPSIGNAL_HOST_ROLE` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `null` (não definido por padrão) | | Disponível desde a versão | `3.0.19` | ### Descrição Agrupe hosts por role (função) e gere métricas com base nesse role. Uma dessas métricas é a métrica do tipo counter `reporting_hosts`. Um bom role indica qual é o papel principal do servidor, como "webserver", "processor", "api", "database", "loadbalancer", etc. ## httpProxy | Campo | Valor | | ---------------------------------------- | -------------------------------- | | Chave do arquivo de configuração | `httpProxy` | | Chave de variável de ambiente do sistema | `APPSIGNAL_HTTP_PROXY` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `null` (não definido por padrão) | ### Descrição Se você precisar que o agente se conecte à Internet via um proxy, defina a URL completa do proxy nessa chave de configuração. ## ignoreActions | Campo | Valor | | ---------------------------------------- | -------------------------- | | Chave do arquivo de configuração | `ignoreActions` | | Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_ACTIONS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | ### Descrição Com essa opção de configuração você pode especificar uma lista de actions 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 health check ou outras actions que você não quer monitorar. Leia mais sobre [como ignorar actions](/guides/filter-data/ignore-actions). ## ignoreErrors | Campo | Valor | | ---------------------------------------- | ------------------------- | | Chave do arquivo de configuração | `ignoreErrors` | | Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_ERRORS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | ### Descrição Lista de classes de erro que serão ignoradas. Qualquer exceção levantada com essa classe de erro não será transmitida ao AppSignal. Leia mais sobre [como ignorar erros](/guides/filter-data/ignore-errors). ## ignoreLogs | Campo | Valor | | ---------------------------------------- | ----------------------- | | Chave do arquivo de configuração | `ignoreLogs` | | Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_LOGS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | | Disponível desde a versão | `3.4.0` | ### 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 de sintaxe regex é suportado, leia mais sobre isso em nosso guia [Ignore Logs](/guides/filter-data/ignore-logs). ## ignoreNamespaces | Campo | Valor | | ---------------------------------------- | ----------------------------- | | Chave do arquivo de configuração | `ignoreNamespaces` | | Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_NAMESPACES` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `[]` | ### Descrição Lista de namespaces que serão ignorados. Qualquer erro gerado ou requisição lenta que ocorrer nesse namespace não será enviado ao AppSignal. Saiba mais sobre [namespaces](/application/namespaces). ## log | Campo | Valor | | ---------------------------------------- | --------------- | | Chave do arquivo de configuração | `log` | | Chave de variável de ambiente do sistema | `APPSIGNAL_LOG` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `file` | ### Descrição Esta opção configura qual logger a funcionalidade de logging interna do AppSignal usará e não afeta o [recurso de logging](/logging). **Nota**: O [agente do AppSignal](/appsignal/how-appsignal-operates), que é usado 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](https://heroku.com)) * 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 contêineres e Heroku. ## logLevel | Campo | Valor | | ---------------------------------------- | --------------------- | | Chave do arquivo de configuração | `logLevel` | | Chave de variável de ambiente do sistema | `APPSIGNAL_LOG_LEVEL` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `info` | | Disponível desde a versão | `2.2.6` | ### Descrição Esta opção define o nível de severidade do logger interno do AppSignal e não afeta o [recurso de logging](/logging). Define o nível de severidade do logger interno do AppSignal. Se configurado como "info", ele registrará todas as mensagens de erro, aviso e informação, mas não as mensagens de debug. Definir 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 ## logPath | Campo | Valor | | ---------------------------------------- | -------------------- | | Chave do arquivo de configuração | `logPath` | | Chave de variável de ambiente do sistema | `APPSIGNAL_LOG_PATH` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `/tmp` | ### Descrição Esta opção configura a localização do arquivo de log interno do AppSignal e não afeta o [recurso de logging](/logging).
**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. Substitua a localização do caminho (diretório) onde o arquivo `appsignal.log` pode ser escrito. ## nginxPort | Campo | Valor | | ---------------------------------------- | ---------------------- | | Chave do arquivo de configuração | `nginxPort` | | Chave de variável de ambiente do sistema | `APPSIGNAL_NGINX_PORT` | | Obrigatório | não | | Tipo | `Integer` | | Valor padrão | `27649` | | Disponível desde a versão | `3.6.7` | ### 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 com 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 | Campo | Valor | | ---------------------------------------- | ------------------------------ | | Chave do arquivo de configuração | `opentelemetry_port` | | Chave de variável de ambiente do sistema | `APPSIGNAL_OPENTELEMETRY_PORT` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `8099` | | Disponível desde a versão | `3.1.0` | ### Descrição Defina esta opção para configurar a porta do servidor HTTP OpenTelemetry do processo do agente 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. ## requestHeaders | Campo | Valor | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Chave do arquivo de configuração | `requestHeaders` | | Chave de variável de ambiente do sistema | `APPSIGNAL_REQUEST_HEADERS` | | Obrigatório | não | | Tipo | `list(String)` | | Valor padrão | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "range"]` | | Disponível desde a versão | `2.2.5` | ### Descrição A opção de configuração `requestHeaders` contém uma lista de cabeçalhos de requisição HTTP que são lidos e armazenados pelo pacote AppSignal para Node.js. Esta opção de configuração `requestHeaders` é uma *allowlist*, o que significa que ela só aceitará cabeçalhos conforme especificado por esta opção de configuração. Se esta opção de configuração não for definida, o padrão do AppSignal será usado. A lista a seguir é o padrão do pacote AppSignal. ```javascript Node.js theme={null} client = Appsignal.new( // ...Other config opts requestHeaders: [ "accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "range" ] ) ``` Para configurar o AppSignal para não armazenar nenhum cabeçalho de requisição HTTP em transações do AppSignal, configure a opção com uma lista vazia. ```javascript Node.js theme={null} client = Appsignal.new( // ...Other config opts requestHeaders: [] ) ``` ## revision | Campo | Valor | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | Chave do arquivo de configuração | `revision` | | Chave de variável de ambiente do sistema | `APP_REVISION` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | `null` (não definido por padrão) | | Disponível desde a versão | `1.0.0` | | | | ### Descrição Define 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 esse valor mudar e marcará todos os dados recebidos com a revisão atual. Quando seu aplicativo é implantado usando Kamal, ou quando é implantado no Render, ou quando é implantado no Heroku e o recurso [Heroku Labs: Dyno Metadata](https://devcenter.heroku.com/articles/dyno-metadata) está habilitado, a integração do AppSignal detectará automaticamente o commit do Git do deploy atual e o usará como revisão. Você pode sobrescrever as revisões detectadas automaticamente no Heroku, Render ou Kamal definindo manualmente a opção de configuração `revision` com um valor personalizado. Saiba mais sobre marcadores de deploy no [tópico de marcadores de deploy](/application/markers/deploy-markers). ## runningInContainer | Campo | Valor | | ---------------------------------------- | -------------------------------- | | Chave do arquivo de configuração | `runningInContainer` | | Chave de variável de ambiente do sistema | `APPSIGNAL_RUNNING_IN_CONTAINER` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | detectado pelo agente | ### Descrição O AppSignal espera estar em execução na mesma máquina entre diferentes deploys. Defina esta chave como `true` se o aplicativo estiver em execução em um contêiner, como com Docker. Versões mais recentes da integração do AppSignal detectam automaticamente seu ambiente de contêiner, portanto, nenhuma configuração manual é necessária. Se você tiver problemas com a detecção automática, por favor [entre em contato com o suporte](mailto:support@appsignal.com). Esta opção é definida automaticamente como `true` no [Heroku](http://heroku.com/). ## sendEnvironmentMetadata | Campo | Valor | | ---------------------------------------- | ------------------------------------- | | Chave do arquivo de configuração | `sendEnvironmentMetadata` | | Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_ENVIRONMENT_METADATA` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `2.2.6` | ### Descrição Enviar metadados de ambiente sobre o aplicativo. Para mais informações, leia sobre [metadados de ambiente](/application/environment-metadata). ## sendParams | Campo | Valor | | ---------------------------------------- | -------------------------- | | Chave do arquivo de configuração | `sendParams` | | Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_PARAMS` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `2.2.8` | ### Descrição Define se deve pular o envio de parâmetros de requisição ao AppSignal. Para mais informações, leia sobre [send\_params](/application/parameter-filtering) em filtragem de parâmetros de requisição. ## sendSessionData | Campo | Valor | | ---------------------------------------- | ----------------------------- | | Chave do arquivo de configuração | `sendSessionData` | | Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_SESSION_DATA` | | Obrigatório | não | | Tipo | Boolean (`true` / `false`) | | Valor padrão | `true` | | Disponível desde a versão | `2.2.9` | ### Descrição Defina esta opção como `false` para não enviar nenhum dado de sessão com traces de exceções e amostras de problemas de desempenho. Para mais informações, leia sobre [filtragem de dados de sessão de requisição](/application/session-data-filtering). ## statsdPort | Campo | Valor | | ---------------------------------------- | ----------------------- | | Chave do arquivo de configuração | `statsdPort` | | Chave de variável de ambiente do sistema | `APPSIGNAL_STATSD_PORT` | | Obrigatório | não | | Tipo | `Integer` | | Valor padrão | `8125` | | Disponível desde a versão | `3.0.16` | ### 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 e também estiver usando esta porta para evitar conflitos. ## workingDirectoryPath | Campo | Valor | | ---------------------------------------- | ---------------------------------- | | Chave do arquivo de configuração | `workingDirectoryPath` | | Chave de variável de ambiente do sistema | `APPSIGNAL_WORKING_DIRECTORY_PATH` | | Obrigatório | não | | Tipo | `String` | | Valor padrão | detectado pelo agente | | Disponível desde a versão | `1.0.0` | ### Descrição Substitui o local onde o AppSignal para Node.js 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](/appsignal/how-appsignal-operates) para mais informações sobre o propósito deste 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 uma com a outra. Para mais informações sobre esse cenário, consulte nossa documentação sobre [execução de múltiplos aplicativos em um host](/guides/application/multiple-applications-on-one-host). ```javascript Node.js theme={null} // Example: appsignal.js const { Appsignal } = require("@appsignal/nodejs"); const appsignal = new Appsignal({ // Other config workingDirectoryPath: "/tmp/project_1" }); ``` **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.