Table of Contents

Come accedere e utilizzare i file di registro OpenAPS per la risoluzione dei problemi e l'ottimizzazione

OpenAPS (Open Artificial Pancreas System) è un sistema pancreas artificiale a gestione comunitaria, che automatizza la consegna dell'insulina per le persone con diabete. Il sistema funziona su piccoli computer come Raspberry Pi o Intel Edison, elaborando dati del monitor di glucosio continuo (CGM) e controllando una pompa di insulina in tempo reale.

Questa guida fornisce un'occhiata profonda e pratica ai registri di OpenAPS: come accedervi, cosa significa ogni sezione, come usarli per debug problemi comuni, e come sfruttare i dati di registro per ottimizzare il sistema per migliorare i risultati del glucosio. Se siete un nuovo utente che imposta il vostro primo impianto o un costruttore esperto che cerca di spremere migliori prestazioni, la comprensione dei registri è una capacità che vi servirà bene.

Accesso ai file di registro OpenAPS

OpenAPS memorizza i file di registro sul dispositivo che esegue il sistema, in genere un Raspberry Pi che esegue Raspbian o un simile sistema operativo Linux. L'accesso richiede la connessione a quel dispositivo, sia localmente che tramite la rete.

SSH: Il metodo di accesso remoto primario

Con SSH abilitato sul vostro impianto, è possibile connettersi da qualsiasi computer sulla stessa rete utilizzando un client terminale. Su Windows, i client più popolari includono PuTTY e il Terminal Windows; su macOS e Linux, il comando integrato ] funziona direttamente. Una volta connesso con l'indirizzo IP e le credenziali del vostro impianto, è possibile visualizzare la riga di comando completa.

Accesso diretto alla console

Se il tuo impianto è fisicamente accessibile e SSH non è disponibile o non funziona, è possibile collegare un monitor e una tastiera direttamente al dispositivo. Questo metodo è utile per la configurazione iniziale o quando i problemi di rete impediscono l'accesso remoto. Gli stessi file di registro sono disponibili dalla console e è possibile utilizzare i comandi Linux standard per navigare e leggerli.

Trasferire i registri con SCP e SFTP

Per un'analisi dettagliata su un computer desktop, è possibile copiare i file di registro utilizzando SCP (Secure Copy) o SFTP (SSH File Transfer Protocol). Questi strumenti consentono di scaricare intere directory di registro o file specifici sulla macchina locale. Ad esempio, il comando copia il file di registro principale nella directory corrente.

Log File Locations e Directory Structure

Per impostazione predefinita, OpenAPS memorizza i file di registro nella directory . Il file di registro primario è [, che registra gli eventi principali del sistema, le letture dei sensori, le decisioni di dosaggio dell'insulina e gli errori. Inoltre, è possibile trovare sottodirectory o file di registro aggiuntivi per componenti specifici:

  • – Il registro principale del sistema, contenente tutti gli eventi principali.
  • – I registri dell'algoritmo oref0, che gestisce la logica decisionale.
  • – Tronchi di comunicazione specifici per pompe, inclusi i comandi inviati e le risposte ricevute.
  • – Dati e calibrazione CGM Raw.
  • – I registri del modulo di rilevamento dell'autosensibilità, che regola i tassi basali in base ai modelli osservati.

Alcune configurazioni possono anche ruotare i log automaticamente, creando archivi compressi come []]. Questi contengono voci precedenti e possono essere decompressi con per la revisione. Capire il layout della directory ti aiuta a passare direttamente alla fonte di un problema specifico piuttosto che alla ricerca attraverso un singolo file monolitico.

Comprendere la struttura dei registri OpenAPS

I file di registro OpenAPS sono file di testo semplici con voci timestamp. Ogni riga inizia tipicamente con una data e un'ora in formato ISO 8601, seguita da un livello di gravità (INFO, WARN, ERROR, DEBUG), e poi un messaggio dettagliato che descrive l'evento. Il livello di dettaglio dipende dalla verbalosità di registrazione configurata, che può essere regolata nelle impostazioni del sistema.

Timestamps e fusi orari

