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

# Image Docker de l'agent autonome AppSignal

L'agent autonome AppSignal est disponible sous forme d'image Docker pouvant être exécutée en tant que conteneur dans une infrastructure Docker (Compose) ou Kubernetes.

Ce guide suppose que Docker est installé ou qu'il est utilisé par la plateforme d'hébergement de l'application. Pour plus d'informations sur l'installation locale de Docker, consultez le [site officiel de Docker](https://www.docker.com/get-started).

Ce guide vous montre comment configurer l'image Docker AppSignal pour votre application, en utilisant les options de variables d'environnement Docker.

## Cas d'utilisation

L'image Docker de l'agent autonome est conçue pour **recevoir des données depuis d'autres conteneurs** de votre infrastructure. C'est un bon choix pour :

* Recevoir des **métriques StatsD** de vos applications (port 8125)
* Recevoir des **données OpenTelemetry** de vos applications (port 8099)
* Collecter des **métriques NGINX** (port 27649)

Tous ces serveurs sont activés par défaut sur l'image Docker.

## Métriques d'hôte {/* id: host-metrics */}

<Warning>
  L'**image Docker** de l'agent autonome **ne rapporte pas de métriques d'hôte**. Les
  métriques d'hôte qu'elle rapporterait seraient celles du conteneur lui-même — dans lequel seul
  l'agent s'exécute — et ne sont donc pas utiles.
</Warning>

Si vous avez besoin d'une surveillance des métriques d'hôte (CPU, mémoire, disque, réseau), utilisez plutôt l'une de ces approches :

* **Machine hôte Docker :** installez le [paquet Linux](/standalone-agent/installation/linux-package) directement sur la machine hôte qui exécute vos conteneurs Docker.
* **Kubernetes :** utilisez l'[intégration Kubernetes](/kubernetes/metrics) pour surveiller les métriques d'hôte dans votre cluster.
* **Conteneurs individuels :** si vous n'utilisez pas Kubernetes et avez besoin de surveiller les métriques d'hôte de conteneurs spécifiques, installez le [paquet Linux](/standalone-agent/installation/linux-package) à l'intérieur de chaque conteneur que vous souhaitez surveiller.

## Image Docker

Ajoutez un conteneur/service à l'infrastructure de votre application en utilisant l'image Docker [appsignal/agent][image]. Si vous souhaitez que des applications lui transmettent des données, comme des métriques StatsD, des données OpenTelemetry et des métriques NGINX, pointez-les vers le nom du conteneur dans l'application.

## Plateformes prises en charge

L'image Docker prend en charge les plateformes suivantes. Cette liste peut également être consultée par tag d'image Docker sur la [page Docker Hub][image] de cette image.

* x86 64-bit
* ARM 64-bit

## Configuration

L'agent peut être configuré avec des variables d'environnement spécifiées dans la commande Docker run, les options Docker compose ou la configuration Kubernetes.

Dans les exemples ci-dessous, remplacez `YOUR_PUSH_API_KEY` par votre véritable clé Push API AppSignal et configurez-le avec les détails de votre application.

Une liste complète de toutes les options de configuration est disponible dans la [section de configuration](/standalone-agent/configuration/options).

### Docker run

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

  services:
    appsignal: # Nom du conteneur utilisé comme nom d'hôte sur lequel il peut être joint
      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>

***

C'est tout ! Une fois ces étapes terminées, l'image Docker de l'agent autonome AppSignal devrait être opérationnelle et recevoir des données d'autres applications, si elle est configurée à cet effet.

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