Naar hoofdinhoud gaan
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. 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

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.
Als u host-metrieken wilt monitoren (CPU, geheugen, schijf, netwerk), gebruik dan een van de volgende benaderingen:
  • Docker-hostmachine: installeer het Linux-pakket rechtstreeks op de hostmachine waarop uw Docker-containers draaien.
  • Kubernetes: gebruik de Kubernetes-integratie 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 in elke container die u wilt monitoren.

​
Docker-image

Voeg een container/service toe met de Docker-image appsignal/agent 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 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.

​
Docker run

# 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

​
Docker compose

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