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

La configuration. Importante, car sans elle, le paquet AppSignal pour Elixir
ne saura pas quelle application il instrumente ni dans quel environnement.

Dans cette rubrique, nous expliquons comment configurer AppSignal, ce qui peut être configuré
dans le paquet Elixir et quelle est la configuration minimale requise.

## Configuration minimale requise

La configuration minimale requise par AppSignal pour Elixir est constituée des
éléments suivants. S'ils ne sont pas présents, AppSignal n'enverra aucune donnée à
AppSignal.com.

* Une [Push API Key](/appsignal/terminology#push-api-key) valide
* Le nom de l'application OTP
* Un nom d'application
* Un environnement d'application (`dev` / `prod` / `test`)
* L'environnement d'application doit être défini avec `active: true`

<CodeGroup>
  ```elixir Elixir theme={null}
  # Example minimal config file
  # config/config.exs
  config :appsignal, :config,
    otp_app: :appsignal_phoenix_example,
    name: "AppsignalPhoenixExample",
    push_api_key: "your-push-api-key",
    env: Mix.env,
    active: true
  ```
</CodeGroup>

Vous pouvez également 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>
  ```elixir Elixir theme={null}
  export APPSIGNAL_OTP_APP="appsignal_phoenix_example"
  export APPSIGNAL_PUSH_API_KEY="your-push-api-key"
  export APPSIGNAL_APP_NAME="AppsignalPhoenixExample"
  export APPSIGNAL_APP_ENV="prod"
  ```
</CodeGroup>

## Options de configuration

Découvrez toutes les options de configuration sur la [page des
options](/elixir/configuration/options).

## Environnements d'application

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

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

Un fichier de configuration d'environnement typique contiendrait ce qui suit.

<CodeGroup>
  ```elixir Elixir theme={null}
  # config/prod.exs
  config :appsignal, :config,
    active: true,
    env: :prod
  ```
</CodeGroup>

L'exemple de fichier de configuration ci-dessus est également celui qui est généré par
l'installeur AppSignal pour chaque environnement.

Si vous activez AppSignal par environnement, en utilisant `active: true` dans le
fichier `config/{env}.exs`, l'option `active` n'est pas requise dans le fichier
principal `config/config.exs`.

### Désactiver AppSignal pour les tests

Si vous placez toute votre configuration AppSignal dans `config/config.exs`
au lieu de `config/prod.exs` (par exemple pour avoir AppSignal activé en
développement), veillez à mettre `active: false` dans votre configuration de test,
sauf si vous voulez soumettre tous vos résultats de tests.

<CodeGroup>
  ```elixir Elixir theme={null}
  # config/test.exs
  config :appsignal, :config,
    active: false
  ```
</CodeGroup>

## Exemple de configuration

<CodeGroup>
  ```elixir Elixir theme={null}
  # config/config.exs
  config :appsignal, :config,
    otp_app: :appsignal_phoenix_example,
    name: "AppsignalPhoenixExample",
    push_api_key: "your-push-api-key",
    env: Mix.env,
  ```
</CodeGroup>

<CodeGroup>
  ```elixir Elixir theme={null}
  # config/test.exs
  config :appsignal, :config,
    active: false
  ```
</CodeGroup>