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

# Instalação do Collector via pacote Linux

Esta documentação explica como instalar o AppSignal collector usando um pacote Linux no host que você quer monitorar.

Selecione o sistema operacional que seu host usa na navegação à direita para continuar.

[Avise-nos](mailto:support@appsignal.com) se você quiser executar o collector em uma distribuição que não esteja listada aqui.

## Debian

Primeiro, certifique-se de que os seguintes pacotes estejam instalados. Todos os comandos a seguir precisam de permissões de root.

<CodeGroup>
  ```bash Shell theme={null}
  sudo apt update
  sudo apt install curl gpg -y
  ```
</CodeGroup>

As seguintes releases são suportadas.

* Bookworm para Debian 12 (x86\_64 e arm64)
* Bullseye para Debian 11 (x86\_64)

Siga as instruções para a sua versão do Debian.

<Tabs>
  <Tab title="Bookworm">
    Importe a chave de assinatura GPG executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bookworm/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure a fonte do pacote executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-debian-bookworm.list
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Bullseye">
    Importe a chave de assinatura GPG executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bullseye/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure a fonte do pacote executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bullseye/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bullseye/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-debian-bullseye.list
      ```
    </CodeGroup>
  </Tab>
</Tabs>

Em seguida, atualize o apt para obter os pacotes recém-adicionados e instale o collector.

<CodeGroup>
  ```bash Shell theme={null}
  apt-get update
  apt-get install appsignal-collector
  ```
</CodeGroup>

O collector foi instalado. O próximo passo é [configurar o collector](#configuration) para que o AppSignal possa receber dados.

## Ubuntu

Primeiro, certifique-se de que os seguintes pacotes estejam instalados. Todos os comandos a seguir precisam de permissões de root.

<CodeGroup>
  ```bash Shell theme={null}
  sudo apt update
  sudo apt install curl gpg -y
  ```
</CodeGroup>

As seguintes releases são suportadas.

* Noble para Ubuntu 24.04 (x86\_64 e arm64)
* Jammy para Ubuntu 22.04 (x86\_64)

Siga as instruções para a sua versão do Ubuntu.

<Tabs>
  <Tab title="Noble">
    Importe a chave de assinatura GPG executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-noble/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure a fonte do pacote executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-ubuntu-noble.list
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Jammy">
    Importe a chave de assinatura GPG executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure a fonte do pacote executando este comando:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-ubuntu-jammy.list
      ```
    </CodeGroup>
  </Tab>
</Tabs>

Em seguida, atualize o apt para obter os pacotes recém-adicionados e instale o collector.

<CodeGroup>
  ```bash Shell theme={null}
  apt-get update
  apt-get install appsignal-collector
  ```
</CodeGroup>

O collector foi instalado. O próximo passo é [configurar o collector](#configuration) para que o AppSignal possa receber dados.

## Red Hat Enterprise Linux/CentOS

As seguintes [releases do Red Hat](https://access.redhat.com/support/policy/updates/errata/) são suportadas.

* RHEL 9 (x86\_64)

Os comandos a seguir precisam de permissões de root. Se você receber um erro de permissão, talvez precise usar `sudo`.

Configure a fonte do pacote executando este comando:

<CodeGroup>
  ```sh Shell theme={null}
  sh -c 'echo -e "[collector-rpm-9]\nname=Collector RPM 9 \nbaseurl=https://packages.buildkite.com/appsignal/collector-rpm-9/rpm_any/rpm_any/\$basearch\nenabled=1\nrepo_gpgcheck=1\ngpgcheck=0\ngpgkey=https://packages.buildkite.com/appsignal/collector-rpm-9/gpgkey\npriority=1"' > /etc/yum.repos.d/collector-rpm-9.repo
  ```
</CodeGroup>

Em seguida, instale o collector.

<CodeGroup>
  ```bash Shell theme={null}
  dnf install -y appsignal-collector
  ```
</CodeGroup>

O collector foi instalado. O próximo passo é [configurar o collector](#configuration) para que o AppSignal possa receber dados.

## Configuração

A configuração do collector pode ser encontrada em `/etc/appsignal-collector.conf`. Para uma lista de todas as opções disponíveis, consulte a página de [opções de configuração](/collector/configuration/options).

Atualize o arquivo de configuração `/etc/appsignal-collector.conf` para usar a Push API key da sua organização.
A Push API key necessária pode ser encontrada na [seção "Push & Deploy"](https://appsignal.com/redirect-to/app?to=info) de qualquer app na sua organização e no [assistente "Add app"](https://appsignal.com/redirect-to/organization?to=sites/new) da sua organização.

<CodeGroup>
  ```toml Config file theme={null}
  # /etc/appsignal-collector.conf
  push_api_key = "<YOUR PUSH API KEY>"
  ```
</CodeGroup>

Por exemplo:

<CodeGroup>
  ```toml Config file theme={null}
  # /etc/appsignal-collector.conf
  push_api_key = "0000-0000-0000-0000"
  ```
</CodeGroup>

Apenas a Push API key é necessária ao configurar o collector.
Ela autorizará os dados da sua aplicação na nossa Push API.

Depois de atualizar o arquivo de configuração, você precisa reiniciar o collector.

<CodeGroup>
  ```sh Shell theme={null}
  systemctl restart appsignal-collector
  ```
</CodeGroup>

O collector agora deve estar em execução!

## Depuração

Verifique a saída do log com o seguinte comando para ver se algum problema foi relatado.

<CodeGroup>
  ```sh Shell theme={null}
  journalctl -u appsignal-collector
  ```
</CodeGroup>