Table of Contents

Hoe OpenAPS-logbestanden te openen en te gebruiken voor het oplossen en optimaliseren van problemen

OpenAPS (Open Artificial Pancreas System) is een door de gemeenschap aangedreven, open-source artificial pancreas systeem dat insuline levering automatiseert voor mensen met diabetes. Het systeem draait op kleine computers zoals Raspberry Pi of Intel Edison, het verwerken van continue glucose monitor (CGM) gegevens en het controleren van een insulinepomp in real time. Hoewel OpenAPS is ontworpen om betrouwbaar te werken, geen systeem is perfect. Logbestanden zijn de primaire kenmerkende hulpmiddel voor het begrijpen van wat het systeem doet, waarom het een bepaalde beslissing heeft genomen, en waar dingen verkeerd zijn gegaan. Mastering log files is essentieel voor een veilige werking, effectieve probleemoplossing, en op lange termijn optimalisatie van uw installatie.

Deze gids biedt een diepe, praktische blik op OpenAPS-logboeken: hoe toegang te krijgen tot deze bestanden, wat elk gedeelte betekent, hoe ze te gebruiken voor het debuggen van veelvoorkomende problemen, en hoe loggegevens te gebruiken om uw systeem te verfijnen voor betere glucose-resultaten. Of u nu een nieuwe gebruiker bent die uw eerste rig opzet of een ervaren bouwer die op zoek is naar betere prestaties, het begrijpen van logs is een vaardigheid die u goed zal dienen.

OpenAPS-logbestanden openen

Voordat u logs kunt analyseren, moet u naar hen toe. OpenAPS slaat logbestanden op het apparaat dat het systeem draait, typisch een Raspberry Pi die Raspbian of een vergelijkbaar Linux-gebaseerd besturingssysteem draait. Toegang vereist verbinding met dat apparaat, hetzij lokaal of via het netwerk.

SSH: De primaire methode voor toegang op afstand

Secure Shell (SSH) is de meest voorkomende en praktische manier om toegang te krijgen tot OpenAPS-logs. Met SSH ingeschakeld op uw rig, kunt u verbinding maken vanaf elke computer op hetzelfde netwerk met behulp van een terminalclient. Op Windows, populaire clients omvatten PuTTY en de Windows Terminal; op macOS en Linux, het ingebouwde commando werkt direct. Zodra verbonden met het IP-adres en de referenties van uw rig, hebt u volledige toegang tot commandoregel om te bladeren, bekijken en logbestanden over te dragen.

Directe consoletoegang

Als uw rig fysiek toegankelijk is en SSH niet beschikbaar of niet werkt, kunt u een monitor en toetsenbord rechtstreeks op het apparaat aansluiten. Deze methode is nuttig voor de initiële installatie of wanneer netwerkproblemen toegang op afstand voorkomen. Dezelfde logbestanden zijn beschikbaar vanaf de console, en u kunt standaard Linux commando's gebruiken om te navigeren en ze te lezen.

Logs met SCP en SFTP overdragen

Voor gedetailleerde analyse op een desktopcomputer kunt u logbestanden kopiëren met behulp van SCP (Secure Copy) of SFTP (SSH File Transfer Protocol). Deze tools staan u toe om hele log directories of specifieke bestanden naar uw lokale machine te downloaden. Bijvoorbeeld, het commando kopieert het hoofdlogbestand naar uw huidige directory. SFTP clients zoals FileZilla bieden een grafische interface voor drag-and-drop transfers, wat gemakkelijker kan zijn voor gebruikers die liever niet de commandoregel gebruiken.

Logbestandlocaties en directorystructuur

