Table of Contents

Cómo acceder y utilizar archivos de registro de OpenAPS para la solución de problemas y la optimización

OpenAPS (Open Artificial Pancreas System) es un sistema de páncreas artificial de código abierto que automatiza la entrega de insulina para personas con diabetes. El sistema funciona en pequeñas computadoras como Raspberry Pi o Intel Edison, procesando datos de monitor de glucosa continuo (CGM) y controlando una bomba de insulina en tiempo real. Mientras que OpenAPS está diseñado para operar de forma fiable, ningún sistema es perfecto.

Esta guía proporciona una mirada profunda y práctica a los registros de OpenAPS: cómo acceder a ellos, lo que cada sección significa, cómo utilizarlos para depurar problemas comunes, y cómo aprovechar los datos de registro para ajustar su sistema para obtener mejores resultados de glucosa. Ya sea que usted es un nuevo usuario que establece su primera plataforma o un constructor experimentado que busca exprimir mejor rendimiento, entender los registros es una habilidad que le servirá bien.

Acceso a archivos de registro de OpenAPS

Antes de que pueda analizar los registros, necesita llegar a ellos. OpenAPS almacena archivos de registro en el dispositivo que ejecuta el sistema, típicamente un Raspberry Pi que ejecuta Raspbian o un sistema operativo similar basado en Linux. El acceso requiere conectarse a ese dispositivo, ya sea local o por encima de la red.

SSH: El método de acceso remoto primario

Secure Shell (SSH) es la forma más común y práctica de acceder a los registros OpenAPS. Con SSH activado en su plataforma, puede conectarse desde cualquier ordenador de la misma red utilizando un cliente terminal. En Windows, los clientes populares incluyen PuTTY y la Terminal de Windows; en macOS y Linux, el comando incorporado funciona directamente. Una vez conectado con la dirección IP de su plataforma y las credenciales, tiene acceso completo

Acceso directo a consola

Si su plataforma es físicamente accesible y SSH no está disponible o no está funcionando, puede conectar un monitor y un teclado directamente al dispositivo. Este método es útil para la configuración inicial o cuando los problemas de red impiden el acceso remoto. Los mismos archivos de registro están disponibles desde la consola, y puede utilizar comandos Linux estándar para navegar y leerlos.

Transferir Logs con SCP y SFTP

Para un análisis detallado en un ordenador de escritorio, puede copiar archivos de registro usando SCP (Secure Copy) o SFTP (Protocolo de Transferencia de Archivos SSH). Estas herramientas le permiten descargar directorios de registro completos o archivos específicos a su máquina local. Por ejemplo, el comando copia el archivo principal de registro a su directorio actual. Los clientes SFTP como FileZilla proporcionan una interfaz gráfica para las transferencias de arrastrar y soltar, que pueden ser más convenientes.

Log File Locations y directorio Estructura

Por defecto, OpenAPS almacena archivos de registro en el directorio . El archivo de registro primario es , que registra los principales eventos del sistema, lecturas de sensores, decisiones de dosificación de insulina y errores. Además, puede encontrar subdirectorios o archivos de registro adicionales para componentes específicos:

  • – El registro del sistema principal, que contiene todos los eventos centrales.
  • – Logs from the oref0 algoritmo, que maneja la lógica de toma de decisiones.
  • – Registros de comunicación específicos de bombas, incluyendo comandos enviados y respuestas recibidas.
  • – Datos de CGM crudos y eventos de calibración.
  • – Logs from the autosensitivity detection module, which ajustas basal rates based on observed patterns.

Algunas configuraciones también pueden rotar registros automáticamente, creando archivos comprimidos como . Estos contienen entradas más antiguas y pueden descomprimirse con para su revisión. Entender el diseño del directorio le ayuda a ir directamente a la fuente de un problema específico en lugar de buscar a través de un único archivo monolítico.

Comprender la estructura de los registros de OpenAPS

Los archivos de registro de OpenAPS son archivos de texto simples con entradas de timetamped. Cada línea comienza normalmente con una fecha y hora en formato ISO 8601, seguido de un nivel de gravedad (INFO, WARN, ERROR, DEBUG), y luego un mensaje detallado que describe el evento. El nivel de detalle depende de la verbosidad de registro configurada, que se puede ajustar en la configuración del sistema.

Horarios y Zonas Horarias

