الـ 3 أدوات الرئيسية
١. Sentry
أي exception غير معالَجة (frontend + backend) ترسَل لـ Sentry تلقائياً. الـ DSN في.env. التجميع حسب error type + stack trace. تنبيهات حقيقية فقط — لا spam.
٢. Backend logs
النسخة المحلّية تكتب الـ logs في /tmp/operix-backend.log. مكتبة pino مع مستويات info/warn/error. للمتابعة المباشرة:
tail -f /tmp/operix-backend.log | jq .٣. واجهة الـ Queues
/automation/queues يعرض حالة الـ 4 queues live: waiting، active، delayed، completed، failed. يُحدّث كل 5 ثوانٍ تلقائياً.
نصيحة عمليّة
عند أي شكوى “ما يشتغل” — أول مكان أفحصه:
/automation/queues. لو الـ failed يقفز، فيه مشكلة فعلية. لو waiting يتراكم، الـ worker متوقف.أدوات إضافية
/automation/workflows/[id]→ run history لكل workflow + logs لكل run./monitor→ نظرة عامة على صحة النظام (احصل عليها من السايد بار).- Brain logs (
operix-brain/sessions/*.md) — سجل كل عمل لراشد. - WhatsApp SSE:
/api/whatsapp/sseيبثّ الرسائل الجديدة live.
الـ Metrics
Backend يكشف /api/metrics بصيغة Prometheus (نقاط CPU، memory، queue depth، Prisma query time، إلخ). تستطيع ربطه بـ Grafana لاحقاً.
تنبيه
Sentry الـ free tier يحدّ بـ 5K events/شهر. لو الـ traffic عالي، فعّل
tracesSampleRate أقل من 1.0 في sentry.client.config.ts.