حين تتعطل خدمة في الإنتاج يبدأ البحث عن سجل يشرح ما حدث ومؤشر ارتفع قبل العطل، ويطول البحث إذا لم تُبنَ المراقبة مسبقًا. تضم هذه الإضافة أمرين لـ Claude Code لبناء تلك الطبقة في مشروعك: الأول يقود Claude عبر عشر مراحل لإعداد المراقبة من المؤشرات والسجلات إلى التنبيهات، والثاني يوجّهه إلى كتابة كود قياس الأداء لتطبيقات Node.js من الخادم إلى المتصفح. الأمران ملفا Markdown، فيمكنك نسخ نصهما يدويًا إلى claude.ai أو Codex، لكن الاستدعاء بالشرطة المائلة خاص بـ Claude Code.
أمر الإعداد: setup-monitoring-observability
قائمة تعليمات من عشر مراحل بلا كود جاهز: تحديد مؤشرات الأداء الرئيسية وأهداف مستوى الخدمة (SLO)، ثم جمع المؤشرات، والسجلات المركزية، والتتبع الموزّع، ومراقبة أداء التطبيق (APM)، ومراقبة الخوادم والحاويات، والتنبيهات، ولوحات العرض، والمراقبة الأمنية، وتنتهي بالاستجابة للحوادث وأتمتة كتيبات التشغيل. وتسمّي خمس مراحل منها أدوات معروفة، مثل Prometheus للمؤشرات، وELK Stack وFluentd للسجلات، وJaeger وZipkin وAWS X-Ray للتتبع، وGrafana وKibana للوحات، وSlack وPagerDuty للتنبيه.
أمر التنفيذ: add-performance-monitoring
ملف يتجاوز ألف سطر، وفي تسع من خطواته العشر كود JavaScript قابل للتكييف:
- APM: إعداد New Relic، وتتبّع Datadog عبر dd-trace مع صنف يغلّف العمليات غير المتزامنة في spans.
- مراقبة المستخدم الحقيقي: قياس Web Vitals في المتصفح، ومكوّن Profiler في React لرصد التصيير البطيء.
- الخادم وقاعدة البيانات: قراءة الذاكرة والمعالج عبر وحدات process وos وv8، وتسجيل استعلامات PostgreSQL التي تتجاوز ثانية عبر مكتبة pg.
- الأخطاء والمقاييس: تهيئة Sentry، ومقاييس Prometheus عبر prom-client، منها مقاييس أعمال مثل عدد التسجيلات وقيمة الطلبات.
- التنبيه والاختبار: مدير تنبيهات يرسل إلى Slack، وإلى البريد في الحالات الحرجة، ومراقبة لاختبارات الحمل تقارنها بقياس أساسي.
- التوصيات: محلّل يمنح التطبيق درجة من A إلى F ويرتّب التوصيات حسب الأولوية.
مثال من الملف: طلبات Express البطيئة
في مشروع Express، يضم الأمر ملف performance-middleware.js، وهو وسيط يسجّل في Prometheus مقياسين: http_request_duration_seconds لمدة كل طلب، وhttp_requests_total لعدد الطلبات، مصنّفين حسب الطريقة والمسار ورمز الحالة، ويكتب تحذيرًا لكل طلب يتجاوز ثانية. وفي الخطوة العاشرة يرفع المحلّل توصيات متوسطة الأولوية إذا تجاوز متوسط زمن الاستجابة 1000 ملّي ثانية، منها مراجعة استعلامات N+1، وعالية الأولوية فوق 3000، منها طبقة تخزين مؤقت.
التشغيل
- فك ضغط الملف في مجلد ثابت، ثم افتح الطرفية في مجلد مشروعك وشغّل:
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسار فك الضغط الفعلي. هذا تحميل للجلسة الحالية فقط، لا تثبيت دائم. - اكتب /commands-monitoring-observability:setup-monitoring-observability للإعداد، أو /commands-monitoring-observability:add-performance-monitoring للتنفيذ.
- لا يطلب أي من الأمرين مدخلات محددة، فاذكر في المحادثة لغة مشروعك وخدماته وأدوات المراقبة التي تملكها ليبني Claude عليها.
قبل أن تعتمد الكود
- يلزمك Claude Code مثبتًا ومسجّل الدخول، وتكلفة تشغيل النموذج على حسابك.
- كود الأمر الثاني مكتوب لـ Node.js والمتصفح؛ في مشروع بلغة أخرى ستفيدك الخطوات أكثر من الكود نفسه.
- New Relic وDatadog وSentry خدمات خارجية تحتاج حسابًا ومفاتيح خاصة بك، مثل المتغير NEW_RELIC_LICENSE_KEY.
- الكود قوالب بأسماء عامة مثل my-application، وبعضه مكتوب لإصدارات أقدم من مكتباته: مقتطف Web Vitals يستورد getCLS وgetFID بينما تستخدم الإصدارات الحالية دوالًا مثل onCLS وonINP، ومدير التنبيهات يستدعي nodemailer.createTransporter واسم الدالة في المكتبة createTransport. راجع كل ملف قبل دمجه.
- الملفات الأصلية بالإنجليزية، وأرفقتُ معها دليلًا عربيًا وفهرسًا للمكونات.
الترخيص
الأمران من مجتمع BuildWithClaude في مستودع davepoon/buildwithclaude بترخيص MIT، ونقلتُ ملفاتهما ونص ترخيصهما كما هي دون تعديل.
