Oxynote: オープンソースの社内Wikiで、リアルタイムのPostgreSQLクエリチャートを表示します。

2026年10月28日投稿者：Oxynote

関連するオープンソースソフトウェア

Oxynoteは、エンジニアリングチーム向けの新しいオープンソース（Apache-2.0ライセンス）の社内Wikiです。ページには、Prometheus、PostgreSQL、MySQL、またはMariaDBに対して実行されるクエリ結果をリアルタイムで表示するチャートを、説明文とともに配置できます。また、重要なページの変更は、ドラフト、差分表示、承認というプロセスを経て、プルリクエストと同様に行われます。

社内ドキュメントは、問題が発生したときにしか参照されないため、すぐに古くなってしまいます。リアルタイムデータを提供することで、チームが毎日ページを開く理由になり、毎日閲覧されるページは常に最新の状態に保たれます。

PostgreSQLとの連携について：

「ライブメトリクス」ブロックは、PostgreSQLデータベースに対してSQLを実行し、その結果を時系列グラフ、棒グラフ、またはゲージとして表示します。

クエリは、Grafanaで使用されているようなマクロ（例：$__timeFilter、$__timeGroup、$__timeFrom）を使用できるため、既存のダッシュボードのクエリをそのまま利用できます。

Oxynoteは、読み取り専用のデータソースにのみ接続します。具体的には、default_transaction_read_onlyが有効になっているロールまたはデータベース、またはスタンバイレプリカです。すべてのセッションも読み取り専用モードで実行されます。

Oxynoteは、PostgreSQL 18にデータを保存しており、これはオールインワンのDockerイメージに組み込まれています。

一般的な用途としては、レプリケーションの遅延や、実行時間の遅いクエリの件数を、それらに対処するための手順とともに表示する「ランブック」などがあります。これにより、チャートとその説明を合わせて確認することができます。

Oxynoteは、以下の場所から入手できます。

ソースコードとインストール手順

最新リリース