Standaard slaat OpenAPS logbestanden op in de directory. Het primaire logbestand is , die de belangrijkste systeemgebeurtenissen, sensormetingen, beslissingen over insulinedosering en fouten registreert. Daarnaast kunt u submappen of extra logbestanden voor specifieke componenten vinden:

  • . . Het hoofdsysteemlogboek, met alle kerngebeurtenissen.
  • .. Logs van het algoritme van de oref0, die de besluitvormingslogica behandelt.
  • [[FLT:]] . . Raw CGM-gegevens en kalibratie-gebeurtenissen.
  • [[FLT:]] . . Logs from the autosensitiviteit detectation module, which adjusts basale rates based on observed patterns.

Sommige instellingen kunnen ook automatisch logs draaien, waardoor gecomprimeerde archieven worden aangemaakt zoals . Deze bevatten oudere items en kunnen worden gedecomprimeerd met voor herziening. Het begrijpen van de directory-layout helpt u om direct naar de bron van een specifiek probleem te gaan in plaats van door een enkel monolithisch bestand te zoeken.

De structuur van OpenAPS-logs begrijpen

OpenAPS logbestanden zijn platte tekstbestanden met tijdstempel. Elke regel begint meestal met een datum en tijd in ISO 8601 formaat, gevolgd door een ernstniveau (INFO, WARN, FOUT, DEBUG), en vervolgens een gedetailleerd bericht waarin de gebeurtenis wordt beschreven. Het detailniveau hangt af van de ingestelde logging verbosity, die kan worden aangepast in de systeeminstellingen.

Tijdstempels en tijdzones

Elke log-invoer bevat een precieze tijdstempel. Het is van cruciaal belang dat de klok van uw rig correct is en ingesteld wordt op de juiste tijdzone. Inconsistente tijdstempels kunnen het moeilijk maken om log-gebeurtenissen te correleren met de werkelijke glucosetrends of gebruikersacties. Network Time Protocol (NTP) moet ingeschakeld worden om de klok automatisch te synchroniseren. Bij het bekijken van logs, let altijd op de gebruikte tijdzone, vooral als u loggegevens vergelijkt met CGM-gegevens van een telefoon of ander apparaat dat een andere tijdzone kan gebruiken.

Severity Levels en wat ze betekenen

  • INFO: Normale operationele berichten. Deze opnames van sensors, insulinedoses en routine-algoritme beslissingen. INFO-berichten zijn de meest voorkomende en helpen u te begrijpen wat het systeem op elk moment doet.
  • WARN: Waarschuwingen wijzen op potentiële problemen die geen storing veroorzaakten maar wellicht aandacht nodig hebben. Voorbeelden zijn een sensor die iets buiten het verwachte bereik ligt, een pompcommunicatie die een herhaling nodig had, of een kalibratie die werd overgeslagen vanwege onvoldoende gegevens.
  • FOUT: Fouten vertegenwoordigen storingen die het systeem verhinderden een actie te voltooien. Veel voorkomende fouten zijn onder meer communicatiestoringen met de pomp, sensoruitschakelingen of time-outs van het algoritme. Fouten moeten snel worden onderzocht, omdat ze kunnen leiden tot gemiste insulinedoses of onjuiste doseringsbeslissingen.
  • DEBUG: Debugberichten zijn zeer gedetailleerd en zijn meestal alleen ingeschakeld wanneer het oplossen van een specifiek probleem. Ze kunnen een groot volume aan gegevens produceren en kunnen details bevatten die niet nodig zijn voor routine-evaluatie.

Logrotatie en bewaring

Om te voorkomen dat logbestanden alle beschikbare schijfruimte verbruiken, implementeert OpenAPS meestal logrotatie. Oudere logbestanden worden gecomprimeerd en uiteindelijk verwijderd na een configureerbaar aantal rotaties. Standaard kunnen logs 7 tot 30 dagen worden bewaard, afhankelijk van de configuratie. Als u logs voor langere perioden moet bewaren voor trendanalyse of auditing, kunt u de rotatie-instellingen aanpassen in het configuratiebestand of een aangepast back-upscript implementeren om logs te archiveren naar externe opslag.

Tolken van sleutelloggebeurtenissen

