Oxynote es una nueva wiki interna de código abierto, con licencia Apache-2.0, diseñada para equipos de ingeniería. Permite incorporar gráficos directamente en las páginas, junto al contenido explicativo, mediante consultas que se ejecutan sobre Prometheus, PostgreSQL, MySQL o MariaDB. Además, los cambios en las páginas importantes siguen un proceso de revisión similar al de una pull request, que incluye la creación de un borrador, la comparación de cambios (diff) y su aprobación.

La documentación interna suele quedar desactualizada porque los equipos solo la consultan cuando surge algún problema. Incorporar datos en tiempo real les da un motivo para revisarla a diario, lo que también contribuye a mantener su contenido actualizado.

Cómo funciona con PostgreSQL:

• Los bloques Live Metrics permiten ejecutar consultas SQL en bases de datos PostgreSQL y visualizar los resultados mediante series temporales, gráficos de barras o indicadores de medición.
• Las consultas admiten macros similares a las de Grafana, como $__timeFilter, $__timeGroup y $__timeFrom, lo que facilita reutilizar consultas de paneles de monitoreo existentes.
• Oxynote se conecta únicamente a fuentes de datos de solo lectura, ya sea mediante un rol o una base de datos con el parámetro default_transaction_read_only activado, o a través de un servidor de respaldo en espera (standby). Además, todas las sesiones se ejecutan en modo de solo lectura.
• Para almacenar sus propios datos, Oxynote utiliza PostgreSQL 18, incluido en su imagen Docker todo en uno.

Un ejemplo práctico es un runbook que muestra métricas como el retraso en la replicación o la cantidad de consultas lentas junto con las instrucciones para resolver estos problemas. De esta manera, los gráficos y sus explicaciones pueden revisarse y mantenerse actualizados al mismo tiempo.

Oxynote se encuentra disponible en los siguientes recursos:

• Código fuente e instrucciones de instalación
• Versión más reciente