mailwal

Oxynote: an open source internal wiki with live PostgreSQL query charts

Oxynote via PostgreSQL Announce

Oxynote: an open source internal wiki with live PostgreSQL query charts

Oxynote is a new open-source (Apache-2.0) internal wiki for engineering teams. A page can include a chart that runs its own query against Prometheus, PostgreSQL, MySQL, or MariaDB right next to the explanatory text, and changes to important pages go through a draft, a diff, and approval, like a pull request.

Internal docs go stale because people open them only when something breaks. Live data gives the team a reason to open a page every day, and pages read daily stay up to date.

How it works with PostgreSQL:

  • Live Metrics blocks run SQL against your PostgreSQL databases and show the result as a time series, bar chart or gauge.
  • Queries can use Grafana-style macros such as $__timeFilter, $__timeGroup and $__timeFrom, so existing dashboard queries carry over.
  • Oxynote only connects to read-only data sources: a role or database with default_transaction_read_only enabled, or a standby. Every session also runs in read-only mode.
  • Oxynote stores its own data in PostgreSQL 18, which is embedded in the all-in-one Docker image.

A typical use is a runbook that shows replication lag or slow query counts next to the steps for handling them, so the chart and its explanation are reviewed together.

Oxynote is available from:

This email was sent to you from Oxynote. It was delivered on their behalf by the PostgreSQL project. Any questions about the content of the message should be sent to Oxynote.

You were sent this email as a subscriber of the pgsql-announce mailinglist, for the content tag Related Open Source. To unsubscribe from further emails, or change which emails you want to receive, please click the personal unsubscribe link that you can find in the headers of this email, or visit .