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

# Configuração do AppSignal para Node.js

Nesta seção, vamos explicar como configurar o AppSignal, o que pode ser configurado no pacote Node.js e qual é a configuração mínima necessária.

## Configuração mínima necessária

A configuração mínima necessária pelo AppSignal para Node.js consiste nos itens a seguir. Se eles não estiverem presentes, o AppSignal não enviará nenhum dado para AppSignal.com.

* Uma Push API Key válida
* Um nome de aplicação
* Um ambiente da aplicação (`development`/`production`/`test` definindo `NODE_ENV`)
* A opção `active: true`

A integração suporta carregar sua configuração via opções passadas para o construtor `Appsignal`. Recomendamos criar um arquivo `appsignal.cjs` para fazer o require e inicializar o AppSignal.

<CodeGroup>
  ```javascript Node.js theme={null}
  // appsignal.cjs
  const { Appsignal } = require("@appsignal/nodejs");

  new Appsignal({
    active: true,
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

Como alternativa, você pode configurar o agente usando variáveis de ambiente do sistema. O AppSignal se tornará automaticamente ativo se a variável de ambiente `APPSIGNAL_PUSH_API_KEY` estiver definida.

<CodeGroup>
  ```bash Bash theme={null}
  export APPSIGNAL_PUSH_API_KEY="<YOUR API KEY>"
  export APPSIGNAL_APP_NAME="<YOUR APPLICATION NAME>"
  export APPSIGNAL_APP_ENV="production"
  ```
</CodeGroup>

## Opções de configuração

Leia sobre todas as opções de configuração na [página de opções](/nodejs/3.x/configuration/options).

## Ambientes da aplicação

Uma aplicação pode ter múltiplos ambientes, como "development", "test", "staging" e "production".

Para separar os erros e problemas de performance que ocorrem no ambiente "development" daqueles em "production", é possível definir em qual ambiente a aplicação está rodando por meio da variável de ambiente `NODE_ENV`.

Se você ativar o AppSignal por ambiente, pode definir a propriedade `active` das opções que você passa para o construtor condicionalmente:

<CodeGroup>
  ```javascript Node.js theme={null}
  // appsignal.cjs
  const { Appsignal } = require("@appsignal/nodejs");

  new Appsignal({
    active: process.env.NODE_ENV !== "development",
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

Isso também desativará o AppSignal ao executar seus testes.