Ogni entrata di registro include un timestamp preciso. È fondamentale che l'orologio del vostro impianto sia accurato e impostato sulla zona di tempo corretta. I timbri di tempo inconsistenti possono rendere difficile da correlare eventi di registro con tendenze di glucosio o azioni dell'utente reali. Network Time Protocol (NTP) dovrebbe essere abilitato per mantenere l'orologio sincronizzato automaticamente.

Livelli di gravità e cosa si basano

  • INFO:[]] Messaggi operativi normali. Queste letture dei sensori di registrazione, dosi di insulina e decisioni di algoritmo di routine. I messaggi INFO sono i più comuni e aiutano a capire cosa sta facendo il sistema in qualsiasi momento.
  • ATTENZIONE:[]] I avvertimenti indicano potenziali problemi che non hanno causato un fallimento ma possono avere bisogno di attenzione. Esempi includono una lettura del sensore che è leggermente al di fuori dell'intervallo previsto, una comunicazione della pompa che ha richiesto una riprovazione, o una calibrazione che è stata saltata a causa di dati insufficienti.
  • ERROR:[] Gli errori rappresentano guasti che hanno impedito al sistema di completare un'azione. Gli errori comuni includono errori di comunicazione della pompa, disconnessioni dei sensori o timeout dell'algoritmo.
  • DEBUG:[] I messaggi Debug sono molto dettagliati e sono tipicamente abilitati solo quando si esegue un problema specifico. Possono produrre un grande volume di dati e possono contenere dettagli a basso livello che non sono necessari per la revisione di routine.

Rotazione e conservazione del registro

Per evitare che i file di registro consumano tutti gli spazi disponibili del disco, OpenAPS tipicamente implementa la rotazione del registro. I file di registro più vecchi vengono compressi e infine eliminati dopo un numero configurabile di rotazioni. Per impostazione predefinita, i log possono essere conservati per 7-30 giorni, a seconda della configurazione. Se è necessario mantenere i log per periodi più lunghi per l'analisi della tendenza o l'auditing, è possibile regolare le impostazioni di rotazione nel file di configurazione o implementare un archivio di backup personalizzato per eseguire un backup per eseguire un backup personalizzato.

Interpretazione di eventi di registro chiave

Sapere cosa cercare nei registri trasforma i dati grezzi in insights attuabili. Ecco i tipi di eventi più importanti e come interpretarli.

Dati e calibrazioni del sensore

Le voci di registro per i dati del sensore includono il valore del glucosio, il tempo in cui è stato registrato e qualsiasi informazione di calibrazione. Un'entrata tipica sembra: . Gli eventi di calibrazione sono anche registrati, mostrando quando è stato inserito un valore del fingerstick e come il sistema ha regolato le sue letture del sensore di conseguenza.

Eventi di consegna dell'isola

Ogni dose di insulina è registrata, compresi i boli, i tassi di base temporanei e la consegna basale programmata. Le voci includono il tipo di consegna, l'importo in unità e la durata per i tassi temporanei. Ad esempio: o ]. Con il ripristino incrociato di queste voci con le tendenze del glucosio, è possibile valutare se il sistema risponde correttamente agli alti e bassi di dosi.

Decisioni dell'Algoritmo

L'algoritmo di Oref0 prende decisioni su aggiustamenti basali, raccomandazioni bolus e avvisi alti/bassi basati sui livelli di glucosio attuali e prevedibili. Queste decisioni sono registrate con testo esplicativo che rivela il ragionamento dietro ogni azione. Per esempio: . La lettura di queste voci aiuta a capire se le previsioni del sistema si allineano con risultati reali.

Messaggi di errore e di avvertimento

Errori di comunicazione della pompa sono tra i più comuni, spesso apparendo come: o . Questi possono essere causati da interferenze radio, batteria a bassa pompa, o distanza fisica tra il rig e la pompa.

Risoluzione dei problemi con i file di registro

I file di log sono lo strumento principale per diagnosticare i problemi in un sistema OpenAPS. Un approccio sistematico all'analisi dei registri può identificare rapidamente la causa principale dei problemi più comuni.

