Créer une règle de stockage pour historiser vos données MQTT
MQTT ne conserve par défaut aucun historique : c'est le rôle des règles de stockage de MQpanel de persister les messages d'un topic, en ne gardant que les champs utiles et pendant la durée que vous choisissez.
- 1
Choisir le topic à surveiller
Indiquez le topic exact à écouter (ex. usine/four-3/temperature). Un seul niveau final en # est accepté pour capturer toute une arborescence, mais le wildcard + n'est pas supporté pour une règle de stockage.
- 2
Sélectionner les champs à extraire
En mode « all », le payload complet est conservé tel quel. En mode « custom », listez jusqu'à 20 clés JSON à extraire (ex. temperature, humidity) avec leur unité associée (°C, %, bar...) : seuls ces champs sont stockés, ce qui réduit fortement le volume de données.
- 3
Définir l'intervalle et la rétention
L'intervalle de sauvegarde (0 à 1440 minutes) limite la fréquence d'écriture même si l'appareil publie plus souvent ; la rétention détermine la durée de conservation avant purge automatique.
- 4
Ranger dans un dossier
Organisez vos règles dans une arborescence de dossiers (comme un explorateur de fichiers) pour vous y retrouver quand vous en avez des dizaines réparties par site ou par ligne de production.
- 5
Activer la règle
Une règle inactive n'écrit plus rien mais reste configurée : pratique pour suspendre temporairement un stockage sans perdre son historique ni sa configuration.
Pourquoi extraire des champs plutôt que tout garder ?
Un appareil publie parfois un payload JSON volumineux avec des métadonnées inutiles au stockage long terme. En ne conservant que payload.temperature et payload.humidity par exemple, vous réduisez le volume stocké, accélérez les requêtes d'historique et gardez une donnée directement exploitable dans un dashboard ou un export.
Deux modes de capture
allTout conserver
Le message brut est stocké intégralement, sans extraction — utile en phase d'exploration ou de débogage.
customChamps personnalisés
Seules les clés JSON listées (jusqu'à 20) sont extraites et stockées avec leur unité, une par une.
Intervalle de sauvegarde et rétention
Les deux réglages sont indépendants : l'intervalle limite la fréquence d'écriture, la rétention limite la durée de conservation. Les données sont automatiquement agrégées sur plusieurs fenêtres temporelles (24 heures, 7 jours, 1 mois, 1 an) pour garder des requêtes d'historique rapides même sur de longues périodes.
| Rétention | Valeur | Cas d'usage |
|---|---|---|
| 24 heures | 1 440 min | Suivi de production au jour le jour, débogage rapide |
| 7 jours | 10 080 min | Analyse hebdomadaire, détection de dérives court terme |
| 1 mois | 43 200 min | Reporting mensuel, maintenance préventive |
| 1 an | 525 600 min | Historique long terme, conformité, analyse de tendance annuelle |
Limites à connaître
- 100 règles de stockage maximum par compte
- 20 clés de payload maximum par règle
- 10 niveaux maximum par topic
- Le caractère # est accepté uniquement en toute fin de topic ; le wildcard + n'est pas supporté pour une règle de stockage
Consulter et exporter l'historique
La page de détail d'une règle affiche l'historique stocké sous forme de tableau et de graphique, avec un export CSV en un clic pour analyser vos données dans un tableur ou les réinjecter dans un autre outil.