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

Configuração. Importante, porque sem ela o pacote AppSignal Elixir não saberá
qual aplicação está instrumentando ou em qual ambiente.

Neste tópico, explicaremos como configurar o AppSignal, o que pode ser configurado
no pacote Elixir e qual é a configuração mínima necessária.

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

A configuração mínima necessária pelo AppSignal for Elixir é a
seguinte. Se ela não estiver presente, o AppSignal não enviará nenhum dado para o
AppSignal.com.

* Uma [Push API Key](/appsignal/terminology#push-api-key) válida
* O nome do OTP app da aplicação
* Um nome de aplicação
* Um ambiente de aplicação (`dev` / `prod` / `test`)
* O ambiente da aplicação definido como `active: true`

<CodeGroup>
  ```elixir Elixir theme={null}
  # Exemplo de arquivo de configuração mínimo
  # 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>

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

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

## Opções de configuração

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

## Ambientes da aplicação

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

Para separar os erros e problemas de desempenho que ocorrem no ambiente
"development" daqueles em "production", é possível definir o ambiente em
que a aplicação está rodando com a opção de configuração `env`.

Um arquivo de configuração de ambiente típico conteria o seguinte.

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

O exemplo de arquivo de configuração acima também é o que é gerado pelo instalador
do AppSignal por ambiente.

Se você ativar o AppSignal por ambiente, usando `active: true` no
arquivo `config/{env}.exs`, a opção `active` não é necessária no arquivo
`config/config.exs` principal.

### Desabilitar o AppSignal para testes

Se você colocar toda a sua configuração do AppSignal no `config/config.exs`
em vez de `config/prod.exs` (por exemplo, para ter o AppSignal habilitado durante
o desenvolvimento), certifique-se de colocar `active: false` na sua configuração de
testes, a menos que você queira enviar todos os resultados dos seus testes.

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

## Exemplo de configuração

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