Compare commits
	
		
			1 Commits
		
	
	
		
			multithrea
			...
			4e2dec2441
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 
						
						
							
						
						4e2dec2441
	
				 | 
					
					
						
							
								
								
									
										58
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										58
									
								
								README.md
									
									
									
									
									
								
							@@ -263,63 +263,7 @@ ping 192.168.10.202
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Support multi-équipements
 | 
					## Support multi-équipements
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Le script supporte nativement la surveillance simultanée de plusieurs équipements grâce à une architecture **multi-threading** :
 | 
					**Note** : Le support complet multi-équipements nécessite une implémentation avec threading/multiprocessing. Actuellement, le script traite le premier équipement de la liste et affiche un avertissement pour les autres.
 | 
				
			||||||
 | 
					 | 
				
			||||||
### Fonctionnement
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- **Thread indépendant** pour chaque équipement configuré
 | 
					 | 
				
			||||||
- **Surveillance parallèle** : tous les équipements sont surveillés simultanément
 | 
					 | 
				
			||||||
- **Isolation des erreurs** : la défaillance d'un équipement n'affecte pas les autres
 | 
					 | 
				
			||||||
- **Clients MQTT séparés** : chaque thread utilise son propre client MQTT
 | 
					 | 
				
			||||||
- **Arrêt gracieux** : tous les threads s'arrêtent proprement sur signal
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Avantages
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- ⚡ **Performance optimale** : pas de blocage entre équipements
 | 
					 | 
				
			||||||
- 🔄 **Traitement parallèle** : requêtes SNMP simultanées
 | 
					 | 
				
			||||||
- 🛡️ **Robustesse** : isolation des défaillances
 | 
					 | 
				
			||||||
- 📊 **Scalabilité** : facilement extensible à des dizaines d'équipements
 | 
					 | 
				
			||||||
- 🔧 **Maintenance** : logs clairement identifiés par équipement
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Configuration multi-équipements
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
devices:
 | 
					 | 
				
			||||||
  routeur_principal:
 | 
					 | 
				
			||||||
    ip: "192.168.10.1"
 | 
					 | 
				
			||||||
    snmp_community: "public"
 | 
					 | 
				
			||||||
    oids:
 | 
					 | 
				
			||||||
      # ... configuration OID ...
 | 
					 | 
				
			||||||
  
 | 
					 | 
				
			||||||
  switch_bureau:
 | 
					 | 
				
			||||||
    ip: "192.168.10.5"
 | 
					 | 
				
			||||||
    snmp_community: "public" 
 | 
					 | 
				
			||||||
    oids:
 | 
					 | 
				
			||||||
      # ... configuration OID ...
 | 
					 | 
				
			||||||
  
 | 
					 | 
				
			||||||
  point_acces_wifi:
 | 
					 | 
				
			||||||
    ip: "192.168.10.10"
 | 
					 | 
				
			||||||
    snmp_community: "private"
 | 
					 | 
				
			||||||
    oids:
 | 
					 | 
				
			||||||
      # ... configuration OID ...
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Logs multi-threading
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
Chaque thread est clairement identifié dans les logs :
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
(INFO) [Device-routeur_principal] Starting monitoring thread
 | 
					 | 
				
			||||||
(INFO) [Device-switch_bureau] MQTT client connected
 | 
					 | 
				
			||||||
(DEBUG) [Device-point_acces_wifi] Published state to SNMP/point_acces_wifi/state
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Gestion des ressources
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- **Clients MQTT uniques** : ID client basé sur le nom de l'équipement
 | 
					 | 
				
			||||||
- **Topics séparés** : chaque équipement a ses propres topics MQTT
 | 
					 | 
				
			||||||
- **Discovery HA indépendante** : configuration Home Assistant par équipement
 | 
					 | 
				
			||||||
