HYPHApar S33D
Documentation › Intégrations

Équipements réseau en SNMP

Un agent interroge les équipements de son réseau et les publie comme des hôtes à part entière. Les secrets SNMP ne quittent jamais l'agent.

Déclarer un équipement

Dans la configuration d'un agent qui joint l'équipement, de préférence un fichier conf.d/20-snmp.yaml (droits 600) :

snmp:
  enabled: true
  interval: 60s
  devices:
    # SNMP v2c
    - {name: switch-baie-1, address: 192.0.2.10, version: 2c, community: lecture, tags: {role: switch}}
    # SNMP v3, authentification et chiffrement
    - name: nas-sauvegardes
      address: 192.0.2.20
      version: 3
      user: hypha
      level: authPriv
      auth_protocol: sha        # md5, sha, sha224, sha256, sha384, sha512
      auth_key: "…"             # 8 caractères au moins
      priv_protocol: aes        # des, aes, aes192, aes256, aes192c, aes256c
      priv_key: "…"
      profile: auto

Autres réglages par équipement : port (161), timeout (5 s), retries, context, interfaces_exclude (motifs), interface_down.

Conseils :

Profils

profile: auto lit sysObjectID et choisit le profil :

ProfilCe qu'il ajoute
genericMIB-II, IF-MIB, HOST-RESOURCES-MIB : interfaces, processeur, mémoire, stockage
mikrotikprocesseur, températures, ventilateurs, alimentations de RouterOS
synologyétat des disques, des volumes et du RAID
ASUSTOR (détecté)températures, ventilateurs, état et température des disques, état et occupation des volumes ; contrôles snmp.disk.health et snmp.volume.health
printerétat de l'imprimante et consommables
upsUPS-MIB : charge de la batterie, autonomie, charge de sortie

Mesures et contrôles

MesureUnité
snmp.ifBandwidthIn, .ifBandwidthOutoctets par seconde
snmp.ifBandwidthInUsage, .OutUsagepourcentage du débit de l'interface
snmp.ifInErrors, .ifOutErrors, .ifInDiscards, .ifOutDiscardspaquets par seconde
snmp.ifOperStatus, snmp.ifAdminStatusétat
snmp.cpu.usage, snmp.memory.usage, snmp.storage.usagepourcentage
snmp.temperature, snmp.fan.speed, snmp.psu.statusdegrés, tours par minute, état
snmp.ups.battery.charge, .runtime, .loadpourcentage, secondes
snmp.sysUpTimeInstance, snmp.poll.durationsecondes, millisecondes

Contrôles :

Traps

snmp:
  traps: {enabled: true, listen: "0.0.0.0:162", community: lecture}

Chaque trap v1 ou v2c reçu devient un événement (source:snmp type:snmp_trap), 60 par minute au plus. Un moniteur de type « événement » peut alerter dessus.

Dans l'interface

Modèles du catalogue (famille Réseau) : interface réseau en panne, équipement injoignable.

Mise à jour : 19 novembre 2026