{{tag>Xenial serveur réseau}}

----

====== Afficher la bande passante de votre serveur ======

Bwbar est un petit utilitaire qui mesure l'utilisation de la bande passante de votre machine et la génère, soit sous forme d'image soit sous forme de fichier texte.
Bwbar est souvent utilisé pour des serveurs web, mais peut l'être aussi pour votre machine personnelle.
Ensuite libre à vous de l'afficher dans votre signature sur les forums, sur la page d'accueil de votre blog, etc...

<note>Bwbar est fait pour fonctionner en tant que démon. Cependant on peut le faire fonctionner "manuellement" (voir chapitre "utilisation" mais ce mode de fonctionnement est peu pratique.</note>

===== Pré-requis =====

  * Disposer des [[:sudo|droits d'administration]] ;
  * Disposer d'une connexion à Internet configurée et activée ;

===== Installation =====

Il vous suffit, pour cela, d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>bwbar]]** sur la machine dont vous voulez mesurer et afficher la bande passante.

===== Configuration=====
FIXME ce qui suit n'a pas été vérifié sur les versions récentes d'Ubuntu.
Pour faire fonctionner bwbar en tant que démon, une seule chose à faire : [[:tutoriel:comment_editer_un_fichier|éditez le fichier]] « /etc/default/bwbar » avec les droits d'administration.

<file bash>
# Directory to put files into
# => Répertoire où stocker l'image ou le fichier texte
DIR=/votre/repertoire/
# Who to run as
# => L'utilisateur sous lequel tournera bwbar, doit avoir les droits d'écriture dans le répertoire spécifié ci-dessus.
RUNAS=www-data
# What are the options (eth0, scale of 1.5mbps)
# les options concernant l'interface réseau, et l'échelle
# ici, c'est un serveur dédié, l'interface réseau est eth0 et le débit max est de 100mbps
OPTIONS="eth0 100"
</file>

Dans la ligne OPTIONS, on peut spécifier d'autres paramètres de la manière suivante :
<file bash>
OPTIONS="eth0 100 --i --width=400"
</file>
pour spécifier la largeur max de l'image de 400 pixels (par défaut 600).

D'autres options utiles :
  * <nowiki>--interval=N</nowiki> : intervalle de rafraichissement en secondes
  * <nowiki>--height=N</nowiki> : hauteur en pixel de l'image, par défaut 4
  * <nowiki>--width=N</nowiki> : largeur en pixel de l'image, par défaut 600
  * <nowiki>--input</nowiki> : mesure la bande passante entrante. Par défaut, c'est l'option <nowiki>--output</nowiki> qui est utilisé pour mesurer la bande passante sortante (plus utile pour les serveurs web par exemple).
  * Les options pour l'unité de mesure :  <nowiki>--GBps</nowiki> pour GigaOctet/sec, <nowiki>--Gbps</nowiki> pour GigaBits/sec, <nowiki>--KBps</nowiki> pour KiloOctets/sec, <nowiki>--Kbps</nowiki> pour KiloBits/sec, <nowiki>--MBps</nowiki> pour MégaOctets/sec, et enfin <nowiki>--Mbps</nowiki> pour MégaBits/sec (unité utilisée par défaut).





===== Utilisation =====

== Pour lancer bwbar en tant que démon ==

Il vous suffira soit d'attendre de redémarrer la machine sur laquelle il tourne, soit de le lancer tout de suite par :
<code bash>sudo /etc/init.d/bwbar start</code>
Si le répertoire de destination spécifié dans le fichier de configuration est dans l'arborescence de votre site web par exemple, un simple lien URL vers l'image ou le fichier texte (ubar.png ou ubar.txt par défaut) suffira à l'afficher.

== Pour lancer bwbar manuellement ==


  * exemple pour créer un fichier image :

<code bash>sudo /usr/sbin/bwbar -o -x 500 -y 5 -d /var/www/ eth0 100</code>

  * exemple pour créer un fichier texte :

<code bash>sudo /usr/sbin/bwbar -o -f -m -d /var/www/ eth0 100</code>

Cependant, il vous faudra l'arrêter par la combinaison de touches CTRL+C.


===== Liens =====

  * [[http://www.kernel.org/bwbar.html|La page officielle]].

----

//Contributeurs : [[:utilisateurs:meuced]].//