- **Disponibilité individuelle** : statut online/offline par équipement
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Logs et debugging
 | 
					## Logs et debugging
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										151
									
								
								snmp2mqtt.py
									
									
									
									
									
								
							
							
						
						
									
										151
									
								
								snmp2mqtt.py
									
									
									
									
									
								
							@@ -51,40 +51,56 @@ class DeviceMonitorThread(threading.Thread):
 | 
				
			|||||||
        logging.info(f"Starting monitoring thread for device: {self.device_name} ({self.device_config['ip']})")
 | 
					        logging.info(f"Starting monitoring thread for device: {self.device_name} ({self.device_config['ip']})")
 | 
				
			||||||
        
 | 
					        
 | 
				
			||||||
        try:
 | 
					        try:
 | 
				
			||||||
            # Setup MQTT connection and Home Assistant config
 | 
					            # Setup MQTT connection
 | 
				
			||||||
            ha_config = ha_create_config(self.req)
 | 
					 | 
				
			||||||
            client = connect_mqtt(self.mqtt_config)
 | 
					            client = connect_mqtt(self.mqtt_config)
 | 
				
			||||||
            client.loop_start()
 | 
					            client.loop_start()
 | 
				
			||||||
            
 | 
					            
 | 
				
			||||||
            config_topic = f"homeassistant/device/{ha_config['dev']['ids']}/config"
 | 
					            state_topic = f"SNMP/{self.device_name}/state"
 | 
				
			||||||
            state_topic = ha_config['state_topic']
 | 
					            availability_topic = f"SNMP/{self.device_name}/availability"
 | 
				
			||||||
            
 | 
					            
 | 
				
			||||||
            logging.info(f"[{self.device_name}] MQTT client connected, starting monitoring loop")
 | 
					            logging.info(f"[{self.device_name}] MQTT client connected")
 | 
				
			||||||
            
 | 
					            
 | 
				
			||||||
 | 
					            # Publish Home Assistant autodiscovery configuration (only once on startup)
 | 
				
			||||||
 | 
					            publish_ha_autodiscovery_config(client, self.req)
 | 
				
			||||||
 | 
					            
 | 
				
			||||||
 | 
					            # Mark device as available
 | 
				
			||||||
 | 
					            publish(availability_topic, client, "online", True, 1)
 | 
				
			||||||
 | 
					            
 | 
				
			||||||
 | 
					            logging.info(f"[{self.device_name}] Starting monitoring loop")
 | 
				
			||||||
 | 
					            
 | 
				
			||||||
 | 
					            # Main monitoring loop
 | 
				
			||||||
            while not shutdown_event.is_set():
 | 
					            while not shutdown_event.is_set():
 | 
				
			||||||
                try:
 | 
					                try:
 | 
				
			||||||
                    # Publish Home Assistant configuration
 | 
					 | 
				
			||||||
                    publish(config_topic, client, ha_config, True, 0)
 | 
					 | 
				
			||||||
                    logging.debug(f"[{self.device_name}] Published config to {config_topic}")
 | 
					 | 
				
			||||||
                    
 | 
					 | 
				
			||||||
                    # Get SNMP data and publish state
 | 
					                    # Get SNMP data and publish state
 | 
				
			||||||
                    state = asyncio.run(get_snmp(self.req))
 | 
					                    state = asyncio.run(get_snmp(self.req))
 | 
				
			||||||
                    publish(state_topic, client, state, False, 0)
 | 
					                    publish(state_topic, client, state, False, 0)
 | 
				
			||||||
                    logging.debug(f"[{self.device_name}] Published state to {state_topic}: {json.dumps(state)}")
 | 
					                    logging.debug(f"[{self.device_name}] Published state to {state_topic}: {json.dumps(state)}")
 | 
				
			||||||
                    
 | 
					                    
 | 
				
			||||||
 | 
					                    # Update availability (heartbeat)
 | 
				
			||||||
 | 
					                    publish(availability_topic, client, "online", False, 1)
 | 
				
			||||||
 | 
					                    
 | 
				
			||||||
                except Exception as e:
 | 
					                except Exception as e:
 | 
				
			||||||
                    logging.error(f"[{self.device_name}] Error in monitoring loop: {e}")
 | 
					                    logging.error(f"[{self.device_name}] Error in monitoring loop: {e}")
 | 
				
			||||||
 | 
					                    # Mark as offline on error
 | 
				
			||||||
 | 
					                    publish(availability_topic, client, "offline", False, 1)
 | 
				
			||||||
                
 | 
					                
 | 
				
			||||||
                # Wait for next iteration or shutdown signal
 | 
					                # Wait for next iteration or shutdown signal
 | 
				
			||||||
                shutdown_event.wait(timeout=self.sleep_interval)
 | 
					                shutdown_event.wait(timeout=self.sleep_interval)
 | 
				
			||||||
            
 | 
					            
 | 
				
			||||||
            # Cleanup
 | 
					            # Cleanup - mark device as offline
 | 
				
			||||||
 | 
					            publish(availability_topic, client, "offline", True, 1)
 | 
				
			||||||
            client.loop_stop()
 | 
					            client.loop_stop()
 | 
				
			||||||
            client.disconnect()
 | 
					            client.disconnect()
 | 
				
			||||||
            logging.info(f"[{self.device_name}] Monitoring thread stopped gracefully")
 | 
					            logging.info(f"[{self.device_name}] Monitoring thread stopped gracefully")
 | 
				
			||||||
            
 | 
					            
 | 
				
			||||||
        except Exception as e:
 | 
					        except Exception as e:
 | 
				
			||||||
            logging.error(f"[{self.device_name}] Fatal error in monitoring thread: {e}")
 | 
					            logging.error(f"[{self.device_name}] Fatal error in monitoring thread: {e}")
 | 
				
			||||||
 | 
					            # Try to mark as offline on fatal error
 | 
				
			||||||
 | 
					            try:
 | 
				
			||||||
 | 
					                publish(availability_topic, client, "offline", True, 1)
 | 
				
			||||||
 | 
					                client.disconnect()
 | 
				
			||||||
 | 
					            except:
 | 
				
			||||||
 | 
					                pass
 | 
				
			||||||
        
 | 
					        
 | 
				
			||||||
        logging.info(f"[{self.device_name}] Thread {self.name} finished")
 | 
					        logging.info(f"[{self.device_name}] Thread {self.name} finished")
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -174,7 +190,11 @@ def connect_mqtt(mqtt_config):
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
def publish(topic, client, data, retain, qos):
 | 
					def publish(topic, client, data, retain, qos):
 | 
				
			||||||
 | 
					    if isinstance(data, str):
 | 
				
			||||||
 | 
					        msg = data
 | 
				
			||||||
 | 
					    else:
 | 
				
			||||||
        msg = json.dumps(data)
 | 
					        msg = json.dumps(data)
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
    result = client.publish(topic=topic, payload=msg, qos=qos, retain=bool(retain))
 | 
					    result = client.publish(topic=topic, payload=msg, qos=qos, retain=bool(retain))
 | 
				
			||||||
    status = result[0]
 | 
					    status = result[0]
 | 
				
			||||||
    if status == 0:
 | 
					    if status == 0:
 | 
				
			||||||