Weten wat te zoeken in logs verandert ruwe data in bruikbare inzichten. Hier zijn de belangrijkste gebeurtenissen types en hoe ze te interpreteren.

Sensorgegevens en kalibraties

CGM-waarden zijn de basis van de besluitvorming over OpenAPS. De log-inzendingen voor sensorgegevens omvatten de glucosewaarde, de tijd die werd geregistreerd en eventuele kalibratiegegevens. Een typische vermelding ziet eruit als: ]. Kalibratie-gebeurtenissen worden ook geregistreerd, waarbij wordt aangegeven wanneer een vingerkleefwaarde werd ingevoerd en hoe het systeem de sensorwaarden dienovereenkomstig heeft aangepast. Kijk naar patronen van frequente kalibraties of ingangen waar het systeem een kalibratie afwijst omdat de waarden te ver uit elkaar liggen. Deze kunnen sensordrift- of kalibratiefouten aangeven.

Insulineleverings- gebeurtenissen

Elke insulinedosis wordt geregistreerd, inclusief bolussen, tijdelijke basale snelheden en geplande basale levering. De vermeldingen omvatten het type levering, de hoeveelheid in eenheden, en de duur van tijdelijke tarieven. Bijvoorbeeld: [ of ]. Door kruisverwijzing van deze vermeldingen met glucose trends, kunt u beoordelen of het systeem op de juiste wijze reageert op hoge en lage waarden. Onverwachte grote doses of gemiste leveringen worden gemakkelijk gespot in de logsequentie.

Algoritmebesluiten

Het oref0 algoritme neemt beslissingen over basale aanpassingen, bolusaanbevelingen en hoge/lage waarschuwingen op basis van de huidige en voorspelde glucoseniveaus. Deze beslissingen zijn gelogd met verklarende tekst die de redenering achter elke actie onthult. Bijvoorbeeld: ]. Het lezen van deze vermeldingen helpt u te begrijpen of de voorspellingen van het systeem in overeenstemming zijn met de werkelijke resultaten. Aanhoudende verschillen kunnen aangeven dat de modelparameters aanpassing nodig hebben.

Foutmeldingen en waarschuwingsberichten

Fouten en waarschuwingen zijn de meest actieve ingangen voor probleemoplossing. Pump communicatiefouten zijn een van de meest voorkomende, vaak verschijnend als: of ]. Deze kunnen worden veroorzaakt door radiostoring, lage pomp batterij, of fysieke afstand tussen de booreiland en de pomp. Sensorfouten, zoals , wijzen op een verlies van CGM-verbinding die kan leiden tot gemiste gegevens en mogelijk onjuiste dosering. Alle fouten moeten worden onderzocht en opgelost voordat op het systeem voor geautomatiseerde insulinelevering wordt vertrouwd.

Problemen oplossen met logbestanden

Logbestanden zijn het primaire hulpmiddel voor het diagnosticeren van problemen in een OpenAPS-systeem. Een systematische aanpak van loganalyse kan snel de oorzaak van de meest voorkomende problemen identificeren.