Cada entrada de registro incluye un timetamp preciso. Es crítico que el reloj de su plataforma sea preciso y se ajuste a la zona horaria correcta. Los sellos de tiempo inconsecuentes pueden dificultar la correlación de eventos con tendencias de glucosa reales o acciones de usuario. Protocolo de tiempo de red (NTP) debe estar habilitado para mantener el reloj sincronizado automáticamente. Al revisar los registros, siempre tenga en cuenta la zona horaria utilizada, especialmente si está comparando datos de registro con otro dispositivo de datos de teléfono.

Niveles de Severidad y lo que significan

  • INFO: Mensajes operativos normales. Estas lecturas de sensores de registro, dosis de insulina y decisiones de algoritmos de rutina. Los mensajes INFO son los más comunes y ayudan a entender lo que el sistema está haciendo en cualquier momento dado.
  • WARN: Las advertencias indican posibles problemas que no causaron un fracaso, pero que pueden necesitar atención. Ejemplos incluyen una lectura de sensores que está ligeramente fuera del rango esperado, una comunicación de bomba que requería una reentrada o una calibración que se saltó debido a datos insuficientes.
  • ERROR: Los errores representan fallos que impidieron que el sistema completara una acción. Los errores comunes incluyen fallos de comunicación de bombas, desconexiones de sensores o timeouts de algoritmo. Los errores deben ser investigados con prontitud, ya que pueden conducir a dosis de insulina o decisiones de dosificación incorrectas.
  • ]DEBUG: Los mensajes de depuración son muy detallados y normalmente sólo se activan cuando se resuelve un problema específico. Pueden producir un gran volumen de datos y pueden contener detalles de bajo nivel que no son necesarios para la revisión de rutina.

Rotación de registro y retención

Para evitar que los archivos de registro consuman todo el espacio disponible de disco, OpenAPS normalmente implementa la rotación de registro. Los archivos de registro más antiguos se comprimen y eventualmente se eliminan después de un número configurable de rotaciones. Por defecto, los registros pueden ser mantenidos durante 7 a 30 días, dependiendo de la configuración. Si necesita retener registros durante períodos más largos para el análisis de tendencias o la auditoría, puede ajustar la configuración

Interpretación de los principales eventos de registro

Saber qué buscar en los registros convierte los datos brutos en información factible. Aquí están los tipos de eventos más importantes y cómo interpretarlos.

Datos de sensor y calibraciones

Las lecturas de CGM son la base de la toma de decisiones de OpenAPS. Las entradas de registro para datos de sensores incluyen el valor de glucosa, el tiempo que se registró, y cualquier información de calibración. Una entrada típica parece: . Los eventos de calibración también se registran, mostrando cuando se introdujo un valor de dedo y cómo el sistema ajusta sus lecturas de sensores en consecuencia.

Eventos de entrega de insulina

Cada dosis de insulina se registra, incluyendo los bolos, las tasas basales temporales y la entrega basal programada. Las entradas incluyen el tipo de entrega, la cantidad en unidades y la duración de las tasas temporales. Por ejemplo: o . Al hacer referencia cruzada a estas entradas con tendencias de glucosa, puede evaluar si el sistema está respondiendo apropiadamente a altas y bajas secuencias.

Decisiones sobre Algoritm

El algoritmo oref0 toma decisiones sobre ajustes basales, recomendaciones de pernos y alertas altas/bajo basadas en niveles de glucosa actuales y predichos. Estas decisiones se registran con texto explicativo que revela el razonamiento detrás de cada acción. Por ejemplo: . Leer estas entradas le ayuda a entender si las predicciones del sistema se alinean con los resultados reales.

Mensajes de error y alerta

Los errores de comunicación de bombas son los más comunes, a menudo aparecen como: o . Estos pueden ser causados por interferencias de radio, batería de baja bomba o distancia física entre la plataforma y la bomba. Los errores de sensor, como , indican una pérdida de conexión CGM que puede conducir a la entrega automatizada.

Solución de problemas con archivos de registro

Los archivos de registro son la herramienta principal para diagnosticar problemas en un sistema OpenAPS. Un enfoque sistemático para el análisis de registros puede identificar rápidamente la causa raíz de los problemas más comunes.

