Table of Contents

Comment accéder et utiliser les fichiers de journaux OpenAPS pour le dépannage et l'optimisation

OpenAPS (Open Artificial Pancreas System) est un système pancréas artificiel à source ouverte, dirigé par la communauté, qui automatise la livraison d'insuline pour les personnes atteintes de diabète. Le système fonctionne sur de petits ordinateurs comme Raspberry Pi ou Intel Edison, le traitement des données de monitoring continu du glucose (CGM) et le contrôle d'une pompe à insuline en temps réel. Bien qu'OpenAPS est conçu pour fonctionner de manière fiable, aucun système n'est parfait.

Ce guide offre un regard profond et pratique sur les journaux OpenAPS : comment y accéder, ce que chaque section signifie, comment les utiliser pour déboger des problèmes communs, et comment utiliser les données de journal pour affiner votre système pour obtenir de meilleurs résultats en glucose. Que vous soyez un nouvel utilisateur qui met en place votre premier appareil ou un constructeur expérimenté qui cherche à réduire les performances, comprendre les journaux est une compétence qui vous servira bien.

Accès aux fichiers de journaux OpenAPS

Avant de pouvoir analyser les journaux, vous devez les obtenir. OpenAPS stocke les fichiers journaux sur l'appareil exécutant le système, généralement un Raspberry Pi exécutant Raspbian ou un système d'exploitation similaire basé sur Linux. L'accès nécessite la connexion à cet appareil, soit localement, soit sur le réseau.

SSH : la méthode d'accès à distance primaire

Secure Shell (SSH) est la façon la plus courante et pratique d'accéder aux journaux OpenAPS. Avec SSH activé sur votre appareil, vous pouvez vous connecter à partir de n'importe quel ordinateur sur le même réseau en utilisant un client terminal. Sur Windows, les clients populaires incluent PuTTY et le terminal Windows; sur macOS et Linux, la commande intégrée fonctionne directement. Une fois connectée à l'adresse IP et aux identifiants de votre appareil, vous avez accès en ligne de commande complète pour parcourir, consulter et transférer les fichiers journaux.

Accès direct à la console

Si votre appareil est physiquement accessible et que SSH n'est pas disponible ou ne fonctionne pas, vous pouvez connecter un moniteur et un clavier directement à l'appareil. Cette méthode est utile pour la configuration initiale ou lorsque des problèmes de réseau empêchent l'accès à distance. Les mêmes fichiers journaux sont disponibles depuis la console, et vous pouvez utiliser des commandes Linux standard pour les naviguer et les lire.

Transfert de journaux avec SCP et SFTP

Pour une analyse détaillée sur un ordinateur de bureau, vous pouvez copier des fichiers journaux en utilisant SCP (Secure Copy) ou SFTP (SSH File Transfer Protocol). Ces outils vous permettent de télécharger des répertoires de journaux entiers ou des fichiers spécifiques sur votre machine locale. Par exemple, la commande copie le fichier principal de journal dans votre répertoire actuel.

Emplacements des fichiers et structure des répertoires

Par défaut, OpenAPS stocke les fichiers journaux dans le répertoire . Le fichier journal principal est , qui enregistre les principaux événements système, les lectures de capteurs, les décisions de dosage d'insuline et les erreurs.

  • – Le journal principal du système, contenant tous les événements principaux.
  • – Loges à partir de l'algorithme oref0, qui gère la logique de prise de décision.
  • – Registres de communication spécifiques à la pompe, y compris les commandes envoyées et les réponses reçues.
  • – Données brutes de MCC et événements d'étalonnage.
  • – Loges du module de détection d'autosensibilité, qui ajuste les taux basaux en fonction des patrons observés.

Certaines configurations peuvent également faire tourner automatiquement les journaux, créant des archives compressées comme . Celles-ci contiennent des entrées plus anciennes et peuvent être décompressées avec pour examen. Comprendre la mise en page du répertoire vous aide à accéder directement à la source d'un problème spécifique plutôt que de chercher dans un seul fichier monolithique.

Comprendre la structure des journaux OpenAPS

Les fichiers journaux OpenAPS sont des fichiers texte simples avec des entrées horodatées. Chaque ligne commence généralement par une date et une heure au format ISO 8601, suivie d'un niveau de sévérité (INFO, WARN, ERROR, DEBUG), puis d'un message détaillé décrivant l'événement. Le niveau de détail dépend de la verbosité de l'enregistrement configurée, qui peut être ajustée dans les paramètres du système.

Timbres et fuseaux horaires