Stap-voor-stap probleemoplossingsproces

  1. Identificeer het tijdskader van het probleem. Als je een probleem op een bepaald moment opmerkt, begin dan met het trekken van logingangen uit die periode. Gebruik met een tijdstempelpatroon om de zoekopdracht te vernauwen.
  2. Zoeken naar foutmeldingen en WARN-vermeldingen. Gebruik om alle waarschuwingen en fouten te extraheren. Dit zijn de meest waarschijnlijke indicatoren van een probleem.
  3. Controleer op ontbrekende gegevens. Zoek naar gaten in sensormetingen of insulineleveringen. Een gat van meer dan 5-10 minuten in sensorgegevens, of een ontbrekende uurlog voor pompstatus, kan een communicatiestoring signaleren.
  4. Korreleer met CGM en pompgeschiedenis.[ Vergelijk logvermeldingen met de werkelijke CGM-sporen en pompgeschiedenis van uw insulinepomp. Discreties tussen wat de log meldt en wat de pomp laat zien kan een log aangeven dat niet synchroon is, of een commando dat werd verzonden maar niet uitgevoerd.
  5. Bekijk algoritme beslissingen. Voor problemen met glucosecontrole, onderzoekt u de voorspellingen van het algoritme en de resulterende insuline aanpassingen. Kijk naar patronen waar het systeem consequent overcorrigeert of ondercorrigeert.
  6. Controleer op configuratiefouten. Fouten die onmiddellijk na een configuratieverandering optreden worden vaak veroorzaakt door onjuiste instellingen in het voorkeuren- of pompprofiel. Bekijk de log rond de tijd van de verandering om te zien of een specifieke parameter het probleem heeft veroorzaakt.

Gemeenschappelijke problemen en hun log ondertekeningen

Vermiste insulinedoses: Zoek naar sequenties waar een bolus of temp basale bolus werd gevraagd maar nooit werd bevestigd. Het logboek kan tonen gevolgd door zonder een volgende bevestigingsvermelding. In dergelijke gevallen werd de dosis niet geleverd en het systeem kan niet automatisch opnieuw proberen. U moet de pompgeschiedenis controleren en de gemiste dosis handmatig afleveren indien nodig.

Sensorgegevens hiaten: Als de CGM stopt met zenden, zal het logboek volgen door de ernst te verhogen naarmate de kloof langer wordt. Dit kan worden veroorzaakt door een dode sensor, een losgekoppelde zender of radiostoring. Controleer de sensor en zender status, en vervang de sensor indien nodig.

Communicatiestoringen in de pomp: Herhaalde -ingangen suggereren een fysiek of radioprobleem. Verplaats de booreiland dichter bij de pomp, vervang pompbatterijen of controleer op interferentiebronnen zoals andere draadloze apparaten. Het logboek zal het aantal pogingen tot herhaling tonen en als alle herhalingen uitvallen, kan het systeem een veiligheidsmodus in gaan.

Autosensoren overschrijven: Als u merkt dat het systeem meer of minder insuline afgeeft dan verwacht, controleer dan de autosensitiviteit logs. Een geeft aan dat het systeem een patroon van hogere gevoeligheid heeft gedetecteerd en is het aanpassen van de basale tarieven dienovereenkomstig. Als de verhouding extreem lijkt of niet overeenkomt met uw waarnemingen, kunt u de autosensorinstellingen aanpassen of meer consistente gegevens verstrekken.

Optimaliseren van uw OpenAPS-systeem met behulp van loggegevens

Naast het oplossen van problemen, logbestanden bieden de historische gegevens die nodig zijn om uw systeem te verfijnen voor een betere glucosecontrole. Door regelmatig te bekijken logs, kunt u patronen identificeren en geïnformeerde aanpassingen.

Fijne-Tuning Basal Tarieven en Bolus profielen

Het vergelijken van verwachte en werkelijke glucose-resultaten na de maaltijd en overnachting kan onthullen of uw basale tarieven en bolusprofielen moeten worden aangepast. Als u een patroon van hoge waarden na de maaltijd ziet, controleer dan het logboek om te zien of de bolusaanbevelingen van het systeem overeenkomen met wat er daadwerkelijk is geleverd. Zoek naar vermeldingen als ] en controleer dan of de pomp die hoeveelheid heeft geleverd. Als het systeem consequent meer insuline adviseert dan wat wordt geleverd, moeten uw pompinstellingen mogelijk worden bijgewerkt. Ook kunnen de basale tarieven van de nacht worden verfijnd door het log te onderzoeken voor perioden van stabiele glucose en de basale snelheid in werking te stellen. Na verloop van tijd kunt u een nauwkeuriger profiel opbouwen dat de noodzaak voor automatische correcties vermindert.

Kalibratieoptimalisatie

