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

# Imagem Docker do Standalone AppSignal Agent

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](https://www.docker.com/get-started).

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 {/* id: host-metrics */}

<Warning>
  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.
</Warning>

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](/standalone-agent/installation/linux-package) diretamente na máquina host que executa seus contêineres Docker.
* **Kubernetes:** use a [integração com Kubernetes](/kubernetes/metrics) 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](/standalone-agent/installation/linux-package) dentro de cada contêiner que você quer monitorar.

## Imagem Docker

Adicione um contêiner/serviço usando a imagem Docker [appsignal/agent][image] à 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][image] 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](/standalone-agent/configuration/options).

### Docker run

<CodeGroup>
  ```sh Shell theme={null}
  # 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
  ```
</CodeGroup>

### Docker compose

<CodeGroup>
  ```yaml YAML theme={null}
  # 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
  ```
</CodeGroup>

***

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

[image]: https://hub.docker.com/r/appsignal/agent