Processo di risoluzione dei problemi passo-passo

  1. Identificare il periodo di tempo del problema. Se avete notato un problema in un momento specifico, iniziate tirando le voci dei log da intorno a quel periodo.
  2. Cerca per le voci ERROR e ATTENZIONE. Usa [] per estrarre tutti gli avvisi e gli errori. Questi sono gli indicatori più probabili di un problema.
  3. Controllo dei dati mancanti. Cercare lacune nelle letture dei sensori o nelle consegne di insulina. Un divario di oltre 5-10 minuti nei dati dei sensori, o un ingresso di registro orario mancante per lo stato della pompa, può segnalare un guasto di comunicazione.
  4. Correlate con CGM e la cronologia delle pompe. Confronta le voci dei log con la traccia CGM e la cronologia delle pompe dalla pompa dell'insulina. Differenze tra ciò che i rapporti di registro e ciò che la pompa mostra può indicare un registro che è fuori dalla sincronizzazione, o un comando che è stato inviato ma non eseguito.
  5. Riguarda le decisioni dell'algoritmo. Per problemi con il controllo del glucosio, esamina le previsioni dell'algoritmo e le regolazioni dell'insulina risultante.
  6. Controllo degli errori di configurazione.[] Gli errori che si verificano immediatamente dopo una modifica di configurazione sono spesso causati da impostazioni errate nelle preferenze o nel profilo della pompa.

Problemi comuni e loro segni di log

Dosi di insulina missed:[] Cerca sequenze dove è stato richiesto un bolo o un basale di temperatura, ma non è mai stato confermato. Il registro può mostrare seguito da ] senza una successiva voce di conferma. In tali casi, la dose non è stata consegnata e il sistema non può riprovarsi automaticamente.

