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

# Docker-image van de Standalone AppSignal Agent

De AppSignal standalone agent is beschikbaar als Docker-image die als container kan worden uitgevoerd in een Docker (Compose)- en Kubernetes-infrastructuur.

Deze handleiding gaat ervan uit dat u Docker hebt geïnstalleerd of dat het hostingplatform van de applicatie het gebruikt. Voor informatie over het lokaal installeren van Docker, zie [de officiële website van Docker](https://www.docker.com/get-started).

In deze handleiding wordt uitgelegd hoe u de AppSignal Docker-image configureert voor uw app, met behulp van de opties voor Docker-omgevingsvariabelen.

## Use cases

De Docker-image van de standalone agent is ontworpen voor het **ontvangen van gegevens uit andere containers** in uw infrastructuur. Het is een goede keuze voor:

* Het ontvangen van **StatsD-metrieken** van uw applicaties (poort 8125)
* Het ontvangen van **OpenTelemetry-gegevens** van uw applicaties (poort 8099)
* Het verzamelen van **NGINX-metrieken** (poort 27649)

Al deze servers zijn standaard ingeschakeld op de Docker-image.

## Host-metrieken {/* id: host-metrics */}

<Warning>
  De **Docker-image van de standalone agent rapporteert geen host-metrieken**. De
  host-metrieken die hij zou rapporteren, zijn die van de container zelf — waarin
  alleen de agent draait — en zijn daarom niet nuttig.
</Warning>

Als u host-metrieken wilt monitoren (CPU, geheugen, schijf, netwerk), gebruik dan een van de volgende benaderingen:

* **Docker-hostmachine:** installeer het [Linux-pakket](/standalone-agent/installation/linux-package) rechtstreeks op de hostmachine waarop uw Docker-containers draaien.
* **Kubernetes:** gebruik de [Kubernetes-integratie](/kubernetes/metrics) om host-metrieken in uw cluster te monitoren.
* **Individuele containers:** als u geen Kubernetes gebruikt en host-metrieken van specifieke containers wilt monitoren, installeer dan het [Linux-pakket](/standalone-agent/installation/linux-package) in elke container die u wilt monitoren.

## Docker-image

Voeg een container/service toe met de Docker-image [appsignal/agent][image] aan de infrastructuur van uw applicatie. Als u wilt dat apps er gegevens aan rapporteren, zoals StatsD-metrieken, OpenTelemetry-gegevens en NGINX-metrieken, verwijs ze dan in de applicatie naar de naam van de container.

## Ondersteunde platforms

De Docker-image ondersteunt de volgende platforms. Deze lijst kunt u ook per Docker-image-tag bekijken op de [Docker Hub-pagina][image] voor deze image.

* x86 64-bit
* ARM 64-bit

## Configuratie

De agent kan worden geconfigureerd met omgevingsvariabelen die zijn opgegeven in het Docker run-commando, de Docker compose-opties of de Kubernetes-configuratie.

In de onderstaande voorbeelden vervangt u `YOUR_PUSH_API_KEY` door uw daadwerkelijke AppSignal Push API-sleutel en configureert u deze met uw applicatiegegevens.

Een volledige lijst met alle configuratieopties vindt u in de [configuratiesectie](/standalone-agent/configuration/options).

### Docker run

<CodeGroup>
  ```sh Shell theme={null}
  # Voorbeeld van 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}
  # voorbeeld van docker-compose.yml
  version: "3"

  services:
    appsignal: # Naam van de container die als hostname wordt gebruikt waarop deze bereikbaar is
      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>

***

Dat was het! Zodra u deze stappen hebt voltooid, zou de Docker-image van de AppSignal standalone agent moeten draaien en gegevens van andere apps moeten ontvangen, indien geconfigureerd.

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