Voir la source de Docker stats

<span id="explication-de-docker-stats"></span>
=== '''Explication de <code>docker stats</code>''' ===

La commande <code>docker stats</code> permet de '''surveiller en temps réel les ressources système utilisées par vos conteneurs Docker''' (CPU, RAM, réseau, disque, etc.). Elle est utile pour :<br />
- '''Diagnostiquer''' des problèmes de performance.<br />
- '''Vérifier''' l’impact des limites (<code>--memory</code>, <code>--cpus</code>, etc.).<br />
- '''Optimiser''' l’allocation des ressources.


-----

<span id="utilisation-de-base"></span>
== '''Utilisation de base''' ==

<span id="afficher-les-stats-de-tous-les-conteneurs"></span>
=== '''1. Afficher les stats de tous les conteneurs''' ===

<syntaxhighlight lang="bash">docker stats</syntaxhighlight>
'''Exemple de sortie :'''

<pre>CONTAINER ID   NAME          CPU %   MEM USAGE / LIMIT   MEM %   NET I/O       BLOCK I/O   PIDS
a1b2c3d4e5f6   my-container  0.50%   150MiB / 1GiB      15.0%   1.2MB / 0.8MB 0B / 0B     5</pre>
<span id="surveiller-des-conteneurs-spécifiques"></span>
=== '''2. Surveiller des conteneurs spécifiques''' ===

<syntaxhighlight lang="bash">docker stats NOM_CONTENEUR1 NOM_CONTENEUR2</syntaxhighlight>
Exemple :

<syntaxhighlight lang="bash">docker stats nginx mysql</syntaxhighlight>

-----

<span id="colonnes-affichées"></span>
== '''Colonnes affichées''' ==

{|
!width="18%"| Colonne
!width="81%"| Description
|-
| '''CONTAINER ID'''
| Identifiant court du conteneur.
|-
| '''NAME'''
| Nom du conteneur.
|-
| '''CPU %'''
| Pourcentage d’utilisation du CPU (par rapport aux cœurs disponibles).
|-
| '''MEM USAGE / LIMIT'''
| Mémoire utilisée / Mémoire maximale allouée (ex: <code>250MiB / 1GiB</code>).
|-
| '''MEM %'''
| Pourcentage de mémoire utilisée.
|-
| '''NET I/O'''
| Données réseau entrantes/sortantes (ex: <code>1.2MB / 0.8MB</code>).
|-
| '''BLOCK I/O'''
| Accès disque en lecture/écriture (ex: <code>10MB / 0B</code>).
|-
| '''PIDS'''
| Nombre de processus en cours dans le conteneur.
|}


-----

<span id="options-utiles"></span>
== '''Options utiles''' ==

{|
!width="18%"| Option
!width="81%"| Description
|-
| <code>--no-stream</code>
| Affiche les stats '''une seule fois''' (au lieu de les rafraîchir en continu).
|-
| <code>--format</code>
| Personnalise le format de sortie (ex: <code>--format &quot;{{.Name}}: {{.MemUsage}}&quot;</code>).
|-
| <code>--all</code> (<code>-a</code>)
| Affiche '''tous''' les conteneurs (même ceux arrêtés).
|}

<span id="exemples-avancés"></span>
=== '''Exemples avancés''' ===

<span id="afficher-uniquement-la-mémoire-et-le-cpu"></span>
==== '''1. Afficher uniquement la mémoire et le CPU''' ====

<syntaxhighlight lang="bash">docker stats --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"</syntaxhighlight>
'''Sortie :'''

<pre>NAME                CPU %               MEM USAGE / LIMIT
my-container        0.50%              150MiB / 1GiB</pre>
<span id="sauvegarder-les-stats-dans-un-fichier"></span>
==== '''2. Sauvegarder les stats dans un fichier''' ====

<syntaxhighlight lang="bash">docker stats --no-stream > stats.txt</syntaxhighlight>

-----

<span id="cas-dusage-courants"></span>
== '''Cas d’usage courants''' ==

<span id="identifier-un-conteneur-gourmand"></span>
=== '''1. Identifier un conteneur gourmand''' ===

Si un conteneur utilise '''100% CPU''' ou '''90% MEM''', vous pouvez :<br />
- '''Limiter ses ressources''' (<code>docker update --cpus 0.5</code>).<br />
- '''Le redémarrer''' (<code>docker restart</code>).

<span id="vérifier-lefficacité-des-limites"></span>
=== '''2. Vérifier l’efficacité des limites''' ===

Après avoir configuré <code>--memory=1g</code>, vérifiez avec :

<syntaxhighlight lang="bash">docker stats</syntaxhighlight>
→ Si <code>MEM USAGE / LIMIT</code> dépasse souvent la limite, ajustez-la.

<span id="comparer-limpact-avantaprès-un-déploiement"></span>
=== '''3. Comparer l’impact avant/après un déploiement''' ===

Lancez <code>docker stats</code> avant et après une mise à jour pour voir les changements de consommation.


-----

<span id="limitations"></span>
== '''Limitations''' ==

* '''Pas de historique''' : Les stats sont en direct (pour un suivi dans le temps, utilisez '''Prometheus''' ou '''cAdvisor''').<br />

* '''Précision''' : Les données sont approximatives (basées sur les cgroups Linux).


-----

<span id="alternative-docker-stats-avec-docker-compose"></span>
== '''Alternative : <code>docker stats</code> avec Docker Compose''' ==

Si vous utilisez <code>docker-compose</code>, vous pouvez surveiller tous les services d’un projet avec :

<syntaxhighlight lang="bash">docker-compose stats</syntaxhighlight>

-----

<span id="résumé"></span>
=== '''Résumé''' ===

* '''<code>docker stats</code> = Moniteur temps réel des conteneurs'''.<br />

* '''Colonnes clés : CPU %, MEM USAGE, NET I/O'''.<br />

* '''Options utiles : <code>--no-stream</code>, <code>--format</code>, <code>--all</code>'''.<br />

* '''Idéal pour debugger et optimiser les ressources'''.

Utilisez cette commande pour garder un œil sur vos conteneurs et éviter les surprises ! 🚀
[[Catégorie:Docker]]