Proceso de solución de problemas paso a paso

  1. Identificar el marco de tiempo del problema. Si notaste un problema en un momento específico, comienza por tirar de las entradas de registro de alrededor de ese período. Use con un patrón de temporización para reducir la búsqueda.
  2. Buscar entradas de ERROR y WARN. Usar para extraer todas las advertencias y errores. Estos son los indicadores más probables de un problema.
  3. Verifique los datos faltantes. Busque las lagunas en las lecturas de sensores o las entregas de insulina. Una brecha de más de 5-10 minutos en los datos de sensores, o una entrada de registro por hora desaparecida para el estado de la bomba, puede indicar un fallo de comunicación.
  4. Correlato con CGM y historial de bombas. Compare las entradas de registro con el historial de traza CGM real y la bomba de su bomba de insulina. Discrepancias entre lo que informa el registro y lo que muestra la bomba pueden indicar un registro que está fuera de sincronización, o un comando que fue enviado pero no ejecutado.
  5. Revisar las decisiones de algoritmos. Para los problemas con el control de la glucosa, examine las predicciones del algoritmo y los ajustes de insulina resultantes. Busque patrones donde el sistema constantemente se superpone o se equivoca.
  6. Comprobar errores de configuración. Los errores que ocurren inmediatamente después de un cambio de configuración son causados a menudo por ajustes incorrectos en las preferencias o perfil de la bomba. Revisar el registro alrededor del tiempo del cambio para ver si un parámetro específico activa el problema.

Problemas comunes y sus firmas de registro

Dosis de insulina misegada: Busque secuencias donde se solicitó un perno o basal temp pero nunca se confirmó. El registro puede mostrar seguido por sin una posterior entrada de confirmación. En tales casos, la dosis no fue entregada, y el sistema puede no volver a entrar automáticamente. Usted debe verificar la historia de la bomba y entregar manualmente la dosis.

]Hizoblajes de datos del sensor: Si el CGM deja de transmitir, el registro mostrará seguido de la gravedad creciente a medida que la brecha se prolonga. Esto puede ser causado por un sensor muerto, un transmisor desconectado o interferencia de radio. Revise el estado del sensor y el transmisor, y reemplace el sensor si es necesario.

]Función de la comunicación: Repetidas entradas sugieren un problema físico o radio. Mueva la plataforma más cerca de la bomba, sustitúyase las baterías de la bomba, o compruebe fuentes de interferencia como otros dispositivos inalámbricos. El registro mostrará el número de intentos de reingreso, y si todas las retries fallan, el sistema puede entrar en un modo de seguridad.

Autosens anula: Si observa que el sistema proporciona más o menos insulina de lo esperado, compruebe los registros de autosensibilidad. Un indica que el sistema ha detectado un patrón de mayor sensibilidad y está ajustando las tasas basales en consecuencia. Si la relación parece extrema o no coincide con sus observaciones, es posible que necesite ajustar los ajustes de datos más consistentes o proporcionar.

Optimización de su sistema OpenAPS utilizando datos de registro

Más allá de la solución de problemas, los archivos de registro proporcionan los datos históricos necesarios para ajustar su sistema para un mejor control de glucosa. Al revisar los registros regularmente, puede identificar patrones y hacer ajustes informados.

Precios de base de ajuste fino y perfiles de Bolus

Comparando los resultados esperados versus la glucosa real después de las comidas y la noche a la mañana puede revelar si sus tasas basales y perfiles de pernos necesitan ajuste. Si usted ve un patrón de altos después de las comidas, verifique el registro para ver si las recomendaciones del perno del sistema se igualaron lo que se entregó realmente. Busque entradas como y luego verifique que la bomba entregó esa cantidad.

Optimización de calibración

Las calibraciones frecuentes o erráticas pueden degradar el rendimiento del sistema. Revisar las entradas de registro para los eventos de calibración y observar los valores y los tiempos. Si ves calibraciones que se rechazan o que causan ajustes de sensores grandes, considera calibrar en tiempos más estables, como cuando la glucosa no está aumentando o cayendo rápidamente. El registro puede ayudar a identificar los mejores tiempos para calibrar el sensor específico y la química del cuerpo.

Ajuste de los puntos de alerta

OpenAPS le permite configurar alertas para la glucosa alta y baja, datos perdidos y errores del sistema. Al revisar los registros, puede ver con qué frecuencia se habrían disparado estas alertas y si los umbrales se establecen adecuadamente. Si usted está recibiendo demasiadas falsas alarmas, el registro puede ayudarle a identificar las condiciones que los desencadenan, permitiendo que ajuste los umbrales para reducir el ruido sin comprometer el umbral de seguridad.

Análisis de la actuación a largo plazo

