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

# Configuration d'AppSignal pour Node.js

Dans cette section, nous expliquerons comment configurer AppSignal, ce qui peut être configuré dans le package Node.js, et quelle est la configuration minimale requise.

## Configuration minimale requise

La configuration minimale requise par AppSignal pour Node.js comprend les éléments suivants. S'ils ne sont pas présents, AppSignal n'enverra aucune donnée à AppSignal.com.

* Une clé d'API Push valide
* Un nom d'application
* Un environnement d'application (`development`/`production`/`test` en définissant `NODE_ENV`)
* Le paramètre `active: true`

L'intégration prend en charge le chargement de sa configuration via les options passées au constructeur `Appsignal`. Nous recommandons de créer un fichier `appsignal.cjs` pour requérir et initialiser 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>

Alternativement, vous pouvez configurer l'agent à l'aide de variables d'environnement système. AppSignal deviendra automatiquement actif si la variable d'environnement `APPSIGNAL_PUSH_API_KEY` est définie.

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

## Options de configuration

Pour en savoir plus sur toutes les options de configuration, consultez la [page des options](/nodejs/3.x/configuration/options).

## Environnements d'application

Une application peut avoir plusieurs environnements tels que « development », « test », « staging » et « production ».

Pour séparer les erreurs et les problèmes de performance qui surviennent dans l'environnement « development » de ceux qui surviennent en « production », il est possible de définir l'environnement dans lequel l'application s'exécute avec la variable d'environnement `NODE_ENV`.

Si vous activez AppSignal par environnement, vous pouvez définir la propriété `active` des options que vous passez au constructeur de manière conditionnelle :

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

Cela désactivera également AppSignal lors de l'exécution de vos tests.