Sosreport : générez et analysez des rapports de machine

From Deimos.fr / Bloc Notes Informatique
Jump to: navigation, search
SOS Report

Software version 2.2
Operating System Red Hat 6.4
Website Sosreport Website
Last Update 15/03/2013
Others CentOS 6.4

1 Introduction

Si vous avez déjà contacté le support Red Hat, vous devez savoir que l'on vous demande un sosreport systématiquement. C'est un outil très pratique pour l'équipe en charge du support car il y a des résultats de commande, des fichiers de logs, de configuration et d'autres informations souvent indispensable pour diagnostiquer un problème. Pour ma part, je l'ai installé sur CentOS et ça fonctionne très bien.

Depuis quelques temps, sosreport a également été porté pour Debian/Ubuntu, ce qui en fait un outil très intéressant au final lorsqu'on a un parc de Linux hétérogène. Il est possible d'avoir une synthèse rapide ses informations fournies via sxconsole. L'avantage de sosreport est qu'il récupère des informations essentielles et ne consomme pas beaucoup de ressources. Il est donc possible de l'exécuter en production sans faire courir le risque de ralentir quoi que ce soit (tout dépends de la prod en question évidement).

2 Installation

Pour l'installer, c'est simple, il fait parti des packages disponible sur le repository base :

Command yum
yum install sos

Si vous voulez installer sxconsole pour avoir une synthèse :

Command yum
yum install sx

3 Utilisation

3.1 sosreport

Pour l'utiliser c'est simple, sur la machine ou se trouve le problème, lancez :

Command sosreport
> sosreport --report
 
sosreport (version 2.2)
 
This utility will collect some detailed  information about the
hardware and setup of your CentOS system.
The information is collected and an archive is  packaged under
/tmp, which you can send to a support representative.
CentOS will use this information for diagnostic purposes ONLY
and it will be considered confidential information.
 
This process may take a while to complete.
No changes will be made to your system.
 
Appuyez sur Entrée pour continuer ou CTRL-C pour quitter.
 
Veuillez saisir votre premier prénom (si vous en avez plusieurs) et votre nom [localhost] :Please enter the case number that you are generating this report for [None]: 123 
Lancement des extensions. Veuillez patienter...
 
  Completed [45/45] ...      
Création d'une archive compressée...
 
Votre rapport sos a été généré et enregistré dans :
  /tmp/sosreport-localhost.123-20130315154819-d582.tar.xz 
The md5sum is: 4136a18ba7a5e7e2151203b71bc3d582
 
Veuillez envoyer ce fichier à votre représentant de support.

L'option report, permettra de générer un fichier html utilisable plus facilement pour certains. Pour les instructions à entrer :

  • localhost : mettez le nom de la machine idéalement, c'est plus facile à retrouver, surtout si vous générez des rapports pour plusieurs machines
  • Case number : c'est le numéro du ticket. Si c'est pour vos besoins personnels, vous pouvez entrer n'importe quoi
  • Et enfin dans /tmp se trouvera une archive avec toutes les informations récoltées

Vous pouvez ensuite facilement les extraire :

Command tar
tar -xaf /tmp/sosreport-localhost.123-20130315154819-d582.tar.xz

3.2 sxconsole

sxconsole va donc vous générer une synthèse depuis une archive de sysreport. Voici la syntaxe d'utilisation :

Command sxconsole
sxconsole <ticket_number> -E -d -r <sosreport_archive> -R ~/tmp/

  • ticket_number : c'est le numéro du ticket qui a été inséré lors de la création du sosreport. On peut retrouver ce numéro dans le nom de l'archive sosreport
  • -E : permet d'activer tous les modules (cluster, storage...)
  • -d : c'est le mode debug
  • -r : le sosreport d'une machine. Si vous avez plusieurs machines, vous pouvez exécuter plusieurs -r avec une machine à chaque fois
  • -R : c'est un répertoire de stockage temporaire à créer au préalable

Voici un exemple depuis la syntaxe décrite ci dessus :

Command sxconsole
sxconsole 123 -E -d -r /tmp/sosreport-localhost.123-20130315154819-d582.tar.xz -R ~/tmp/

4 References

https://github.com/sosreport/sosreport