Pular para o conteúdo principal
O AppSignal standalone agent está disponível como uma imagem Docker que pode ser executada como um contêiner em infraestruturas Docker (Compose) e Kubernetes. Este guia presume que você tem o Docker instalado ou que ele é usado pela plataforma de hospedagem da aplicação. Para informações sobre como instalar o Docker localmente, consulte o site oficial do Docker. Este guia mostra como configurar a imagem Docker do AppSignal para o seu app, usando as opções de variáveis de ambiente do Docker.

​
Casos de uso

A imagem Docker do standalone agent foi projetada para receber dados de outros contêineres em sua infraestrutura. É uma boa escolha para:
  • Receber métricas StatsD das suas aplicações (porta 8125)
  • Receber dados OpenTelemetry das suas aplicações (porta 8099)
  • Coletar métricas NGINX (porta 27649)
Todos esses servidores são habilitados por padrão na imagem Docker.

​
Métricas de host

A imagem Docker do standalone agent não reporta métricas de host. As métricas de host que ela reportaria seriam as do próprio contêiner — no qual somente o agent está rodando — e, portanto, não são úteis.
Se você precisa de monitoramento de métricas de host (CPU, memória, disco, rede), use uma das seguintes abordagens:
  • Máquina host Docker: instale o pacote Linux diretamente na máquina host que executa seus contêineres Docker.
  • Kubernetes: use a integração com Kubernetes para monitorar métricas de host em todo o seu cluster.
  • Contêineres individuais: se você não está usando Kubernetes e precisa monitorar métricas de host de contêineres específicos, instale o pacote Linux dentro de cada contêiner que você quer monitorar.

​
Imagem Docker

Adicione um contêiner/serviço usando a imagem Docker appsignal/agent à infraestrutura da sua aplicação. Se você quer que algum app reporte dados para ele, como métricas StatsD, dados OpenTelemetry e métricas NGINX, aponte-os para o nome do contêiner na aplicação.

​
Plataformas suportadas

A imagem Docker suporta as seguintes plataformas. Esta lista também pode ser visualizada por tag da imagem Docker na página do Docker Hub dessa imagem.
  • x86 64-bit
  • ARM 64-bit

​
Configuração

O agent pode ser configurado com variáveis de ambiente especificadas no comando Docker run, nas opções do Docker compose ou na configuração do Kubernetes. Nos exemplos abaixo, substitua YOUR_PUSH_API_KEY pela sua Push API key real do AppSignal e configure-a com os detalhes da sua aplicação. Uma lista completa de todas as opções de configuração pode ser encontrada na seção de configuração.

​
Docker run

# Exemplo com Docker run
docker run \
  --env APPSIGNAL_PUSH_API_KEY=YOUR_PUSH_API_KEY \
  --env APPSIGNAL_APP_NAME=database-name \
  --env APPSIGNAL_APP_ENV=production \
  --publish "8125:8125" \
  --publish "27649:27649" \
  --publish "8099:8099" \
  appsignal/agent

​
Docker compose

# Exemplo de docker-compose.yml
version: "3"

services:
  appsignal: # Nome do contêiner usado como hostname pelo qual ele pode ser acessado
    image: appsignal/agent
    environment:
      - APPSIGNAL_PUSH_API_KEY=YOUR_PUSH_API_KEY
      - APPSIGNAL_APP_NAME=database-name
      - APPSIGNAL_APP_ENV=production
    ports:
      - "8125:8125" # StatsD
      - "27649:27649" # NGINX
      - "8099:8099" # OpenTelemetry
É isso! Depois de concluir essas etapas, você deve ter a imagem Docker do AppSignal standalone agent em execução e recebendo dados de outros apps, se configurado.