Los registros de archivo durante semanas o meses permiten un análisis de tendencia a largo plazo. Puede seguir métricas como tiempo-en-range, promedio de glucosa, cambios de sensibilidad de insulina y fiabilidad del sistema. Herramientas como o scripts Python personalizados pueden analizar archivos de registro y generar informes de resumen. Comparando registros a través de temporadas o cambios de estilo de vida, puede ver cómo su sistema se adapta y hacer ajustes proactivos antes de problemas.

Análisis y monitoreo de registros automatizados

La lectura manual de archivos de registro todos los días no es práctica. Afortunadamente, hay varias maneras de automatizar el monitoreo y alerta de registro.

Configuración de la vigilancia de registro o herramientas similares

Logwatch es una herramienta de análisis de registros que se puede configurar para ejecutar diariamente y enviar un resumen de eventos importantes. Al crear un filtro de registro personalizado para los registros OpenAPS, puede recibir un informe diario de advertencias, errores y eventos notables. Esto le permite mantenerse informado sin desplazarse manualmente a través de cientos de líneas de entradas de registro. El informe puede destacar cuestiones que requieren atención, tales como errores de comunicación repetidos o brechas de sensores, y proporcionar la tranquilidad de funcionamiento.

Creando scripts Bash o Python personalizados

Para un análisis más detallado, puede escribir scripts que analizan archivos de registro y generan gráficos o estadísticas. Por ejemplo, un script Python usando puede trazar la entrega de insulina con el tiempo junto con las lecturas CGM, lo que facilita correlacionar los eventos. Los scripts también pueden calcular las métricas como porcentaje de tiempo gastado en un rango de salida de glucosa objetivo, número promedio de errores por día, o el registro de secuencias periódicamente.

Configuración de alertas en tiempo real

Para eventos críticos, las alertas en tiempo real pueden enviarse por correo electrónico, SMS o plataformas de mensajería como Telegram o Slack. Un script simple que monitoriza el archivo de registro para nuevas entradas de ERROR o WARN puede activar una notificación cuando se produce un problema. Por ejemplo, puede utilizar para introducir nuevos errores en un script de notificación. Esto asegura que usted es consciente de problemas tan pronto como se producen, en el caso de la comunicación.

Consideraciones de seguridad y privacidad

Los archivos de registro contienen información de salud personal altamente sensible, incluyendo lecturas de glucosa, dosis de insulina, timetamps, y a veces datos de ubicación si la plataforma tiene habilitado la registro de GPS. Proteger estos datos es esencial tanto para razones legales como personales.

Registros cifrados en el descanso y en el tránsito

Cuando los archivos de registro se almacenan en la plataforma, deben estar protegidos por la seguridad general del dispositivo, incluyendo contraseñas fuertes y sistemas de archivos cifrados. Al transferir los registros a través de SCP o SFTP, los datos se cifran en tránsito, que es buena práctica. Evite transferir registros a protocolos no cifrados como FTP o HTTP. Si archiva registros a un servicio de nube o unidad externa, considere la posibilidad de cifrar el archivo

Limitar el acceso a los archivos de registro

Sólo concede acceso a los archivos de registro a personas que lo necesitan, como el usuario del sistema y cualquier cuidador de confianza. Evite compartir archivos de registro crudo con otros, incluso en foros públicos, a menos que haya eliminado o anónimo toda la información de identificación personal. Si necesita compartir extractos de registro para ayudar a solucionar problemas, revise cuidadosamente el contenido y retire cualquier dato que pueda identificarle, como su nombre, ubicación exacta o bombee números de serie.

Políticas de retención y eliminación

Establezca una política clara para cuánto tiempo guarda archivos de registro y cómo se eliminan cuando ya no es necesario. Mientras que los registros a largo plazo son valiosos para el análisis de tendencias, también representan un riesgo de privacidad si el dispositivo se pierde o se roba. Procesan regularmente registros antiguos que ya no son necesarios, y aseguren que cuando descomponga una plataforma, los archivos de registro se limpian con seguridad.

Conclusión

Los archivos de registro de OpenAPS son más que un registro de eventos; son una ventana en los trabajos internos de su sistema de entrega automatizado de insulina. Al aprender a acceder, leer y analizar estos registros, usted obtiene la capacidad de diagnosticar problemas, optimizar el rendimiento y finalmente lograr un mejor control de glucosa. Las habilidades y técnicas descritas en esta guía le ayudarán a pasar de la solución reactiva a la gestión del sistema proactiva, asegurando que su funcionamiento de forma segura de su sistema.