> ## 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 des Standalone AppSignal Agents

Der AppSignal Standalone Agent ist als Docker-Image verfügbar, das als Container in Docker- (Compose) und Kubernetes-Infrastrukturen ausgeführt werden kann.

Diese Anleitung setzt voraus, dass Sie Docker installiert haben oder dass es von der Hosting-Plattform der Anwendung verwendet wird. Informationen zur lokalen Installation von Docker finden Sie auf der [offiziellen Docker-Website](https://www.docker.com/get-started).

Diese Anleitung zeigt Ihnen, wie Sie das AppSignal Docker-Image für Ihre App konfigurieren, indem Sie die Optionen für Docker-Umgebungsvariablen verwenden.

## Anwendungsfälle

Das Docker-Image des Standalone Agents ist für den **Empfang von Daten aus anderen Containern** in Ihrer Infrastruktur konzipiert. Es eignet sich gut für:

* Empfang von **StatsD-Metriken** von Ihren Anwendungen (Port 8125)
* Empfang von **OpenTelemetry-Daten** von Ihren Anwendungen (Port 8099)
* Sammeln von **NGINX-Metriken** (Port 27649)

Alle diese Server sind im Docker-Image standardmäßig aktiviert.

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

<Warning>
  Das **Docker-Image des Standalone Agents meldet keine Host-Metriken**. Die
  Host-Metriken, die es melden würde, sind diejenigen des Containers selbst — in
  dem nur der Agent läuft — und sind daher nicht nützlich.
</Warning>

Wenn Sie eine Host-Metrik-Überwachung benötigen (CPU, Arbeitsspeicher, Festplatte, Netzwerk), verwenden Sie stattdessen einen der folgenden Ansätze:

* **Docker-Host-Maschine:** Installieren Sie das [Linux-Paket](/standalone-agent/installation/linux-package) direkt auf der Host-Maschine, die Ihre Docker-Container ausführt.
* **Kubernetes:** Verwenden Sie die [Kubernetes-Integration](/kubernetes/metrics), um Host-Metriken in Ihrem Cluster zu überwachen.
* **Einzelne Container:** Wenn Sie kein Kubernetes verwenden und Host-Metriken bestimmter Container überwachen müssen, installieren Sie das [Linux-Paket](/standalone-agent/installation/linux-package) in jedem Container, den Sie überwachen möchten.

## Docker-Image

Fügen Sie der Infrastruktur Ihrer Anwendung einen Container/Dienst mithilfe des Docker-Images [appsignal/agent][image] hinzu. Wenn Sie möchten, dass Apps Daten an ihn melden, wie StatsD-Metriken, OpenTelemetry-Daten und NGINX-Metriken, richten Sie sie in der Anwendung auf den Namen des Containers aus.

## Unterstützte Plattformen

Das Docker-Image unterstützt die folgenden Plattformen. Diese Liste kann auch pro Docker-Image-Tag auf der [Docker Hub-Seite][image] für dieses Image eingesehen werden.

* x86 64-Bit
* ARM 64-Bit

## Konfiguration

Der Agent kann mit Umgebungsvariablen konfiguriert werden, die im Docker-Run-Befehl, in den Docker-Compose-Optionen oder in der Kubernetes-Konfiguration angegeben werden.

Ersetzen Sie in den folgenden Beispielen `YOUR_PUSH_API_KEY` durch Ihren tatsächlichen AppSignal Push API-Schlüssel und konfigurieren Sie ihn mit den Details Ihrer Anwendung.

Eine vollständige Liste aller Konfigurationsoptionen finden Sie im [Konfigurationsabschnitt](/standalone-agent/configuration/options).

### Docker run

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

  services:
    appsignal: # Name of the container used as the hostname on which it can be reached
      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>

***

Das war's! Sobald Sie diese Schritte abgeschlossen haben, sollte das Docker-Image des AppSignal Standalone Agents laufen und, falls konfiguriert, Daten von anderen Apps empfangen.

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