Chaque entrée de journal comprend un horodatage précis. Il est essentiel que l'horloge de votre appareil soit précise et réglée au bon fuseau horaire. Les timbres-temps non cohérents peuvent rendre difficile la corrélation entre les événements de journal et les tendances réelles du glucose ou les actions de l'utilisateur. Le protocole de temps réseau (NTP) doit être activé pour que l'horloge soit synchronisée automatiquement.

Niveaux de gravité et ce qu'ils signifient

  • INFO: Messages opérationnels normaux. Ces relevés de capteurs, les doses d'insuline et les décisions d'algorithme de routine.Les messages INFO sont les plus courants et vous aident à comprendre ce que le système fait à tout moment.
  • WARN:[ Les avertissements indiquent des problèmes potentiels qui n'ont pas causé de défaillance, mais qui peuvent nécessiter une attention.Par exemple, un capteur qui est légèrement hors de la portée prévue, une communication de pompe qui a nécessité une réessayer, ou un calibrage qui a été ignoré en raison de données insuffisantes.
  • ERROR: Les erreurs représentent des défaillances qui ont empêché le système de mener à bien une action.Les erreurs courantes comprennent les défaillances de communication de la pompe, les déconnexions de capteur ou les décalages dans les temps des algorithmes.
  • DEBUG: Les messages de débogage sont très détaillés et ne sont généralement activés que lorsque des problèmes sont résolus. Ils peuvent produire un grand volume de données et peuvent contenir des détails de faible niveau qui ne sont pas nécessaires pour l'examen de routine.

Rotation et conservation des logs

Pour empêcher les fichiers journaux de consommer tout l'espace disque disponible, OpenAPS implémente généralement la rotation des journaux. Les fichiers journaux plus anciens sont compressés et finalement supprimés après un nombre configurable de rotations. Par défaut, les journaux peuvent être conservés pendant 7 à 30 jours, selon la configuration. Si vous devez conserver les journaux pendant des périodes plus longues pour l'analyse de tendance ou l'audit, vous pouvez ajuster les paramètres de rotation dans le fichier de configuration ou mettre en œuvre un script de sauvegarde personnalisé pour archiver les journaux dans le stockage externe.

Interprétation des événements du journal des clés

Savoir ce que l'on recherche dans les journaux transforme les données brutes en idées actionnables. Voici les types d'événements les plus importants et comment les interpréter.

Données et calibrages du capteur

Les lectures CGM sont le fondement de la prise de décision OpenAPS. Les entrées de registre pour les données du capteur comprennent la valeur du glucose, le temps qu'il a été enregistré et toute information d'étalonnage. Une entrée typique ressemble à : . Les événements d'étalonnage sont également enregistrés, montrant quand une valeur de la baguette de doigt a été entrée et comment le système a ajusté ses lectures de capteur en conséquence.

Événements de livraison d'insuline

Chaque dose d'insuline est enregistrée, y compris les bolus, les taux basaux temporaires et l'accouchement initial. Les entrées comprennent le type d'accouchement, la quantité en unités et la durée des taux temporaires. Par exemple : ou . En faisant un renvoi à ces entrées avec les tendances du glucose, vous pouvez évaluer si le système répond adéquatement aux hauts et aux bas. Des doses inattendues ou des livraisons manquées sont facilement repérées dans la séquence logarithmique.

Décisions concernant l'algorithme

L'algorithme oref0 prend des décisions sur les ajustements basaux, les recommandations de bolus et les alertes élevées/faibles basées sur les niveaux de glucose actuels et prévus. Ces décisions sont consignées avec un texte explicatif qui révèle le raisonnement derrière chaque action. Par exemple : . La lecture de ces entrées vous aide à comprendre si les prévisions du système s'harmonisent avec les résultats réels.

Messages d'erreur et d'avertissement

Les erreurs et les avertissements sont les entrées les plus susceptibles d'être utilisées pour le dépannage. Les erreurs de communication de la pompe sont parmi les plus courantes, apparaissant souvent comme : ou . Elles peuvent être causées par des interférences radio, une batterie à faible pompe ou une distance physique entre le gréement et la pompe.

Dépannage avec les fichiers journaux

Les fichiers journaux sont le principal outil de diagnostic des problèmes dans un système OpenAPS. Une approche systématique de l'analyse des journaux peut rapidement identifier la cause profonde des problèmes les plus courants.

Processus de dépannage étape par étape

  1. Identifiez la période de temps de la question. Si vous avez remarqué un problème à un moment précis, commencez par tirer des entrées de journal autour de cette période. Utilisez avec un motif d'horodatage pour restreindre la recherche.
  2. Rechercher les entrées ERROR et WARN. Utilisez pour extraire tous les avertissements et erreurs.Ce sont les indicateurs les plus probables d'un problème.
  3. Choisissez les données manquantes. Recherchez les lacunes dans les relevés de capteurs ou les livraisons d'insuline. Une lacune de plus de 5 à 10 minutes dans les données de capteurs, ou une saisie horaire manquante pour le statut de la pompe, peut signaler une défaillance de communication.
  4. Correlate avec l'historique de la pompe et de la MCC Comparer les entrées de log avec l'historique de la trace et de la pompe de la pompe à insuline.
  5. Review algorithme de décisions. Pour les problèmes de contrôle du glucose, examinez les prédictions de l'algorithme et les ajustements d'insuline qui en résultent.
  6. Choisissez les erreurs de configuration. Les erreurs qui surviennent immédiatement après un changement de configuration sont souvent causées par des réglages incorrects dans les préférences ou le profil de la pompe.

Questions communes et signatures de leur registre

][FLT:]]]][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][FLT:][F][FLT:[FLT:][

Sénateurs de lacunes :[ Si la MCC cesse de transmettre, le journal affichera , suivi d'une sévérité croissante à mesure que la longueur de la distance s'allonge. Cela peut être causé par un capteur mort, un émetteur déconnecté ou un brouillage radio.

Défauts de communication de pompe:[ Les entrées répétées suggèrent un problème physique ou radio. Déplacez le système de commande plus près de la pompe, remplacez les batteries de pompe ou vérifiez les sources d'interférence comme d'autres appareils sans fil. Le journal indique le nombre de tentatives de réessayer et si toutes les rétries échouent, le système peut entrer en mode de sécurité.

Autosens remplace: Si vous remarquez que le système fournit plus ou moins d'insuline que prévu, vérifiez les registres d'autosensibilité. Un indique que le système a détecté un schéma de sensibilité plus élevée et ajuste les taux basaux en conséquence. Si le rapport semble extrême ou ne correspond pas à vos observations, vous pouvez avoir besoin d'ajuster les paramètres d'autosens ou de fournir des données plus cohérentes.

Optimisation de votre système OpenAPS Utilisation des données de journal

Au-delà du dépannage, les fichiers journaux fournissent les données historiques nécessaires pour affiner votre système pour un meilleur contrôle du glucose. En examinant régulièrement les journaux, vous pouvez identifier les modèles et faire des ajustements éclairés.

Taux de base et profils Bolus

Si vous voyez un modèle de hauts après les repas, vérifiez si les recommandations du bolus du système correspondent à ce qui a été réellement livré. Recherchez des entrées comme et vérifiez ensuite que la pompe a livré cette quantité. Si le système recommande systématiquement plus d'insuline que ce qui est livré, les réglages de la pompe peuvent nécessiter une mise à jour. De même, les taux basaux du jour peuvent être affinés en examinant le journal pour des périodes de glucose stable et en notant le taux basal en vigueur.

Optimisation de l'étalonnage

Si vous voyez des calibrations qui sont rejetées ou qui causent de gros ajustements de capteur, envisagez de calibrer à des moments plus stables, comme lorsque le glucose ne monte pas ou ne tombe pas rapidement. Le log peut vous aider à identifier les meilleurs temps pour calibrer votre capteur et la chimie du corps. En outre, recherchez des modèles de dérive dans les lectures de capteur. Si le capteur lit régulièrement bas ou haut par rapport aux doigts, vous pouvez avoir besoin d'ajuster la courbe d'étalonnage ou de remplacer le capteur.

Réglage des seuils d'alerte

En examinant les journaux, vous pouvez voir à quelle fréquence ces alertes auraient été déclenchées et si les seuils sont fixés de façon appropriée. Si vous recevez trop de fausses alertes, le journal peut vous aider à identifier les conditions qui les déclenchent, vous permettant d'ajuster les seuils pour réduire le bruit sans compromettre la sécurité. Par exemple, si le journal affiche des alertes fréquentes qui ne se matérialisent pas, vous pouvez vouloir ajuster l'horizon de prédiction ou la valeur de seuil.

Analyse du rendement à long terme

L'archivage des journaux sur des semaines ou des mois permet une analyse des tendances à long terme. Vous pouvez suivre des paramètres tels que le temps dans l'intervalle, le glucose moyen, les changements de sensibilité à l'insuline et la fiabilité du système. Des outils comme ou des scripts Python personnalisés peuvent analyser des fichiers de journaux et générer des rapports sommaires.

Automatisation de l'analyse et de la surveillance des registres

La lecture manuelle des fichiers journaux tous les jours n'est pas pratique. Heureusement, il existe plusieurs façons d'automatiser la surveillance et l'alerte des journaux.

Configuration de la Logwatch ou d'outils similaires

Logwatch est un outil d'analyse de journal qui peut être configuré pour exécuter quotidiennement et envoyer un résumé des événements importants. En créant un filtre de journal personnalisé pour les journaux OpenAPS, vous pouvez recevoir un rapport quotidien des avertissements, erreurs et événements notables. Cela vous permet de rester informé sans défiler manuellement à travers des centaines de lignes d'entrées de journal. Le rapport peut mettre en évidence des problèmes qui nécessitent une attention, comme les erreurs de communication répétées ou les lacunes de capteur, et fournir la tranquillité d'esprit que le système fonctionne normalement.

Création de scripts Bash ou Python personnalisés

Pour une analyse plus détaillée, vous pouvez écrire des scripts qui analysent les fichiers journaux et génèrent des graphiques ou des statistiques. Par exemple, un script Python utilisant peut tracer la livraison d'insuline au cours du temps aux côtés des lectures CGM, ce qui facilite la corrélation visuelle des événements. Scripts peut également calculer des mesures comme le pourcentage de temps passé dans une plage cible de glucose, le nombre moyen d'erreurs par jour, ou la fréquence des ajustements autosens. En exécutant ces scripts périodiquement et en stockant la sortie, vous construisez un enregistrement historique qui aide à suivre les performances du système et les changements au fil du temps.

Mise en place d'alertes en temps réel

Pour les événements critiques, les alertes en temps réel peuvent être envoyées par e-mail, SMS ou plateformes de messagerie comme Telegram ou Slack. Un script simple qui surveille le fichier journal pour les nouvelles entrées ERROR ou WARN peut déclencher une notification en cas de problème. Par exemple, vous pouvez utiliser pour introduire de nouvelles erreurs dans un script notification. Cela vous assure de connaître les problèmes dès qu'ils se produisent, plutôt que de les découvrir plus tard lors d'un examen du journal. Les alertes en temps réel sont particulièrement utiles pour les problèmes qui nécessitent une action immédiate, comme une défaillance de la communication de pompe qui pourrait conduire à une livraison d'insuline manquée.

Considérations relatives à la sécurité et à la protection des renseignements personnels

Les fichiers de registre contiennent des informations personnelles très sensibles sur la santé, y compris des relevés de glucose, des doses d'insuline, des horodatages et parfois des données de localisation si la plate-forme a permis l'enregistrement GPS.

Cryptage des journaux au repos et en transit

Lorsque les fichiers journaux sont stockés sur le rig, ils doivent être protégés par la sécurité globale de l'appareil, y compris les mots de passe forts et les systèmes de fichiers chiffrés. Lors du transfert des journaux via SCP ou SFTP, les données sont cryptées en transit, ce qui est une bonne pratique. Évitez de transférer des journaux sur des protocoles non cryptés comme FTP ou HTTP. Si vous archivez des journaux vers un service de cloud ou un disque externe, envisagez de chiffrer l'archive avec un outil comme ou en utilisant un fichier zip chiffré.

Limiter l'accès aux fichiers journaux

Évitez de partager des fichiers de journaux bruts avec d'autres personnes, y compris sur des forums publics, à moins que vous n'ayez supprimé ou anonymisé toutes les informations personnelles d'identification. Si vous devez partager des extraits de journaux pour dépanner l'aide, examinez attentivement le contenu et supprimez toute donnée qui pourrait vous identifier, comme votre nom, l'emplacement exact ou les numéros de série de pompe.

Politiques de conservation et de destruction

Bien que les journaux à long terme soient utiles pour l'analyse des tendances, ils représentent également un risque de confidentialité si l'appareil est perdu ou volé. Purge régulièrement les vieux journaux qui ne sont plus nécessaires, et veille à ce que lorsque vous déclassez un appareil, les fichiers journaux soient définitivement effacés. L'utilisation du chiffrement à disque complet sur le dispositif peut protéger les données en cas de vol.

Conclusion

Les fichiers journaux OpenAPS sont plus qu'un simple enregistrement d'événements; ils sont une fenêtre dans le fonctionnement intérieur de votre système automatisé d'administration d'insuline. En apprenant à accéder, lire et analyser ces journaux, vous obtenez la capacité de diagnostiquer les problèmes, d'optimiser les performances et finalement d'obtenir un meilleur contrôle du glucose. Les compétences et les techniques décrites dans ce guide vous aideront à passer du dépannage réactif à la gestion proactive du système, en assurant que votre appareil OpenAPS fonctionne de façon sûre, fiable et efficace.