> ## 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 Standalone AppSignal Agent via pacote Linux
Esta documentação descreve como instalar o AppSignal standalone agent por meio de um pacote Linux no host que você quer monitorar, como um banco de dados ou um host sem um app instrumentado em execução.
Estamos no processo de testar e empacotar o standalone agent nas distribuições Linux mais populares entre nossos clientes. [Avise-nos](mailto:support@appsignal.com) se quiser executar o agent em uma distribuição que ainda não é suportada.
## Sistema operacional
### Debian e Ubuntu
O agent foi testado no Ubuntu LTS 14.04/16.04/18.04/20.04/22.04/24.04 e Debian 8/9/10/11/12.
Primeiro, certifique-se de que os seguintes pacotes estejam instalados. Todos os comandos a seguir precisam de permissões de root; talvez você precise usar `sudo`.
```bash Bash theme={null}
apt-get install curl gnupg apt-transport-https
```
Em seguida, importe a chave GPG do [Packagecloud](https://packagecloud.io). Este é um serviço que usamos para hospedar os repositórios para nós.
```bash Bash theme={null}
curl -L https://packagecloud.io/appsignal/agent/gpgkey | sudo apt-key add -
```
Crie um arquivo chamado `/etc/apt/sources.list.d/appsignal_agent.list` que contenha a configuração de repositório abaixo para o SO que você usa.
#### Ubuntu
Substitua `lunar` no arquivo de configuração `appsignal_agent.list` abaixo pelo nome da sua release do Ubuntu. Use os seguintes nomes de release:
* `noble` para Ubuntu 24.04
* `jammy` para Ubuntu 22.04
* `focal` para Ubuntu 20.04
* `bionic` para Ubuntu 18.04
* `xenial` para Ubuntu 16.04
* `trusty` para Ubuntu 14.04
```conf /etc/apt/sources.list.d/appsignal_agent.list theme={null}
deb https://packagecloud.io/appsignal/agent/ubuntu/ lunar main
deb-src https://packagecloud.io/appsignal/agent/ubuntu/ lunar main
```
#### Debian
Substitua `bookworm` no arquivo de configuração `appsignal_agent.list` abaixo pelo nome da sua release do Debian. Use os seguintes nomes de release:
* `bookworm` para Debian 12
* `bullseye` para Debian 11
* `buster` para Debian 10
* `stretch` para Debian 9
* `jessie` para Debian 8
```conf /etc/apt/sources.list.d/appsignal_agent.list theme={null}
deb https://packagecloud.io/appsignal/agent/debian/ bookworm main
deb-src https://packagecloud.io/appsignal/agent/debian/ bookworm main
```
#### Instale o agent
Em seguida, execute `apt update` para obter os pacotes recém-adicionados e instale o agent.
```bash Bash theme={null}
apt-get update
apt-get install appsignal-agent
```
O agent foi instalado. O próximo passo é configurá-lo para reportar para o app correto no AppSignal.
### Redhat Enterprise Linux/Centos
No momento, as versões 7 e 8 do EL são suportadas. Primeiro, certifique-se de que os seguintes pacotes estejam instalados. Todos os comandos a seguir precisam de permissões de root; talvez você precise usar `sudo`.
```bash Bash theme={null}
yum install pygpgme yum-utils
```
Crie um arquivo chamado `/etc/yum.repos.d/appsignal_agent.repo` que contenha a configuração de repositório abaixo para EL7:
```conf /etc/yum.repos.d/appsignal_agent.repo theme={null}
[appsignal_agent]
name=appsignal_agent
baseurl=https://packagecloud.io/appsignal/agent/el/7/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/appsignal/agent/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
```
Ou esta configuração para EL8:
```conf /etc/yum.repos.d/appsignal_agent.repo theme={null}
[appsignal_agent]
name=appsignal_agent
baseurl=https://packagecloud.io/appsignal/agent/el/8/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/appsignal/agent/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
```
Atualize seu cache local do yum executando:
```bash Bash theme={null}
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
```
E então você pode instalar o agent:
```bash Bash theme={null}
yum install appsignal-agent
```
## Configuração
A configuração do standalone agent pode ser encontrada em `/etc/appsignal-agent.conf`. Para uma lista de todas as opções disponíveis, consulte a página de [opções de configuração](/standalone-agent/configuration/options) do standalone agent.
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.
Ao configurar o standalone agent, escolha um nome de app e ambiente que funcione para você. Pode ser um app separado ou você pode configurá-lo para um app existente para que ele reporte como um novo host nesse app.
```conf /etc/appsignal-agent.conf theme={null}
push_api_key = ""
app_name = ""
environment = ""
hostname = ""
```
Por exemplo:
```conf /etc/appsignal-agent.conf theme={null}
push_api_key = "0000-0000-0000-000"
app_name = "My app name"
environment = "production"
hostname = "hostname"
```
Depois de editar o arquivo de configuração, você precisa reiniciar o agent.
* No Ubuntu 14.04, use `service appsignal-agent restart`
* No Centos/Redhat e Ubuntu 16.04 ou superior, use `systemctl restart appsignal-agent`
## Métricas coletadas
O agent coleta [métricas de host](/metrics/host-metrics) por padrão. Você também pode enviar mensagens [StatsD](/standalone-agent/statsd) para ele, que serão processadas como métricas customizadas.
Estamos ansiosos por feedback sobre isso. Avise-nos pelo chat no app ou em [support@appsignal.com](mailto:support@appsignal.com).