Разработчики Oxynote представили внутреннюю базу знаний, где инструкция и график из подключённого источника находятся на одной странице. Идея — смотреть на текущие данные вместе с объяснением, что они означают.
На странице Oxynote можно разместить текст инструкции и график, который получает данные из подключённого источника. В анонсе названы PostgreSQL, MySQL, MariaDB и Prometheus. Так описание ситуации находится рядом с её текущими показателями.
Команда представила продукт в публикации от 28 октября. Это сообщение разработчиков в разделе Related Open Source на сайте PostgreSQL. Oxynote — отдельная программа, которую нужно разворачивать.
Например, техническая инструкция может объяснять, что делать при задержке передачи данных между серверами, и рядом показывать саму задержку. Такой пример приводят авторы. При этом график не объясняет происходящее автоматически: содержание инструкции по-прежнему нужно поддерживать.
Блоки Live Metrics выполняют запросы к источникам и показывают результат как временной ряд, столбчатый график или индикатор. Важные изменения страниц проходят через черновик, сравнение версий и согласование. Команда может рассматривать данные и пояснения вместе.
Для PostgreSQL поддерживаются временные подстановки, знакомые пользователям Grafana: они позволяют задавать период запроса. Совместимость существующих запросов и отчётов всё равно нужно проверять.
Полезно заранее определить владельца страницы. Если график изменяется каждый день, а инструкция не обновлялась год, соседство само по себе проблему не решит. Наш подход — подписать источник показателя, его смысл и условия, при которых нужно действовать.
Oxynote подключается только к источникам с доступом на чтение. Для PostgreSQL авторы перечисляют роль или базу с включённым режимом запрета записи либо резервный сервер для чтения. Каждая сессия также работает в режиме чтения. Собственные данные Oxynote хранятся в PostgreSQL 18 внутри общего Docker-образа.
Docker-образ здесь — готовая упаковка программы и нужного окружения для развёртывания. Открытый исходный код не отменяет размещение, настройку доступа и обслуживание.
Доступ только на чтение не означает, что сведения внутри автоматически можно показывать каждому сотруднику. Нужно отдельно определить, какие данные нужны странице и кто вправе их видеть. Устройство базы и пути данных объясняем в разборе серверной части сайта.
Возьмите одну инструкцию, которой команда действительно пользуется, и один понятный показатель. Для учебного опыта подойдут вымышленные данные. Определите, что означает изменение показателя, кто его проверяет и какое действие должно следовать дальше.
До выбора инструмента предлагаем описать страницу четырьмя строками:
Последний пункт особенно важен: пустой график нельзя без проверки принимать за отсутствие событий. Такую приёмку можно включить в техническое задание.
Это предложенный редакцией способ оценки идеи. Рабочие базы компаний мы к Oxynote не подключали. Качество развёртывания и обслуживания требует отдельной проверки.
