Pular para o conteúdo principal
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 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. 
apt-get install curl gnupg apt-transport-https
Em seguida, importe a chave GPG do Packagecloud. Este é um serviço que usamos para hospedar os repositórios para nós. 
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
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
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. 
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. 
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: 
[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: 
[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: 
yum -q makecache -y --disablerepo='*' --enablerepo='appsignal_agent'
E então você pode instalar o agent: 
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 do standalone agent. A Push API key necessária pode ser encontrada na seção “Push & Deploy” de qualquer app na sua organização e no assistente “Add app” 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. 
push_api_key = "<YOUR PUSH API KEY>"
app_name = "<YOUR APP NAME>"
environment = "<YOUR APP ENVIRONMENT>"
hostname = "<YOUR HOST NAME>"
Por exemplo: 
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 por padrão. Você também pode enviar mensagens 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.