Sensore lacune di dati:[] Se la CGM smette di trasmettere, il log mostrerà [ seguito da una maggiore gravità come il divario allunga. Questo può essere causato da un sensore morto, un trasmettitore disconnesso, o interferenza radio.

Insufficienza di comunicazione:[] Le voci ripetute [ suggeriscono un problema fisico o radio. Spostare il rig più vicino alla pompa, sostituire le batterie della pompa, o controllare le fonti di interferenza come altri dispositivi wireless. Il registro mostrerà il numero di tentativi di riprovazione, e se tutti i retries falliscono, il sistema può entrare in una modalità di sicurezza.

Autosens overrides:[] Se si nota il sistema che fornisce più o meno insulina del previsto, controllare i registri di autosensibilità. Un indica che il sistema ha rilevato un modello di sensibilità più alta e sta regolando i tassi basali di conseguenza. Se il rapporto sembra estremo o non corrisponde alle vostre osservazioni, potrebbe essere necessario regolare le impostazioni di autosens o fornire dati più coerenti.

Ottimizzazione del sistema OpenAPS utilizzando i dati di log

Oltre alla risoluzione dei problemi, i file di registro forniscono i dati storici necessari per ottimizzare il sistema per migliorare il controllo del glucosio.

Tassi Basali e Profili Bolus

Se si vede un modello di alti dopo i pasti, controllare il registro per vedere se il sistema bolus raccomandazioni abbinate a quello che è stato effettivamente consegnato. Cercare voci come e quindi verificare che la pompa consegnata tale importo. Se il sistema raccomanda costantemente più insulina di quello che è consegnato, le impostazioni della pompa possono aggiornare i tassi di basamento raffinato.

Ottimizzazione della calibrazione

Se si vedono le tarature che vengono rifiutate o che causano grandi regolazioni dei sensori, si consideri calibrare in tempi più stabili, come quando il glucosio non sta aumentando o cadendo rapidamente. Il registro può aiutare a identificare i tempi migliori per calibrare per la vostra specifica chimica del sensore e del corpo. Inoltre, cercare i modelli di deriva rispetto alle letture dei sensori.

Regolazione delle soglie di allarme

Con la revisione dei registri, è possibile vedere quanto spesso questi avvisi sarebbero stati attivati e se le soglie sono impostate correttamente. Se si riceve troppi falsi allarmi, il log può aiutare a identificare le condizioni che li innescano, permettendo di regolare le soglie per ridurre il rumore senza compromettere la sicurezza dei materiali. Ad esempio, se il log mostra frequenti orizzonte[F]

Analisi delle prestazioni a lungo termine

L'archiviazione dei registri nelle settimane o nei mesi consente un'analisi della tendenza a lungo termine. È possibile monitorare metriche come il time-in-range, il glucosio medio, i cambiamenti della sensibilità all'insulina e l'affidabilità del sistema. Strumenti come ] o gli script Python personalizzati possono analizzare i file di log e generare report di sintesi.

Automatizzazione dell'analisi dei log e del monitoraggio

La lettura manuale dei file di registro ogni giorno non è pratica. Fortunatamente, ci sono diversi modi per automatizzare il monitoraggio del registro e l'avviso.

Impostazione di un logwatch o strumenti simili

Logwatch è uno strumento di analisi dei log che può essere configurato per eseguire quotidianamente ed e-mail un riassunto di eventi importanti. Creando un filtro Logwatch personalizzato per i log di OpenAPS, è possibile ricevere un report giornaliero di avvisi, errori e eventi notabili. Questo consente di rimanere informato senza scorrere manualmente attraverso centinaia di linee di voci di registro. Il report può evidenziare problemi che richiedono attenzione, come ripetuti errori di comunicazione o lacune dei sensori, e fornire la tranquillità che il sistema è in esecuzione.

Creazione di Bash personalizzati o Python Scripts

Per un'analisi più dettagliata, è possibile scrivere script che analizzano i file di registro e generare grafici o statistiche. Ad esempio, uno script Python che utilizza può tracciare la consegna dell'insulina nel tempo accanto alle letture CGM, rendendo facile da correlare visivamente gli eventi.

Impostazione di avvisi in tempo reale

Per eventi critici, gli avvisi in tempo reale possono essere inviati via e-mail, SMS o piattaforme di messaggistica come Telegram o Slack. Un semplice script che monitora il file di registro per le nuove voci ERROR o WARN può attivare una notifica quando si verifica un problema. Ad esempio, è possibile utilizzare per reindirizzare nuovi errori in uno script di notifica.

Considerazioni sulla sicurezza e sulla privacy

I file di registro contengono informazioni di salute personali altamente sensibili, comprese le letture di glucosio, dosi di insulina, timestamp e talvolta i dati di localizzazione se il sistema ha abilitato il collegamento GPS.

Crittografia Log a Riposo e in Transito

Quando i file di registro vengono memorizzati sul rig, devono essere protetti dalla sicurezza generale del dispositivo, comprese le password forti e i file system crittografati. Quando si trasferiscono i log tramite SCP o SFTP, i dati vengono crittografati in transito, che è buona pratica. Evitare di trasferire i log su protocolli crittografati come FTP o HTTP. Se si archivia i log in un servizio cloud o un'unità esterna, si consideri la crittografia dell'archivio con un file come [.

Limitare l'accesso ai file di registro

Evita di condividere file di registro con altri, inclusi su forum pubblici, a meno che non abbia rimosso o anonimizzato tutte le informazioni di identificazione personale. Se hai bisogno di condividere estratti di registro per la risoluzione dei problemi, rivedere attentamente i contenuti e rimuovere qualsiasi dato che potrebbe identificarti, come il tuo nome, la posizione esatta, o i numeri di serie di pompa.

Politiche di conservazione e smaltimento

Stabilire una politica chiara per quanto tempo si mantiene i file di registro e come vengono smaltititi quando non è più necessario. Mentre i registri a lungo termine sono preziosi per l'analisi di tendenza, essi rappresentano anche un rischio di privacy se il dispositivo è perso o rubato.

Conclusioni

I file di registro OpenAPS sono più che un semplice record di eventi; sono una finestra nel funzionamento interno del sistema di distribuzione dell'insulina automatizzato. Imparando come accedere, leggere e analizzare questi registri, ottieni la capacità di diagnosticare i problemi, ottimizzare le prestazioni e infine ottenere un migliore controllo del glucosio. Le competenze e le tecniche descritte in questa guida ti aiuteranno a passare da risoluzione dei problemi reattivi alla gestione del sistema proattiva, assicurando che il tuo sistema di eseguire correttamente la parte di lavoro.