SUNYDAY.NET | Utilisation de SNMP en PHP

Le module SNMP fournit avec PHP est plutôt méconnus, il permet pourtant de développer des scripts de monitoring très puissant! SNMP ( Simple Network Management Protocol ) est un protocole qui a vu le jour en 1988 ( voir la RFC 1067 puis RFC 1157 ), il est aujourd'hui très largement intégré dans tous les équipements possédant des interfaces réseaux. Service natif dans Microsoft Windows ( il n'est pas installé de base, mais présent dans les composants additionels ), il se trouve aussi pour linux sous la forme de la librairie NetSNMP. Les agents SNMP plus ou moins évolués permettent d'obtenir des statistiques comme :

Le trafic réseau.
L'utilisation des ressources ( CPU, Mémoire, Disques... )
La température des composants
Des informations particulières à l'équipement
...

L'interrogation de l'agent SNMP se fait via un code d'authentification échangé de façon clair dans SNMPv1 ou cryptée depuis la version 3.

Pour activer l'extension SNMP dans PHP, il est nécessaire de décommenter la ligne suivante de votre fichier PHP.ini :

extension=php_snmp.dll

Si vous avez ce genre de message d'erreur dans vos logs d'Apache :

Cannot find module (IP-MIB): At line 0 in (none)

..il faut copier le contenus du répertoire /mibs/ de votre distribution de PHP dans le répertoire C:/usr/mibs/ afin qu'au démarrage d'apache le module php_snmp.dll puisse charger en mémoire le contenus des MIBs. Vous pouvez également ajouter à la fin de la ligne de commande la redirection $2>NUL pour ignorer les messages d'erreurs. ( redirection de STDERR en DOS )

Ce petit exemple en PHP-CLI ( voir l'article PHP-CLI Command Line Interface ) permet d'énumérer les disques d'une machine à travers le réseau.

Ce script accepte en entrée deux paramètres, le premier correspond à l'adresse IP de la machine à interroger, le deuxième à la communauté SNMP à utiliser lors de la session. J'utilise également une fonction vers laquelle je redirige tous les messages d'erreurs ( set_error_handler("ErrorHandler"); ) cela permet d'éviter que le script bloque si la machine interrogée ne répond pas en SNMP.

set_time_limit(60);
 set_error_handler("ErrorHandler");

if ( count($argv) != 3 )
  { echo "Missing parameters <IP> <Community>\r\n"; exit(); }

$C_IP        = $argv[1];
 $C_Community = $argv[2];

$DiskInstance = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.1");

// Is there any disk?
 if ( count($DiskInstance) == 0 )
  {
   echo "No Disk found.\r\n";
   exit();
  }

// Parse each disk
 foreach ( $DiskInstance as $Key => $Value )
  {
   $DiskType    = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.2");
   $DiskLabel   = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.3");
   $DiskCluster = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.4");
   $DiskSize    = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.5");
   $DiskUsed    = snmpwalk($C_IP,$C_Community,".1.3.6.1.2.1.25.2.3.1.6");

$RealSize = $DiskSize[$Key];
   $Size = $DiskSize[$Key] * $DiskCluster[$Key];
   $Used = $DiskUsed[$Key] * $DiskCluster[$Key];

if ( $Size != 0 )
    $PercentUsed = floor((100/$Size)*$Used)."%";
   else
    $PercentUsed = "??";

$Label = Conformize($DiskLabel[$Key])." ".GetSize($Size)." (".$PercentUsed." used)";

$Kind = right($DiskType[$Key],1)."OTHER";
   if ( right($DiskType[$Key],1) == "1" ) { $Kind = "Unknown"; }
   if ( right($DiskType[$Key],1) == "2" ) { $Kind = "Physical Mem"; }
   if ( right($DiskType[$Key],1) == "3" ) { $Kind = "Virtual Mem"; }
   if ( right($DiskType[$Key],1) == "4" ) { $Kind = "Hard Drive"; }
   if ( right($DiskType[$Key],1) == "5" ) { $Kind = "Removeable"; }
   if ( right($DiskType[$Key],1) == "6" ) { $Kind = "Floppy Disk"; }
   if ( right($DiskType[$Key],1) == "7" ) { $Kind = "CD-ROM"; }
   if ( right($DiskType[$Key],1) == "8" ) { $Kind = "RAM Disk"; }
   if ( right($DiskType[$Key],1) == "8" ) { $Kind = "Flash mem"; }
   if ( right($DiskType[$Key],1) == "8" ) { $Kind = "Network Drive"; }

echo " ".chr(254)." ".$Kind.chr(9)."| ".$Label."\r\n";
  }

function GetSize($Value)
  {
   if ( left($Value,8) == "Gauge32:" )
    { $Value = right($Value,strlen($Value)-9)+0; }

$Result = $Value."o";
   if ( $Value >= 1000 ) { $Result = floor($Value/1000)."Ko"; }
   if ( $Value >= 1000000 ) { $Result = floor($Value/1000000)."Mo"; }
   if ( $Value >= 1000000000 ) { $Result = floor($Value/1000000000)."Go"; }

return($Result);
  }

function Conformize($Value)
  {
   $Value = str_replace(chr(34),"",$Value);

// Is it a windows drive?
   if ( mid($Value,2,1) == ":" )
    {
     $Drive = left($Value,1).":\\";
     $Value = $Drive." Drive";
    }

return($Value);
  }

function left($value,$NbChar)
  { return substr($value,0,$NbChar); }

function right($value,$NbChar)
  { return substr($value,strlen($value)-$NbChar,$NbChar); }

function mid($value,$Depart,$NbChar)
  { return substr($value,$Depart-1,$NbChar); }

function ErrorHandler($errno, $errstr, $errfile, $errline)
  { echo "[".$errline."] ".$errstr."\n"; exit(); }

Liens Complémentaires

PHP-CLI, Command Line interface
Enumération des process via SNMP en PHP