Regelmatige of onregelmatige kalibraties kunnen de prestaties van het systeem afbreken. Bekijk logingangen voor kalibratie-evenementen en noteer de waarden en tijdstempels. Als u kalibraties ziet die worden afgewezen of die grote sensoraanpassingen veroorzaken, overweeg dan kalibreren op stabielere tijden, zoals wanneer glucose niet stijgt of snel daalt. De log kan u helpen de beste tijden te bepalen om te kalibreren voor uw specifieke sensor en lichaamschemie. Kijk ook naar patronen van drift in sensormetingen. Als de sensor consistent laag of hoog in vergelijking met vingerstiften leest, moet u de kalibratiecurve aanpassen of de sensor vervangen.

Alertdrempels worden aangepast

Met OpenAPS kunt u waarschuwingen instellen voor hoge en lage glucose, gemiste gegevens en systeemfouten. Door logs te bekijken, kunt u zien hoe vaak deze waarschuwingen zijn geactiveerd en of de drempels correct zijn ingesteld. Als u te veel valse alarmen ontvangt, kan het logboek u helpen de omstandigheden te identificeren die hen in staat stellen om drempels aan te passen om lawaai te verminderen zonder de veiligheid in gevaar te brengen. Bijvoorbeeld, als het logboek frequente waarschuwingen ] laat zien die niet materialiseren, dan wilt u de voorspellingshorizon of drempelwaarde aanpassen.

Prestatieanalyse op lange termijn

Het archiveren van logs over weken of maanden maakt trendanalyse op lange termijn mogelijk. U kunt metrics bijhouden zoals tijd-in-bereik, gemiddelde glucose, insulinegevoeligheidsveranderingen en systeembetrouwbaarheid. Tools zoals of aangepaste Python scripts kunnen bestanden verwerken en beknopte rapporten genereren. Door logs te vergelijken tussen seizoenen of veranderingen in levensstijl, kunt u zien hoe uw systeem zich aanpast en proactieve aanpassingen maakt voordat er problemen optreden. Dit is vooral waardevol voor het identificeren van geleidelijke veranderingen in insulinegevoeligheid die anders onopgemerkt zouden kunnen blijven totdat ze een probleem veroorzaken.

Automatisering van loganalyse en monitoring

Handmatig lezen van logbestanden elke dag is niet praktisch. Gelukkig zijn er verschillende manieren om log monitoring en waarschuwingen automatiseren.

Logwatch of soortgelijke hulpmiddelen instellen

Logwatch is een loganalysetool die dagelijks kan worden geconfigureerd en een samenvatting van belangrijke gebeurtenissen kan e-mailen. Door een aangepaste Logwatch filter voor OpenAPS logs te maken, kunt u dagelijks een rapport ontvangen van waarschuwingen, fouten en opmerkelijke gebeurtenissen. Dit stelt u in staat om geïnformeerd te blijven zonder handmatig door honderden regels logininvoer te scrollen. Het rapport kan problemen benadrukken die aandacht nodig hebben, zoals herhaalde communicatiefouten of sensorlekken, en zorgen voor gemoedsrust dat het systeem normaal draait.

Aangepaste Bash of Python Scripts aanmaken

Voor meer gedetailleerde analyse, kunt u schrijven scripts die logbestanden verwerken en grafieken of statistieken genereren. Bijvoorbeeld, een Python script met behulp van kan de insuline levering in de tijd samen met CGM-metingen plotten, waardoor het gemakkelijk om visueel te correleren gebeurtenissen. Scripts kan ook berekeningen berekenen zoals percentage van de tijd besteed in een doelglucose bereik, gemiddeld aantal fouten per dag, of de frequentie van autosens aanpassingen. Door het uitvoeren van deze scripts periodiek en het opslaan van de output, bouw je een historische record dat helpt bijhouden van de prestaties van het systeem en veranderingen in de tijd.

Real-time waarschuwingen instellen

