Oxynote: ویکی مهندسی که به متریک و لاگ وصله
خلاصهٔ کاملتر
Oxynote یه فضای کاری متنباز با لایسنس Apache-2.0 برای مستندات مهندسیه. حرف اصلی سازندههاش اینه که ویکی باید به همون سیستمهایی که توضیح میده وصل باشه. یعنی معماری، مستندات API، مراحل on-call و چکلیست ریلیز تو یه درخت صفحه هستن و کنارشون متریک و لاگ زنده نمایش داده میشه.
صفحهها میتونن از Prometheus، Loki (سیستم جمعآوری لاگ Grafana) و دیتابیسهای PostgreSQL، Supabase، MySQL و MariaDB کوئری بزنن. وقتی کوئری PromQL یا SQL مینویسی، نمودار همون لحظه دوباره کشیده میشه. ماکروهای Grafana مثل $__rate_interval و $__timeFilter هم کار میکنن، پس کوئریهای قبلیت معمولاً با یه paste منتقل میشن. برای منابع SQL هم یوزر فقطخواندنی لازمه تا صفحه هیچوقت دادهها رو تغییر نده.
بلوک لاگ هر سطح شدت رو با یه رنگ نشون میده و بالاش یه نوار حجم لاگ داره که جهشهای ناگهانی رو معلوم میکنه. با یه کلیک روی یه فیلد میشه فقط لاگهای با همون مقدار رو نگه داشت یا قایمشون کرد. متغیرها مثل $metric_range یه بار برای کل workspace تعریف میشن، ولی مقدارشون برای هر نفر شخصیه.
برای صفحههای حساس یه چیزی شبیه pull request هست: وقتی صفحه reviewable بشه، شاخهی اصلی دیگه ویرایش مستقیم قبول نمیکنه و تغییرات میرن تو یه draft. diff هم بلوکها رو میفهمه، یعنی مثلاً عوض شدن اسم یه پارامتر API یا آستانهی یه نمودار درست سر جاش قرمز و سبز نشون داده میشه. تأیید و merge دو مرحلهی جدان، پس میشه draft تأییدشده رو نگه داشت تا تغییر واقعی دیپلوی بشه.
ایجنتهایی مثل Claude Code و Codex از طریق MCP (پروتکلی که ابزارها رو به مدلهای هوش مصنوعی وصل میکنه) صفحهها رو بهشکل بلوکهای ساختیافته میخونن و فقط بلوکهای لازم رو عوض میکنن. روی صفحههای reviewable ویرایشهاشون تا تأیید یه آدم تو draft میمونه. دستیار داخلیش هم اسمش Rubber Duck هست و هر مدلی بخوای رو میشه بهش داد. هوش مصنوعی و سرور MCP هر دو اختیاریان و بهصورت پیشفرض خاموشن.
سازندهها میگن هدف اینه که کسی که وسط یه incident تنها مونده، توضیح، متریک، لاگ و دستورهای رفع مشکل رو یه جا داشته باشه. فعلاً بهصورت یه کانتینر Docker روی سرور خودت اجرا میشه، نسخهی ابری در برنامهست و trace و alerting هم در حال توسعهن. نسخهی self-hosted محدودیت تعداد عضو نداره.
نکات کلیدی:
- متنباز با لایسنس Apache-2.0 و اجرا بهصورت یه کانتینر روی سرور خودت
- پشتیبانی از Prometheus، Loki، PostgreSQL، Supabase، MySQL و MariaDB
- ماکروهای Grafana مثل $__rate_interval داخل کوئریها کار میکنن
- صفحههای reviewable فقط با draft و تأیید تغییر میکنن و diff بلوکی دارن
- اتصال ایجنتها با MCP اختیاریه؛ trace و alerting هنوز در دست توسعهست




