الانتقال إلى المحتوى الرئيسي
باختصارراقب مقاييس أداء PostgreSQL في ClickStack باستخدام مستقبِل PostgreSQL في OTel. يتضمن مجموعة بيانات تجريبية ولوحة معلومات مُعدّة مسبقًا.

التكامل مع PostgreSQL الحالي

يتناول هذا القسم كيفية تهيئة تثبيت PostgreSQL الحالي لديك لإرسال المقاييس إلى ClickStack، وذلك عبر تهيئة ClickStack OTel collector باستخدام مستقبِل PostgreSQL. إذا كنت ترغب في اختبار تكامل مقاييس 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

انشر ClickStack باستخدام تهيئة مخصصة

قم بتركيب ملف التهيئة المخصص:
4

تحقّق من جمع المقاييس

بعد إكمال التهيئة، سجّل الدخول إلى HyperDX وتأكد من أن المقاييس تتدفق:
  1. انتقل إلى مستكشف المقاييس
  2. ابحث عن المقاييس التي تبدأ بـ postgresql. (على سبيل المثال: postgresql.backends وpostgresql.commits)
  3. ينبغي أن ترى نقاط بيانات المقاييس تظهر وفقًا لفاصل الجمع الذي قمت بتهيئته
بمجرد بدء تدفق المقاييس، انتقل إلى قسم لوحات المعلومات والتصورات المرئية لاستيراد لوحة المعلومات الجاهزة مسبقًا.

مجموعة البيانات التجريبية

للمستخدمين الذين يريدون اختبار تكامل مقاييس PostgreSQL قبل تهيئة أنظمة الإنتاج الخاصة بهم، نوفر مجموعة بيانات مُولَّدة مسبقًا تتضمن أنماطًا واقعية لمقاييس PostgreSQL.
مقاييس على مستوى قاعدة البيانات فقطتتضمن مجموعة البيانات التجريبية هذه مقاييس على مستوى قاعدة البيانات فقط للحفاظ على خفة بيانات العينة. تُجمَع مقاييس الجداول والفهارس تلقائيًا عند مراقبة قاعدة بيانات PostgreSQL فعلية.
1

تنزيل مجموعة بيانات المقاييس النموذجية

نزّل ملفات المقاييس المُولَّدة مسبقًا (24 ساعة من مقاييس PostgreSQL بأنماط واقعية):
تتضمن مجموعة البيانات أنماطًا واقعية:
  • ارتفاع صباحي في الاتصالات (08:00) - ذروة تسجيل الدخول
  • مشكلة في أداء cache (11:00) - ارتفاع مفاجئ في Blocks_read
  • خلل في التطبيق (14:00-14:30) - ارتفاع معدل التراجع إلى 15%
  • حالات deadlocks (14:15, 16:30) - deadlocks نادرة
2

ابدأ ClickStack

ابدأ instance من ClickStack:
انتظر نحو 30 ثانية حتى يكتمل تشغيل ClickStack بالكامل.
3

حمّل المقاييس إلى ClickStack

حمّل المقاييس مباشرةً إلى ClickHouse:
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 ساعة للحصول على تصورات أوضح.

لوحات المعلومات والمرئيات

لمساعدتك على بدء مراقبة PostgreSQL باستخدام ClickStack، نوفر مرئيات أساسية لمقاييس PostgreSQL.
1

ملف إعداد لوحة المعلومات

2

استورد لوحة المعلومات المُعدّة مسبقًا

  1. افتح HyperDX وانتقل إلى قسم لوحات المعلومات
  2. انقر على استيراد لوحة معلومات في الزاوية العلوية اليمنى من قائمة النقاط الثلاث
  1. ارفع ملف postgres-metrics-dashboard.json وانقر على إنهاء الاستيراد
3

اعرض لوحة المعلومات

ستُنشأ لوحة المعلومات مع إعداد جميع المرئيات مسبقًا:
بالنسبة إلى مجموعة البيانات التجريبية، اضبط النطاق الزمني على 2025-11-10 00:00:00 - 2025-11-11 00:00:00 (UTC) (عدّله وفقًا لمنطقتك الزمنية المحلية). لن تتضمن لوحة المعلومات المستوردة نطاقًا زمنيًا محددًا افتراضيًا.

استكشاف الأخطاء وإصلاحها

تعذّر تحميل التهيئة المخصصة

تحقّق من ضبط متغير البيئة:
تحقّق من تحميل ملف الإعدادات المخصّص:

عدم ظهور أي مقاييس في HyperDX

تحقق من إمكانية الوصول إلى PostgreSQL:
تحقق من سجلات OTel collector:

أخطاء المصادقة

تحقّق من ضبط كلمة المرور بشكل صحيح:
اختبر بيانات الاعتماد مباشرةً:

الخطوات التالية

  • أعدّ التنبيهات للعتبات الحرجة (حدود الاتصالات، ارتفاع معدلات التراجع، انخفاض نسب الإصابة في ذاكرة التخزين المؤقت)
  • فعّل المراقبة على مستوى الاستعلامات باستخدام امتداد pg_stat_statements
  • راقب عدة مثيلات PostgreSQL عبر تكرار إعدادات الـ receiver مع نقاط نهاية وأسماء خدمات مختلفة

الانتقال إلى بيئة الإنتاج

يستند هذا الدليل إلى OTel Collector المضمّن في ClickStack لتوفير إعداد سريع. بالنسبة إلى عمليات النشر في بيئة الإنتاج، نوصي بتشغيل OTel Collector خاص بك وإرسال البيانات إلى نقطة نهاية OTLP الخاصة بـ ClickStack. راجع إرسال بيانات OpenTelemetry للاطّلاع على إعدادات بيئة الإنتاج.
آخر تعديل في ٢٥ يونيو ٢٠٢٦