> ## 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.

# Ordem de carregamento do AppSignal para Node.js

O AppSignal para Node.js pode ser configurado de algumas formas diferentes — por meio do construtor `Appsignal` ou de variáveis de ambiente.

A configuração é carregada em um processo de quatro etapas, começando com os padrões do pacote e terminando com a leitura das variáveis de ambiente. As opções de configuração podem ser combinadas sem perder configurações de outra opção.

## Ordem de carregamento

* 1. [Padrões do pacote - `default`](#1-module-defaults)
* 2. [Configurações detectadas do sistema - `system`](#2-system-detected-settings)
* 3. [Variáveis de ambiente - `env`](#3-environment-variables)
* 4. [Construtor `Appsignal` - `initial`](#4-initial-configuration-given-to-appsignal-constructor)

## 1. Padrões do módulo

O módulo AppSignal começa carregando sua configuração padrão, definindo caminhos e habilitando determinados recursos.

Os padrões do agente podem ser encontrados na [documentação de opções de configuração](/nodejs/3.x/configuration/options).

## 2. Configurações detectadas do sistema

O pacote detecta em que tipo de sistema está rodando e se configura de acordo.

Por exemplo, quando está rodando dentro de um sistema baseado em container (como Docker e Heroku), ele define a opção de configuração `runningInContainer` como `true`.

## 3. Variáveis de ambiente

O AppSignal procurará sua configuração em variáveis de ambiente. Quando encontradas, elas substituirão todas as opções de configuração definidas nas etapas anteriores.

<CodeGroup>
  ```bash Bash theme={null}
  export APPSIGNAL_APP_NAME="my custom app name"
  # start your app here
  ```
</CodeGroup>

## 4. Configuração inicial passada para o construtor `Appsignal`

Ao inicializar o objeto `Appsignal`, você pode passar a configuração inicial que deseja aplicar. Trata-se de um `object` com qualquer uma das opções descritas abaixo.

<CodeGroup>
  ```javascript Node.js theme={null}
  new Appsignal({
    active: true,
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

Esta etapa substituirá todas as opções definidas pelos padrões ou pela configuração detectada do sistema.