@@ -217,38 +237,93 @@ async def get_snmp(req):
 | 
				
			|||||||
    return data
 | 
					    return data
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
def ha_create_config(req):
 | 
					def create_ha_device_info(req):
 | 
				
			||||||
    ha_config = {}
 | 
					    """Create device information for Home Assistant MQTT Discovery"""
 | 
				
			||||||
    device = {
 | 
					    return {
 | 
				
			||||||
            "ids": f"{req['device_name']}_{req['ip']}".replace(".", "_"),
 | 
					        "identifiers": [f"snmp2mqtt_{req['device_name']}_{req['ip']}".replace(".", "_")],
 | 
				
			||||||
        "name": req['device_name'],
 | 
					        "name": req['device_name'],
 | 
				
			||||||
 | 
					        "model": "SNMP Device",
 | 
				
			||||||
 | 
					        "manufacturer": "Network Equipment",
 | 
				
			||||||
 | 
					        "via_device": "snmp2mqtt"
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
    origin = {
 | 
					
 | 
				
			||||||
            "name": "snmp2mqtt"
 | 
					
 | 
				
			||||||
 | 
					def create_ha_sensor_config(req, oid):
 | 
				
			||||||
 | 
					    """Create Home Assistant MQTT Discovery configuration for a single sensor"""
 | 
				
			||||||
 | 
					    device_info = create_ha_device_info(req)
 | 
				
			||||||
 | 
					    sensor_id = f"{req['device_name']}_{req['ip']}_{oid['name']}".replace(".", "_")
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    config = {
 | 
				
			||||||
 | 
					        "name": f"{req['device_name']} {oid['name']}",
 | 
				
			||||||
 | 
					        "unique_id": sensor_id,
 | 
				
			||||||
 | 
					        "state_topic": f"SNMP/{req['device_name']}/state",
 | 
				
			||||||
 | 
					        "value_template": f"{{{{ value_json.{oid['name']} }}}}",
 | 
				
			||||||
 | 
					        "device": device_info,
 | 
				
			||||||
 | 
					        "origin": {
 | 
				
			||||||
 | 
					            "name": "snmp2mqtt",
 | 
				
			||||||
 | 
					            "sw_version": "1.0.0",
 | 
				
			||||||
 | 
					            "support_url": "https://git.antoineve.me/AntoineVe/snmp2mqtt"
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    ha_config.update({"dev": device, "o": origin})
 | 
					    }
 | 
				
			||||||
    ha_config.update({"state_topic": f"SNMP/{req['device_name']}/state"})
 | 
					    
 | 
				
			||||||
    ha_config.update({"qos": 2})
 | 
					    # Add device class if specified
 | 
				
			||||||
    cmps = {}
 | 
					    if 'HA_device_class' in oid:
 | 
				
			||||||
 | 
					        config['device_class'] = oid['HA_device_class']
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Add unit of measurement if specified
 | 
				
			||||||
 | 
					    if 'HA_unit' in oid:
 | 
				
			||||||
 | 
					        config['unit_of_measurement'] = oid['HA_unit']
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Add icon based on device class
 | 
				
			||||||
 | 
					    icon_mapping = {
 | 
				
			||||||
 | 
					        'data_size': 'mdi:network',
 | 
				
			||||||
 | 
					        'connectivity': 'mdi:network-outline',
 | 
				
			||||||
 | 
					        'power_factor': 'mdi:gauge',
 | 
				
			||||||
 | 
					        'temperature': 'mdi:thermometer',
 | 
				
			||||||
 | 
					        'signal_strength': 'mdi:signal'
 | 
				
			||||||
 | 
					    }
 | 
				
			||||||
 | 
					    if 'HA_device_class' in oid and oid['HA_device_class'] in icon_mapping:
 | 
				
			||||||
 | 
					        config['icon'] = icon_mapping[oid['HA_device_class']]
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Add availability topic
 | 
				
			||||||
 | 
					    config['availability'] = {
 | 
				
			||||||
 | 
					        "topic": f"SNMP/{req['device_name']}/availability",
 | 
				
			||||||
 | 
					        "payload_available": "online",
 | 
				
			||||||
 | 
					        "payload_not_available": "offline"
 | 
				
			||||||
 | 
					    }
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    return config
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					def get_ha_discovery_topic(req, oid):
 | 
				
			||||||
 | 
					    """Get the correct Home Assistant MQTT Discovery topic for a sensor"""
 | 
				
			||||||
 | 
					    platform = oid['HA_platform']  # 'sensor' or 'binary_sensor'
 | 
				
			||||||
 | 
					    node_id = req['device_name']
 | 
				
			||||||
 | 
					    object_id = f"{req['device_name']}_{oid['name']}".replace(".", "_")
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Format: homeassistant/<platform>/<node_id>/<object_id>/config
 | 
				
			||||||
 | 
					    return f"homeassistant/{platform}/{node_id}/{object_id}/config"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					def publish_ha_autodiscovery_config(client, req):
 | 
				
			||||||
 | 
					    """Publish Home Assistant MQTT Discovery configuration for all sensors of a device"""
 | 
				
			||||||
 | 
					    logging.info(f"[{req['device_name']}] Publishing Home Assistant autodiscovery configuration")
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Publish availability as online
 | 
				
			||||||
 | 
					    availability_topic = f"SNMP/{req['device_name']}/availability"
 | 
				
			||||||
 | 
					    publish(availability_topic, client, "online", True, 1)
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # Publish discovery configuration for each OID/sensor
 | 
				
			||||||
    for oid in req['oids']:
 | 
					    for oid in req['oids']:
 | 
				
			||||||
        cmps.update(
 | 
					        config = create_ha_sensor_config(req, oid)
 | 
				
			||||||
                {
 | 
					        topic = get_ha_discovery_topic(req, oid)
 | 
				
			||||||
                    f"{req['device_name']}_{req['ip']}_{oid['name']}".replace(".", "_"):
 | 
					        
 | 
				
			||||||
                    {
 | 
					        # Publish with retain=True so HA discovers it after restarts
 | 
				
			||||||
                        "p": oid['HA_platform'],
 | 
					        publish(topic, client, config, True, 1)
 | 
				
			||||||
                        "device_class": oid['HA_device_class'],
 | 
					        logging.info(f"[{req['device_name']}] Published discovery config for {oid['name']} to {topic}")
 | 
				
			||||||
                        "value_template": f"{{{{ value_json.{oid['name']}}}}}",
 | 
					        
 | 
				
			||||||
                        "unique_id": f"{req['device_name']}_{req['ip']}_{oid['name']}".replace(".", "_"),
 | 
					        # Small delay to avoid overwhelming the broker
 | 
				
			||||||
                        "name": oid['name']
 | 
					        time.sleep(0.1)
 | 
				
			||||||
                        }
 | 
					 | 
				
			||||||
                    })
 | 
					 | 
				
			||||||
        if "HA_unit" in oid.keys():
 | 
					 | 
				
			||||||
            cmps.update(
 | 
					 | 
				
			||||||
                 {f"{req['device_name']}_{req['ip']}_{oid['name']}".replace(".", "_"):
 | 
					 | 
				
			||||||
                    {"unit_of_measurement": oid['HA_unit']}})
 | 
					 | 
				
			||||||
    ha_config.update({"cmps": cmps})
 | 
					 | 
				
			||||||
    logging.debug(f"config : {json.dumps(ha_config)}")
 | 
					 | 
				
			||||||
    return ha_config
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
def signal_handler(signum, frame):
 | 
					def signal_handler(signum, frame):
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user