Voor kritieke gebeurtenissen kunnen real-time waarschuwingen worden verzonden via e-mail, sms of messaging platforms zoals Telegram of Slack. Een eenvoudig script dat het logbestand voor nieuwe foutmeldingen of WARN-items controleert, kan een melding veroorzaken wanneer zich een probleem voordoet. Bijvoorbeeld, kunt u [ gebruiken om nieuwe fouten in een meldingsscript te pluggen. Dit zorgt ervoor dat u zich bewust bent van problemen zodra ze gebeuren, in plaats van ze later te ontdekken tijdens een log review. Real-time waarschuwingen zijn vooral waardevol voor kwesties die onmiddellijke actie vereisen, zoals een pomp communicatie storing die kan leiden tot gemiste insuline levering.

Beveiliging en privacyoverwegingen

Logbestanden bevatten zeer gevoelige persoonlijke gezondheidsinformatie, waaronder glucose-metingen, insulinedoses, tijdstempels, en soms locatiegegevens als de rig GPS-loggegevens ingeschakeld heeft. Bescherming van deze gegevens is essentieel om zowel juridische als persoonlijke redenen.

Logs versleutelen in rust en in transit

Wanneer logbestanden worden opgeslagen op de rig, moeten ze worden beschermd door de algemene beveiliging van het apparaat, waaronder sterke wachtwoorden en gecodeerde bestandssystemen. Wanneer u logs via SCP of SFTP overbrengt, wordt de gegevens versleuteld in transit, wat een goede praktijk is. Vermijd het overbrengen van logs over niet-versleutelde protocollen zoals FTP of HTTP. Als u logs archiveert naar een cloudservice of externe schijf, overwegen het versleutelen van het archief met een hulpmiddel als of het gebruik van een versleuteld zip-bestand.

Toegang tot logbestanden beperken

Alleen toegang verlenen tot logbestanden aan mensen die het nodig hebben, zoals de systeemgebruiker en elke vertrouwde verzorgers. Vermijd het delen van ruwe logbestanden met anderen, waaronder op openbare forums, tenzij u alle persoonlijk identificerende informatie hebt verwijderd of geanonimiseerd. Als u logfragmenten moet delen voor hulp bij het oplossen van problemen, zorgvuldig de inhoud bekijken en alle gegevens die u kunnen identificeren, zoals uw naam, exacte locatie, of pomp serienummers.

Beleid inzake bewaring en verwijdering

Stel een duidelijk beleid vast voor hoe lang u logbestanden bijhoudt en hoe ze worden verwijderd wanneer ze niet langer nodig zijn. Hoewel lange termijn logs waardevol zijn voor trendanalyse, vertegenwoordigen ze ook een privacyrisico als het apparaat verloren gaat of gestolen wordt. Regelmatig oude logs verwijderen die niet langer nodig zijn, en ervoor zorgen dat wanneer u een rig ontmantelt, de logbestanden veilig worden gewist. Met behulp van full-disk encryptie op het platform kan gegevens beschermen in geval van diefstal.

Conclusie

OpenAPS logbestanden zijn meer dan een record van gebeurtenissen; ze zijn een venster in de binnenkant van uw geautomatiseerde insulinetoedieningssysteem. Door te leren hoe deze logs te openen, te lezen en te analyseren, krijgt u de mogelijkheid om problemen te diagnosticeren, de prestaties te optimaliseren en uiteindelijk betere glucosecontrole te bereiken. De vaardigheden en technieken die in deze handleiding worden beschreven, helpen u om van reactieve probleemoplossing naar proactief systeembeheer te gaan, zodat uw OpenAPS-platform veilig, betrouwbaar en effectief werkt. Maak log review een regelmatig onderdeel van uw routine, en na verloop van tijd, zult u een intuïtief begrip ontwikkelen van hoe uw systeem zich gedraagt en hoe u het op zijn best kunt laten functioneren.