HyperVisu stocke l'historique de séries chronologiques dans la base de données d'historique embarquée (InfluxDB). Ce chapitre traite de la connexion, de l'export des données de mesure en CSV, de la création de panneaux Grafana et du déplacement de tables de configuration complètes vers et depuis le serveur en fichiers CSV.
Connexion InfluxDB
L'historique nécessite le service InfluxDB. Ouvrez Services et vérifiez que la ligne InfluxDB est activée. Si vous l'activez maintenant, une bannière Pending Changes apparaît : cliquez sur Restart Server et attendez le retour du serveur.
La page InfluxDB Configuration (Services → InfluxDB → Configure) contient une connexion à une base de données d'historique de votre choix. Sur une installation standard, les champs peuvent être vides : le serveur écrit et lit alors l'historique via sa connexion intégrée et vous n'avez rien à remplir.
| Champ | Ce qu'il faut entrer |
|---|---|
| URL | L'adresse de l'instance InfluxDB (par ex. http://localhost:8086). |
| API Token | Un jeton avec autorisations de lecture/écriture. Utilisez le bouton oeil pour l'afficher ou le masquer. |
| Organization | Le nom de l'organisation dans votre instance InfluxDB. |
| Bucket | Le bucket où les données sont stockées. |
Cliquez sur Test Connection pour vérifier la connexion affichée dans le formulaire, puis sur Save pour la stocker. La carte Database Status passe de Not Tested à Connected et affiche l'heure du Last tested. Test Connection nécessite les quatre champs : quand la page est vide, il n'y a rien à tester ici, et vous vérifiez le résultat sur une page de tendance de l'application. Pour la sécurité, un jeton sauvegardé n'est jamais réaffiché ; laissez le champ vide pour le conserver. Si le service InfluxDB lui-même est désactivé, une alerte sur la page vous invite à l'activer d'abord depuis la page Services.
Une fois la connexion sauvegardée, la page affiche également le stockage utilisé et un paramétre Data retention. Raccourcir la période de rétention supprime de manière permanente les données plus anciennes.

Ce qui est enregistré. La journalisation est un interrupteur sur chaque objet de communication. Les objets d'un compteur et d'une entrée analogique de tendance sont enregistrés automatiquement ; pour tout autre objet, vous optéz :
- Ouvrez Devices, déployez l'appareil et cliquez sur le bouton Edit Object (l'engrenage) de l'objet.
- Activez Log historical values.
- Cliquez sur Save object. La ligne de l'objet affiche maintenant une icône de base de données et une icône de graphique. Aucun Apply changes n'est nécessaire.
Chaque valeur que l'objet reçoit est enregistrée à partir de ce moment, qu'elle ait changé ou non ; rien d'antérieur n'est reconstruit (voir « Paramétrages d'objet, Journalisation et notifications »). Les objets enregistrés alimentent les graphiques de tendance et l'historique du compteur dans l'application, les tableaux de bord Grafana, les graphiques du moniteur de bus KNX et l'export CSV ci-dessous.
Export de données CSV
La page CSV Data Export transforme l'historique enregistré en un fichier compatible avec les feuilles de calcul. Elle n'a pas d'entrée propre dans la barre latérale : ouvrez Services et cliquez sur Export dans la ligne InfluxDB.
- Dans Object Selection, cochez les objets à exporter. Ils sont groupés par pièce ; utilisez la boîte de recherche ou Select all. Si la liste est vide, aucun objet n'a encore la journalisation activée — activez-la d'abord (voir « Paramétrages d'objet, Journalisation et notifications »).
- Dans Time Period, définissez Start et End, ou utilisez un raccourci : Last 24h, Last 7 days, Last 30 days, Last year.
- Dans Format, choisissez le Separator : Comma, Semicolon ou Tab.
- Choisissez le Timezone dans lequel les horodatages sont écrits. Le champ s'ouvre sur
Europe/Parisquel que soit le fuseau horaire du serveur, vérifiez-le. - Cliquez sur Export CSV. Le bouton lit Generating... tandis que le serveur prépare le fichier.
- Quand File ready apparaît, cliquez sur Download file.
📘 Note : Le lien de téléchargement est valable pendant 1 heure ; après, lancez un nouvel export. Le fichier est UTF-8 avec BOM, donc il s'ouvre correctement dans Excel.

Journal d'activité de l'appareil
Séparément de la base de données d'historique, le serveur maintient également un journal d'activité par appareil : chaque commande envoyée à un appareil et chaque changement d'état qu'il signale, avec son origine — le résident et le client qu'il a utilisé, le scénario, l'automatisation, la fonction Logic, l'horaire, le groupe, la passerelle KNX ou le webhook qui l'a causé — et si l'appareil a confirmé la commande. Il s'ouvre depuis le bouton Activity sur chaque ligne d'appareil, et ses paramétrages d'enregistrement et de rétention se trouvent sur la page Services → Device Activity Log. Les deux sont décrits dans « Journal d'activité de l'appareil ».