Zum Hauptinhalt springen
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. 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

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.
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 direkt auf der Host-Maschine, die Ihre Docker-Container ausführt.
  • Kubernetes: Verwenden Sie die Kubernetes-Integration, 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 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 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 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.

​
Docker run

# 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

​
Docker compose

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