باختصارراقب مقاييس أداء PostgreSQL في ClickStack باستخدام مستقبِل PostgreSQL في OTel. يتضمن مجموعة بيانات تجريبية ولوحة معلومات مُعدّة مسبقًا.
التكامل مع PostgreSQL الحالي
المتطلبات الأساسية
- مثيل ClickStack قيد التشغيل
- تثبيت PostgreSQL حالي (الإصدار 9.6 أو أحدث)
- إتاحة الوصول عبر الشبكة من ClickStack إلى PostgreSQL (المنفذ الافتراضي 5432)
- مستخدم مراقبة في PostgreSQL لديه الأذونات المناسبة
1
تأكد من أن مستخدم المراقبة لديه الأذونات المطلوبة
يتطلب مستقبِل PostgreSQL مستخدمًا لديه إذن قراءة على طرق عرض الإحصاءات. امنح دورpg_monitor لمستخدم المراقبة لديك:2
أنشئ تهيئة مخصصة لـ OTel collector
يتيح لك ClickStack توسيع تهيئة OpenTelemetry collector الأساسية من خلال تركيب ملف تهيئة مخصص وتعيين متغير بيئة.أنشئpostgres-metrics.yaml:يعطّل الإعداد
tls: insecure: true التحقق من SSL لأغراض التطوير/الاختبار. إذا كنت تستخدم PostgreSQL في بيئة الإنتاج مع تمكين SSL، فأزل هذا السطر أو اضبط الشهادات المناسبة.3
4
تحقّق من جمع المقاييس
بعد إكمال التهيئة، سجّل الدخول إلى HyperDX وتأكد من أن المقاييس تتدفق:- انتقل إلى مستكشف المقاييس
- ابحث عن المقاييس التي تبدأ بـ postgresql. (على سبيل المثال: postgresql.backends وpostgresql.commits)
- ينبغي أن ترى نقاط بيانات المقاييس تظهر وفقًا لفاصل الجمع الذي قمت بتهيئته
مجموعة البيانات التجريبية
مقاييس على مستوى قاعدة البيانات فقطتتضمن مجموعة البيانات التجريبية هذه مقاييس على مستوى قاعدة البيانات فقط للحفاظ على خفة بيانات العينة. تُجمَع مقاييس الجداول والفهارس تلقائيًا عند مراقبة قاعدة بيانات PostgreSQL فعلية.
1
تنزيل مجموعة بيانات المقاييس النموذجية
نزّل ملفات المقاييس المُولَّدة مسبقًا (24 ساعة من مقاييس PostgreSQL بأنماط واقعية):- ارتفاع صباحي في الاتصالات (08:00) - ذروة تسجيل الدخول
- مشكلة في أداء cache (11:00) - ارتفاع مفاجئ في Blocks_read
- خلل في التطبيق (14:00-14:30) - ارتفاع معدل التراجع إلى 15%
- حالات deadlocks (14:15, 16:30) - deadlocks نادرة
2
3
4
تحقّق من المقاييس في HyperDX
بعد تحميلها، فإن أسرع طريقة لعرض مقاييسك هي من خلال لوحة المعلومات الجاهزة مسبقًا.انتقل إلى قسم لوحات المعلومات والتصورات لاستيراد لوحة المعلومات وعرض العديد من مقاييس PostgreSQL دفعةً واحدة.عرض المنطقة الزمنيةيعرض HyperDX الطوابع الزمنية وفقًا للمنطقة الزمنية المحلية في متصفحك. تغطي البيانات التجريبية الفترة 2025-11-10 00:00:00 - 2025-11-11 00:00:00 (UTC). اضبط النطاق الزمني على 2025-11-09 00:00:00 - 2025-11-12 00:00:00 لضمان ظهور المقاييس التجريبية بغض النظر عن موقعك. وبعد أن ترى المقاييس، يمكنك تضييق النطاق إلى فترة 24 ساعة للحصول على تصورات أوضح.
لوحات المعلومات والمرئيات
1
ملف إعداد لوحة المعلومات
2
استورد لوحة المعلومات المُعدّة مسبقًا
- افتح HyperDX وانتقل إلى قسم لوحات المعلومات
- انقر على استيراد لوحة معلومات في الزاوية العلوية اليمنى من قائمة النقاط الثلاث
- ارفع ملف
postgres-metrics-dashboard.jsonوانقر على إنهاء الاستيراد
3
اعرض لوحة المعلومات
ستُنشأ لوحة المعلومات مع إعداد جميع المرئيات مسبقًا:بالنسبة إلى مجموعة البيانات التجريبية، اضبط النطاق الزمني على 2025-11-10 00:00:00 - 2025-11-11 00:00:00 (UTC) (عدّله وفقًا لمنطقتك الزمنية المحلية). لن تتضمن لوحة المعلومات المستوردة نطاقًا زمنيًا محددًا افتراضيًا.
استكشاف الأخطاء وإصلاحها
تعذّر تحميل التهيئة المخصصة
عدم ظهور أي مقاييس في HyperDX
أخطاء المصادقة
الخطوات التالية
- أعدّ التنبيهات للعتبات الحرجة (حدود الاتصالات، ارتفاع معدلات التراجع، انخفاض نسب الإصابة في ذاكرة التخزين المؤقت)
- فعّل المراقبة على مستوى الاستعلامات باستخدام امتداد
pg_stat_statements - راقب عدة مثيلات PostgreSQL عبر تكرار إعدادات الـ receiver مع نقاط نهاية وأسماء خدمات مختلفة