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

# Instalando o AppSignal em uma aplicação umbrella

O AppSignal funciona com aplicações umbrella, mas há algumas coisas a ter em mente. A dependência deve ser adicionada a cada aplicação aninhada dentro da umbrella, e a configuração deve ser adicionada ao arquivo de configuração principal da umbrella.

Este guia aborda os primeiros passos para instalar o AppSignal nos seus projetos umbrella em Elixir e Phoenix. Para mais informações e passos seguintes, confira o [guia principal de instalação](/elixir/installation).

## Instalação

Adicione a dependência do AppSignal a cada aplicação que for usá-la. Isso inclui todas as aplicações Phoenix e todas as aplicações de backend que se comunicam com o banco de dados.

<CodeGroup>
  ```elixir Elixir theme={null}
  defp deps do
    [
      {:appsignal, "~> 2.0"}
    ]
  end
  ```
</CodeGroup>

Em seguida, execute o instalador do AppSignal no diretório raiz da umbrella para adicionar a configuração aos arquivos de configuração da aplicação umbrella.

<CodeGroup>
  ```sh Shell theme={null}
  $ mix appsignal.install YOUR_PUSH_API_KEY
  ```
</CodeGroup>

Por padrão, cada aplicação aninhada em uma umbrella usa a configuração principal da umbrella, então as apps aninhadas devem ter acesso à configuração principal.

## Phoenix

A instalação para Phoenix em uma aplicação umbrella é em sua maior parte a mesma de
[configurar o AppSignal em uma aplicação Phoenix
"regular"](/elixir/integrations/phoenix). Uma coisa a ter em mente é
usar `use Appsignal.Phoenix` no arquivo de endpoint da sua aplicação. Se você tiver
várias aplicações Phoenix aninhadas, use o módulo em cada uma.

<Tip>
  Se você inclui `use Plug.Builder` ou qualquer outro módulo que redefine a
  função `call/2`, certifique-se de colocar a linha `use Appsignal.Phoenix` depois
  disso.
</Tip>

<CodeGroup>
  ```elixir Elixir theme={null}
  defmodule AppsignalPhoenixExampleWeb.Endpoint do
    use Phoenix.Endpoint, otp_app: :appsignal_phoenix_example
    use Appsignal.Phoenix

    # ...
  end
  ```
</CodeGroup>