pgbadgerp - عبر الإنترنت في السحابة

برنامج:

اسم

pgBadger - تقرير تحليل سجل PostgreSQL سريع

موجز

الاستعمال: pgbadger [خيارات] ملف السجل [...]

محلل سجل PostgreSQL مع تقارير ورسوم بيانية مفصلة بالكامل.

الحجج:

يمكن أن يكون ملف السجل ملف سجل واحد أو قائمة ملفات أو أمر shell
إرجاع قائمة الملفات. إذا كنت تريد تمرير محتوى السجل من stdin
استخدم - كاسم ملف. لاحظ أن الإدخال من stdin لن يعمل مع csvlog.
يمكنك أيضًا استخدام ملف يحتوي على قائمة بملف السجل لتحليلها ، انظر -L
خيار سطر الاوامر.

خيارات:

-a | - متوسط ​​الدقائق: عدد الدقائق لبناء متوسط ​​الرسوم البيانية
الاستفسارات والروابط. الافتراضي 5 دقائق.
-A | - متوسط ​​الدقائق: عدد الدقائق لبناء الرسوم البيانية المدرج التكراري
من الاستفسارات. الافتراضي 60 دقيقة.
-ب | - تاريخ البدء: تاريخ / وقت البدء للبيانات المراد تحليلها في السجل.
-ب | - الرسم البياني الشريطي: استخدم الرسم البياني الشريطي بدلاً من الخط بشكل افتراضي.
-c | --dbclient host: تقرير عن إدخالات لمضيف العميل المحدد فقط.
-C | --nocomment: إزالة التعليقات مثل / * ... * / من الاستعلامات.
-د | - قاعدة بيانات dbname: تقرير فقط عن إدخالات قاعدة البيانات المحددة.
-د | --dns-resolv: يتم استبدال عناوين IP الخاصة بالعميل باسم DNS الخاص بهم.
كن حذرًا من أن هذا يمكن أن يبطئ حقًا pgBadger.
-e | - نهاية التاريخ والوقت: تاريخ / وقت الانتهاء للبيانات المراد تحليلها في السجل.
-f | - نوع السجل: القيم الممكنة: سجل النظام ، syslog2 ، stderr و csv.
الافتراضي: stderr.
-G | --nograph: تعطيل الرسوم البيانية على إخراج HTML. ممكن بشكل افتراضي.
-ح | --مساعدة: إظهار هذه الرسالة والخروج.
-أ | - اسم التعريف: اسم البرنامج المستخدم كمعرف سجل نظام. الافتراضي: postgres
-أنا | - تزايدي: استخدم الوضع التزايدي ، سيتم إنشاء التقارير بواسطة
أيام في دليل منفصل ، يجب تعيين --outdir.
-j | - عدد الوظائف: عدد الوظائف المطلوب تشغيلها في نفس الوقت. الافتراضي هو 1 ،
تعمل كعملية واحدة.
-J | - عدد الوظائف: رقم ملف السجل المراد تحليله بالتوازي. تقصير
هو 1 ، تشغيل كعملية واحدة.
-l | - آخر ملف تم تحليله: السماح بتحليل السجل التزايدي عن طريق تسجيل ملف
آخر تاريخ وخط تحليل. مفيد إذا كنت تريد
لمشاهدة الأخطاء منذ آخر تشغيل أو إذا كنت تريد واحدًا
تقرير يومي مع سجل بالتناوب كل أسبوع.
-L | ملف قائمة ملف السجل: ملف يحتوي على قائمة بملف السجل المطلوب تحليله.
م | --maxlength size: الحد الأقصى لطول الاستعلام ، سيقتصر على
الحجم المعطى. الافتراضي: لا اقتطاع
-م | --لا متعدد الأسطر: لا تجمع بيان متعدد الأسطر لتجنب القمامة
خاصة فيما يتعلق بالأخطاء التي تولد تقريرًا ضخمًا.
-n | - nohighlight: تعطيل تمييز كود SQL.
-N | --اسم التطبيق: تقرير فقط عن الإدخالات لاسم التطبيق المحدد
-o | --outfile filename: تحديد اسم ملف الإخراج. الافتراضي يعتمد
على تنسيق الإخراج: out.html ، out.txt ، out.bin ،
out.json أو out.tsung.
مع تثبيت الوحدة النمطية JSON :: XS ، يمكنك إخراج ملف
بتنسيق JSON أيضًا.
لتفريغ الإخراج إلى استخدام stdout - كاسم ملف.
-O | --outdir path: الدليل الذي يجب حفظ الملف فيه.
-p | سلسلة --prefix: قيمة log_line_prefix المخصصة الخاصة بك كـ
المحددة في ملف postgresql.conf الخاص بك. استخدمه فقط إذا كنت
لا تستخدم إحدى البادئات القياسية المحددة
في وثائق pgBadger ، مثل إذا كان لديك
تتضمن البادئة متغيرات إضافية مثل client ip
أو اسم التطبيق. انظر الأمثلة أدناه.
-P | - no-prettify: تعطيل استعلامات SQL لتجميل المنسق.
-q | - هادئ: لا تطبع أي شيء على stdout ، ولا حتى تقدم
شريط.
-r | - remote-host ip: اضبط المضيف حيث سيتم تنفيذ الأمر cat
ملف السجل البعيد لتحليل الملف المحلي.
-R | - الاحتفاظ N: عدد الأسابيع التي يجب الاحتفاظ بها في الوضع التزايدي. تقصير
إلى 0 ، معطل. يستخدم لضبط عدد الوسادة على
ابق في دليل الإخراج. أقدم الأسابيع والأيام
يتم إزالة الدليل تلقائيًا.
-s | - رقم العينة: عدد عينات الاستعلام المراد تخزينها. الافتراضي: 3.
-S | - select-only: الإبلاغ عن استعلامات SELECT فقط.
-t | - أعلى رقم: عدد الاستعلامات المراد تخزينها / عرضها. الافتراضي: 20.
-T | --title string: قم بتغيير عنوان تقرير صفحة HTML.
-u | --dbuser username: تقرير فقط عن إدخالات المستخدم المحدد.
-U | --استبعاد اسم المستخدم للمستخدم: استبعاد إدخالات المستخدم المحدد من
تقرير.
-v | - الإسهاب: تمكين وضع الإسهاب أو التصحيح. معطل بشكل افتراضي.
-V | - الإصدار: إظهار إصدار pgBadger والخروج.
-w | --وضع المراقبة: الإبلاغ عن الأخطاء فقط مثلما تفعل ساعة السجل.
-x | - التمديد: تنسيق الإخراج. القيم: text أو html أو bin أو json أو
تسونغ. الافتراضي: html
-X | - ملفات إضافية: في الوضع التزايدي تسمح لـ pgbadger بكتابة CSS و
JS في دليل الإخراج كملفات منفصلة.
-z | --zcat exec_path: اضبط المسار الكامل لبرنامج zcat. استخدمه إذا
zcat أو bzcat أو unzip ليس في طريقك.
- عدد الحد المسموح به: ستظهر البيانات الدائرية الأقل من num٪ مجموعًا بدلاً من ذلك.
--exclude-query regex: سيتم استبعاد أي استعلام يطابق regex المحدد
من التقرير. على سبيل المثال: "^ (VACUUM | COMMIT)"
يمكنك استخدام هذا الخيار عدة مرات.
--exclude-file filename: مسار الملف الذي يحتوي على كل regex
استخدم لاستبعاد الاستعلامات من التقرير. regex واحد
في كل سطر.
--include-query regex: أي استعلام لا يتطابق مع regex المحدد
يتم استبعادها من التقرير. يمكنك استخدام هذا
الخيار عدة مرات. على سبيل المثال: "(tbl1 | tbl2)".
--include-file filename: مسار الملف الذي يحتوي على كل regex من
الاستعلامات المراد تضمينها من التقرير. regex واحد
في كل سطر.
- تعطيل - خطأ: لا تنشئ تقرير خطأ.
--تعطيل كل ساعة: لا تقم بإنشاء تقرير كل ساعة.
- نوع التعطيل: لا تنشئ تقريرًا عن الاستعلامات حسب النوع ، قاعدة البيانات
أو مستخدم.
- تعطيل الاستعلام: لا تقم بإنشاء تقارير الاستعلام (أبطأ ، معظم
استفسارات متكررة من قبل المستخدمين ، من خلال قاعدة البيانات ، ...).
--disable-session: لا تقم بإنشاء تقرير الجلسة.
--تعطيل الاتصال: لا تقم بإنشاء تقرير اتصال.
- تعطيل القفل: لا تقم بإنشاء تقرير قفل.
--تعطيل - مؤقت: لا تقم بإنشاء تقرير مؤقت.
- تعطيل - نقطة تفتيش: لا تقم بإنشاء تقرير نقطة تفتيش / نقطة إعادة تشغيل.
- تعطيل - تفريغ تلقائي: لا تقم بإنشاء تقرير فراغ تلقائي.
--charset: تُستخدم لتعيين مجموعة أحرف HTML المراد استخدامها.
الافتراضي: utf-8.
- csv-الفاصل: يستخدم لضبط فاصل مجال CSV ، الافتراضي: ،
- استثناء التعبير المعتاد للوقت: أي طابع زمني يطابق regex المحدد سيكون
مستبعد من التقرير. مثال: "2013-04-12. *"
يمكنك استخدام هذا الخيار عدة مرات.
--استبعاد اسم التطبيق: استبعاد إدخالات لاسم التطبيق المحدد
من التقرير. مثال: "pg_dump".
- استثناء التعبير العادي للسطر: سيبدأ pgbadger في استبعاد أي إدخال سجل
سيطابق التعبير العادي المحدد. يمكن استخدامها بشكل متعدد
مرة.
--إخفاء الهوية: إخفاء جميع العناصر الحرفية في الاستعلامات ، من المفيد إخفاءها
البيانات السرية.
--noreport: منع pgbadger لإنشاء التقارير بشكل تدريجي
واسطة.
- مدة السجل: إجبار pgbadger على ربط إدخالات السجل التي تم إنشاؤها
بواسطة كل من log_duration = on و log_statement = 'all'
--enable-checkum: يستخدم لإضافة مبلغ md5 تحت كل تقرير استعلام.

يمكن لـ pgBadger تحليل ملف سجل بعيد باستخدام اتصال ssh بدون كلمة مرور. استخدم ال
-r أو - remote-host لتعيين عنوان IP للمضيف أو اسم المضيف. هناك أيضًا بعض الميزات الإضافية
خيارات للتحكم الكامل في اتصال ssh.

- مسار ssh-program ssh إلى برنامج ssh المراد استخدامه. الافتراضي: ssh.
--ssh-user اسم مستخدم اتصال اسم تسجيل الدخول. افتراضي لتشغيل المستخدم.
--ssh- مسار ملف الهوية إلى ملف الهوية المراد استخدامه.
--ssh-timeout المهلة الثانية لفشل اتصال ssh. الافتراضي 10 ثوان.
- قائمة خيارات ssh-options لاستخدامها في اتصال ssh.
الخيارات المستخدمة دائمًا:
-o ConnectTimeout = $ ssh_timeout
-o PreferredAuthentications = hostbased، publickey

أمثلة:

pgbadger /var/log/postgresql.log
pgbadger /var/log/postgres.log.2.gz /var/log/postgres.log.1.gz
/var/log/postgres.log
pgbadger / var / log / postgresql / postgresql-2012-05- *
pgbadger --exclude-query = "^ (COPY | COMMIT)" /var/log/postgresql.log
pgbadger -b "2012-06-25 10:56:11" -e "2012-06-25 10:59:11"
/var/log/postgresql.log
القط /var/log/postgres.log | بغبادجر -
# سجل بادئة مع إخراج سجل stderr
perl pgbadger --prefix '٪ t [٪ p]: [٪ l-1] المستخدم =٪ u ، db =٪ d ، التطبيق =٪ a ، العميل =٪ h'
/ pglog / postgresql-2012-08-21 *
perl pgbadger --prefix '٪ m٪ u @٪ d٪ p٪ r٪ a:' /pglog/postgresql.log
# بادئة سطر السجل مع إخراج سجل سجل النظام
perl pgbadger - المستخدم الأساسي =٪ u ، db =٪ d ، العميل =٪ h ، التطبيق =٪ a '
/ pglog / postgresql-2012-08-21 *
# استخدم 8 وحدات المعالجة المركزية (CPUs) الخاصة بي لتحليل ملف 10 جيجابايت الخاص بي بشكل أسرع وأسرع بكثير
بيرل pgbadger -j 8 /pglog/postgresql-9.1-main.log

قم بإنشاء ملف XML لجلسات Tsung باستخدام استعلامات محددة فقط:

perl pgbadger -S -o Session.tsung --prefix '٪ t [٪ p]: [٪ l-1] user =٪ u، db =٪ d' /pglog/postgresql-9.1.log

الإبلاغ عن الأخطاء كل أسبوع بواسطة وظيفة كرون:

30 23 * * 1 / usr / bin / pgbadger -q -w /var/log/postgresql.log -o /var/reports/pg_errors.html

قم بإنشاء تقرير كل أسبوع باستخدام السلوك التدريجي:

0 4 * * 1 / usr / bin / pgbadger -q `find / فار / سجل / -mtime -7 -name "postgresql.log *" `
-o / var / reports / pg_errors-`date +٪ F`.html -l /var/reports/pgbadger_incremental_file.dat

هذا يفترض أنه يتم أيضًا تدوير ملف السجل وتقرير HTML كل أسبوع.

أو أفضل من ذلك ، استخدم التقارير المتزايدة التي تم إنشاؤها تلقائيًا:

0 4 * * * / usr / bin / pgbadger -I -q /var/log/postgresql/postgresql.log.1
-O / var / www / pg_reports /

سيُنشئ تقريرًا يوميًا وأسبوعيًا.

في الوضع التزايدي ، يمكنك أيضًا تحديد عدد الأسبوع المطلوب الاحتفاظ به في التقارير:

/ usr / bin / pgbadger - الاحتفاظ 2 -I -q /var/log/postgresql/postgresql.log.1
-O / var / www / pg_reports /

إذا كان لديك pg_dump في الساعة 23:00 و 13:00 كل يوم لمدة نصف ساعة ، فيمكنك استخدام
pgbadger على النحو التالي لاستبعاد هذه الفترة من التقرير:

pgbadger - استبعاد الوقت "2013-09 -. * (23 | 13):. *" postgresql.log

سيساعد هذا في تجنب وجود عبارات COPY ، كما تم إنشاؤها بواسطة pg_dump ، في أعلى القائمة
من أبطأ الاستفسارات. يمكنك أيضًا استخدام --exclude-appname "pg_dump" لحل هذه المشكلة في
طريقة أبسط.

الوصف

pgBadger هو محلل سجلات PostgreSQL مصمم للسرعة مع تقارير مفصلة بالكامل من
ملف سجل PostgreSQL الخاص بك. إنه نص برل فردي وصغير يتفوق في الأداء على أي نص برمجي آخر
محلل سجل PostgreSQL.

إنه مكتوب بلغة بيرل البحتة ويستخدم مكتبة جافا سكريبت (flotr2) لرسم الرسوم البيانية
حتى لا تحتاج إلى تثبيت أي وحدات Perl إضافية أو حزم أخرى.
علاوة على ذلك ، تمنحنا هذه المكتبة المزيد من الميزات مثل التكبير. يستخدم pgBadger أيضًا ملف
مكتبة Bootstrap javascript وخطوط الويب FontAwesome لتصميم أفضل. كل شيء
مغروس.

يمكن لـ pgBadger الكشف التلقائي عن تنسيق ملف السجل الخاص بك (سجل النظام أو stderr أو csvlog). إنها
مصمم لتحليل ملفات السجل الضخمة وكذلك ملفات gzip المضغوطة. انظر قائمة كاملة من
الميزات أدناه. التنسيقات المضغوطة المدعومة هي gzip و bzip2 و xz. لآخر واحد لك
يجب أن يكون لديك إصدار xz أعلى من 5.05 يدعم خيار الروبوت.

جميع المخططات قابلة للتكبير ويمكن حفظها كصور PNG.

يمكنك أيضًا تقييد pgBadger للإبلاغ عن الأخطاء فقط أو إزالة أي جزء من التقرير باستخدام
خيارات سطر الأوامر.

يدعم pgBadger أي تنسيق مخصص تم تعيينه في التوجيه log_line_prefix الخاص بك
postgresql.conf طالما أنه يحدد على الأقل نمطي٪ t و٪ p.

يسمح pgBadger بمعالجة متوازية على ملف سجل واحد وملفات متعددة من خلال الاستخدام
من الخيار -j وعدد وحدات المعالجة المركزية كقيمة.

إذا كنت تريد حفظ أداء النظام ، يمكنك أيضًا استخدام log_duration بدلاً من
log_min_duration_statement للحصول على تقارير حول المدة وعدد الاستعلامات فقط.

أحدث

تقارير pgBadger كل شيء عن استعلامات SQL الخاصة بك:

إحصاءات عامة
استفسارات الانتظار الأكثر شيوعًا.
الاستفسارات التي انتظرت أكثر من غيرها.
الاستعلامات التي تولد معظم الملفات المؤقتة.
استعلامات توليد أكبر الملفات المؤقتة.
أبطأ الاستفسارات.
الاستعلامات التي استغرقت معظم الوقت.
الاستفسارات الأكثر شيوعًا.
أكثر الأخطاء شيوعًا.
الرسم البياني لأوقات الاستعلام.
رسم بياني لأوقات الجلسات.
المستخدمون المشاركون في أهم الاستعلامات.
التطبيقات المشاركة في أهم الاستفسارات.
الاستعلامات التي تولد أكبر قدر من الإلغاء.
معظم الاستفسارات الملغاة.

التقارير التالية متاحة أيضًا مع الرسوم البيانية لكل ساعة مقسمة على فترات من خمسة
دقائق:

إحصائيات استعلامات SQL.
إحصائيات الملفات المؤقتة.
إحصائيات نقاط التفتيش.
التفريغ التلقائي والتحليل التلقائي للإحصاءات.
الاستفسارات الملغاة.
أحداث الخطأ (ذعر ، فادح ، خطأ وتحذير).

هناك أيضًا بعض التقارير الدائرية حول التوزيع حول:

إحصائيات الأقفال.
الاستعلامات حسب النوع (تحديد / إدراج / تحديث / حذف).
توزيع نوع الاستعلامات لكل قاعدة بيانات / تطبيق
الجلسات لكل قاعدة بيانات / مستخدم / عميل / تطبيق.
اتصالات لكل قاعدة بيانات / مستخدم / عميل / تطبيق.
التفريغ التلقائي والتحليل التلقائي لكل طاولة.
استعلامات لكل مستخدم والمدة الإجمالية لكل مستخدم.

جميع المخططات قابلة للتكبير ويمكن حفظها كصور PNG. ذكرت استعلامات SQL هي
يتم تمييزها وتجميلها تلقائيًا.

يمكنك أيضًا الحصول على تقارير تزايدية بتقرير واحد يوميًا وتقرير تراكمي لكل
أسبوع. يتوفر وضعان متعددان العمليات لتسريع تحليل السجل ، أحدهما يستخدم نواة واحدة لكل
ملف السجل ، والثاني لاستخدام نواة متعددة لتحليل ملف واحد. يمكن أن يكون كلا الوضعين
الجمع بين.

يمكن ضبط دقة الرسم البياني باستخدام خيار سطر الأوامر -A. افتراضيا هم
سيبلغ عن متوسط ​​كل استعلام / خطأ يحدث في الساعة ، ولكن يمكنك تحديد
الدقة حتى الدقيقة.

يمكن أيضًا استخدام pgBadger في مكان مركزي لتحليل ملفات السجل عن بُعد باستخدام كلمة مرور
اتصال أقل من SSH. يمكن استخدام هذا الوضع مع الملفات المضغوطة والعمليات المتعددة في الوضع
لكل ملف (-J) ولكن لا يمكن استخدامه مع تنسيق سجل CSV.

المتطلبات

يأتي pgBadger كبرنامج نصي واحد من لغة Perl - فأنت لا تحتاج إلى أي شيء آخر غير لغة Perl حديثة
توزيع. يتم تقديم المخططات باستخدام مكتبة Javascript بحيث لا تحتاج إلى أي شيء.
متصفحك سوف يقوم بكل العمل

إذا كنت تخطط لتحليل ملفات سجل PostgreSQL CSV ، فقد تحتاج إلى بعض وحدات Perl النمطية:

نص :: CSV_XS - لتحليل ملفات سجل PostgreSQL CSV.

هذه الوحدة اختيارية ، إذا لم يكن لديك سجل PostgreSQL بتنسيق CSV فأنت لست بحاجة إليه
لتثبيته.

إذا كنت ترغب في تصدير الإحصائيات كملف JSON ، فأنت بحاجة إلى وحدة Perl إضافية:

JSON :: XS - تسلسل JSON / إلغاء التسلسل ، يتم بشكل صحيح وسريع

هذه الوحدة اختيارية ، إذا لم تحدد تنسيق إخراج json فلن تحتاج إلى ذلك
قم بتثبيته.

يتم اكتشاف تنسيق ملف السجل المضغوط تلقائيًا من امتداد الملف. إذا وجدت pgBadger gz
الامتداد سيستخدم الأداة المساعدة zcat ، مع امتداد bz2 سيستخدم bzcat وإذا كان الملف
امتداد الملف هو zip أو xz ثم سيتم استخدام المرافقين unzip أو xz.

إذا لم يتم العثور على هذه الأدوات المساعدة في متغير بيئة PATH ، فاستخدم --zcat
خيار سطر الأوامر لتغيير هذا المسار. على سبيل المثال:

--zcat = "/ usr / local / bin / gunzip -c" أو --zcat = "/ usr / local / bin / bzip2 -dc"
--zcat = "C: \ tools \ unzip -p"

بشكل افتراضي ، سيستخدم pgBadger الأدوات المساعدة zcat و bzcat و unzip التي تتبع الملف
امتداد. إذا كنت تستخدم تنسيق ضغط الاكتشاف التلقائي الافتراضي ، فيمكنك خلط gz و bz2 و xz
أو ملفات مضغوطة. سيؤدي تحديد قيمة مخصصة لخيار --zcat إلى إزالة ميزة مختلطة
تنسيق مضغوط.

لاحظ أنه لا يمكن استخدام المعالجة المتعددة مع الملفات المضغوطة أو ملفات CSV أيضًا
ضمن منصة Windows.

تركيب

قم بتنزيل tarball من github وافك ضغط الأرشيف على النحو التالي:

القطران xzf pgbadger-7.x.tar.gz
قرص مضغوط pgbadger-7.x /
بيرل Makefile.PL
جعل && sudo جعل التثبيت

سيؤدي هذا إلى نسخ برنامج Perl النصي pgbadger إلى / usr / local / bin / pgbadger افتراضيًا والرجل
من الصفحة إلى /usr/local/share/man/man1/pgbadger.1. هذه هي التثبيت الافتراضي
الدلائل لتثبيت "الموقع".

إذا كنت ترغب في تثبيت جميع ملفات / usr / location ، استخدم INSTALLDIRS = 'perl' كوسيطة لـ
Makefile.PL. سيتم تثبيت البرنامج النصي في / usr / bin / pgbadger والصفحة في manpage
/usr/share/man/man1/pgbadger.1.

على سبيل المثال ، لتثبيت كل شيء تمامًا كما يفعل دبيان ، تابع ما يلي:

perl Makefile.PL INSTALLDIRS = البائع

بشكل افتراضي ، يتم تعيين INSTALLDIRS على الموقع.

بوستجرسكل CONFIGURATION

يجب عليك تمكين وتعيين بعض توجيهات التكوين في postgresql.conf الخاص بك من قبل
بدء.

يجب عليك أولاً تمكين تسجيل استعلام SQL للحصول على شيء لتحليله:

log_min_duration_statement = 0

هنا سيتم تسجيل كل بيان ، قد ترغب في زيادة هذه القيمة على الخادم المشغول
فقط سجل الاستعلامات ذات المدة الزمنية الأعلى. لاحظ أنه إذا قمت بتعيين log_statement إلى
"الكل" لن يتم تسجيل أي شيء من خلال التوجيه log_min_duration_statement. انظر التالي
الفصل لمزيد من المعلومات.

باستخدام تنسيق سجل "stderr" ، يجب أن يكون log_line_prefix على الأقل:

log_line_prefix = '٪ t [٪ p]: [٪ l-1]'

يمكن أن تضيف بادئة سطر السجل المستخدم واسم قاعدة البيانات واسم التطبيق وعنوان IP للعميل
يتبع:

log_line_prefix = '٪ t [٪ p]: [٪ l-1] المستخدم =٪ u ، db =٪ d ، التطبيق =٪ a ، العميل =٪ h'

أو لتنسيق ملف سجل سجل النظام:

log_line_prefix = 'المستخدم =٪ u ، db =٪ d ، التطبيق =٪ aclient =٪ h'

يمكن أيضًا أن تكون بادئة سطر السجل لإخراج stderr:

log_line_prefix = '٪ t [٪ p]: [٪ l-1] db =٪ d ، المستخدم =٪ u ، التطبيق =٪ a ، العميل =٪ h'

أو لإخراج سجل النظام:

log_line_prefix = 'db =٪ d ، المستخدم =٪ u ، التطبيق =٪ a ، العميل =٪ h'

تحتاج إلى تمكين المعلمات الأخرى في postgresql.conf للحصول على مزيد من المعلومات من ملف
ملفات السجل:

log_checkpoints = تشغيل
log_connections = تشغيل
log_disconnections = تشغيل
log_lock_waits = تشغيل
ملفات_سجل_المؤقت = 0
log_autovacuum_min_duration = 0

لا تقم بتمكين log_statement لأن تنسيق السجل الخاص بهم لن يتم تحليله بواسطة pgBadger.

بالطبع يجب أن تكون رسائل السجل الخاصة بك باللغة الإنجليزية دون دعم اللغة:

lc_messages = 'C'

ولكن هذا ليس فقط موصى به من قبل pgBadger.

ملاحظة: يتم استخدام سطر الجلسة [٪ l-1] فقط لمطابقة البادئة الافتراضية لـ "stderr". ال
-1 ليس له غرض حقيقي ولا يستخدم أساسًا في إحصائيات / رسوم بيانية Pgbadger. أنت تستطيع
قم بإزالتها بأمان من log_line_prefix ولكنك ستحتاج إلى تعيين الأمر --prefix
خيار الخط.

log_min_duration_statement ، log_duration بيان السجل

إذا كنت تريد تقارير إحصائية كاملة ، يجب عليك تعيين log_min_duration_statement إلى 0 أو أكثر
مللي ثانية.

إذا كنت تريد فقط الإبلاغ عن المدة وعدد الاستعلامات ولا تريد كل التفاصيل حول
استعلامات ، اضبط log_min_duration_statement على -1 لتعطيله وتمكين log_duration في
ملف postgresql.conf الخاص بك. إذا كنت ترغب في إضافة تقرير الطلبات الأكثر شيوعًا ، يمكنك ذلك
إما أن تختار تعيين log_min_duration_statement إلى قيمة أعلى أو تختار التمكين
بيان السجل.

سيؤدي تمكين log_min_duration_statement إلى إضافة تقارير حول أبطأ الاستعلامات والاستعلامات
التي استغرقت معظم الوقت. احذر من أنه إذا قمت بتعيين log_statement إلى "الكل" ، فلا شيء
سيتم تسجيل مع log_line_prefix.

موازى معالجة

لتمكين المعالجة المتوازية ، عليك فقط استخدام الخيار -j N حيث N هو الرقم
من النوى التي تريد استخدامها.

سوف يتابع pgbadger بعد ذلك على النحو التالي:

لكل ملف سجل
حجم القطعة = int (حجم الملف / N)
انظر إلى تعويضات البداية / النهاية لهذه القطع
عمليات fork N وتسعى إلى بداية الإزاحة لكل قطعة
سيتم إنهاء كل عملية عندما يصل المحلل اللغوي إلى إزاحة النهاية
من قطعتها
تكتب كل عملية الإحصائيات في ملف مؤقت ثنائي
انتظر حتى يتم إنهاء جميع الأطفال
ستتم قراءة جميع الملفات المؤقتة الثنائية التي تم إنشاؤها وتحميلها بعد ذلك
الذاكرة لبناء الناتج html.

بهذه الطريقة ، في بداية / نهاية القطع ، قد يقوم pgbadger باقتطاع أو حذف N كحد أقصى
الاستعلامات في ملف سجل perl وهو فجوة صغيرة إذا كان لديك ملايين الاستعلامات في ملف
ملف السجل الخاص بك. احتمال أن يكون الاستعلام الذي كنت تبحث عنه غير محكم قريبًا من الصفر ،
هذا هو السبب في أنني أعتقد أن هذه الفجوة قابلة للعيش. في معظم الأحيان يتم حساب الاستعلام مرتين ولكن
مقطوع.

عندما يكون لديك الكثير من ملفات السجل الصغيرة والكثير من وحدات المعالجة المركزية ، يكون من الأسرع تخصيص نواة واحدة
إلى ملف سجل واحد في كل مرة. لتمكين هذا السلوك ، يجب عليك استخدام الخيار -JN بدلاً من ذلك.
مع 200 ملف سجل بحجم 10 ميغا بايت ، يبدأ استخدام الخيار -J في أن يكون مثيرًا للاهتمام حقًا
مع 8 نوى. باستخدام هذه الطريقة ، ستكون على يقين من عدم فقد أي استفسارات في التقارير.

إنه بمثابة اختبار تم إجراؤه على خادم به 8 وحدات معالجة مركزية وملف واحد بسعة 9.5 جيجابايت.

خيار | 1 وحدة المعالجة المركزية | 2 وحدة المعالجة المركزية | 4 وحدة المعالجة المركزية | 8 وحدة المعالجة المركزية
-------- + --------- + ------- + ------- + ------
-j | 1 س 41 د 18 | 50 م 25 | 25 م 39 | 15 م 58
-J | 1 س 41 د 18 | 54 م 28 | 41 م 16 | 34 م 45

مع 200 ملف سجل كل منها 10 ميجابايت و 2 جيجابايت إجمالاً ، تكون النتائج مختلفة قليلاً:

خيار | 1 وحدة المعالجة المركزية | 2 وحدة المعالجة المركزية | 4 وحدة المعالجة المركزية | 8 وحدة المعالجة المركزية
-------- + ------- + ------- + ------- + ------
-j | 20 م 15 | 9 م 56 | 5 م 20 | 4 م 20
-J | 20 م 15 | 9 م 49 | 5 م 00 | 2 م 40

لذلك يوصى باستخدام -j ما لم يكن لديك مئات من ملفات السجل الصغيرة ويمكنك استخدامها في
8 وحدات معالجة مركزية على الأقل.

هام: عند استخدام التحليل المتوازي ، فإن pgbadger سيولد الكثير من المؤقت
الملفات في / تمة الدليل وسيتم إزالتها في النهاية ، لذلك لا تقم بإزالة هذه الملفات
ما لم يكن pgbadger لا يعمل. تم تسميتهم جميعًا بالقالب التالي
tmp_pgbadgerXXXX.bin حتى يمكن التعرف عليها بسهولة.

تدريجي تقارير

تتضمن pgBadger وضع تقرير تزايدي تلقائي باستخدام الخيار -I أو -Incremental.
عند التشغيل في هذا الوضع ، سيُنشئ pgBadger تقريرًا واحدًا يوميًا وتقريرًا تراكميًا
تقرير في الأسبوع. يتم إجراء الإخراج أولاً بتنسيق ثنائي في دليل الإخراج الإلزامي
(راجع الخيار -O أو --outdir) ، ثم بتنسيق HTML للتقارير اليومية والأسبوعية مع رئيسي
ملف الفهرس.

سيعرض ملف الفهرس الرئيسي قائمة منسدلة أسبوعيًا مع رابط لتقرير الأسبوع و
روابط للتقارير اليومية لهذا الأسبوع.

على سبيل المثال ، إذا قمت بتشغيل pgBadger على النحو التالي بناءً على ملف يتم تدويره يوميًا:

0 4 * * * / usr / bin / pgbadger -I -q /var/log/postgresql/postgresql.log.1 \
-O / var / www / pg_reports /

سيكون لديك جميع التقارير اليومية والأسبوعية عن فترة التشغيل الكاملة.

في هذا الوضع ، سيقوم pgBagder بإنشاء ملف تزايد تلقائي في دليل الإخراج ،
لذلك لا يتعين عليك استخدام الخيار -l إلا إذا كنت تريد تغيير مسار هذا الملف.
هذا يعني أنه يمكنك تشغيل pgBadger في هذا الوضع كل يوم على ملف سجل يتم تدويره
في الأسبوع ، لن يتم احتساب إدخالات السجل مرتين.

لتوفير مساحة القرص ، قد ترغب في استخدام خيار سطر الأوامر -X أو --extra-files إلى
إجبار pgBadger على كتابة javascript و css لفصل الملفات في دليل الإخراج. ال
سيتم بعد ذلك تحميل الموارد باستخدام البرنامج النصي وعلامة الارتباط.

الثنائية FORMAT

باستخدام التنسيق الثنائي ، من الممكن إنشاء تزايدي وتراكمي مخصص
التقارير. على سبيل المثال ، إذا كنت تريد تحديث تقرير pgbadger كل ساعة من يومية
ملف سجل PostgreSQl ، يمكنك المتابعة عن طريق تشغيل الأوامر التالية كل ساعة:

pgbadger - آخر تحليل .pgbadger_last_state_file -o الأحد / hourX.bin /var/log/pgsql/postgresql-Sun.log

لإنشاء ملفات البيانات الإضافية بتنسيق ثنائي. ولإنشاء HTML جديد
تقرير من هذا الملف الثنائي:

pgbadger الأحد / *. بن

أو مثال آخر ، إذا كان لديك ملف سجل واحد في الساعة وتريد أن تكون التقارير
إعادة بناء كل مرة يتم فيها تبديل ملف السجل. تابع على النحو التالي:

pgbadger -o day1 / hour01.bin /var/log/pgsql/pglog/postgresql-2012-03-23_10.log
pgbadger -o day1 / hour02.bin /var/log/pgsql/pglog/postgresql-2012-03-23_11.log
pgbadger -o day1 / hour03.bin /var/log/pgsql/pglog/postgresql-2012-03-23_12.log


عندما تريد تحديث تقرير HTML ، على سبيل المثال في كل مرة بعد ملف ثنائي جديد
تم إنشاؤه ، فقط قم بما يلي:

pgbadger -o day1_report.html day1 / *. bin

اضبط الأوامر وفقًا لاحتياجاتك.

JSON FORMAT

يعد تنسيق JSON مفيدًا لمشاركة البيانات مع لغات أخرى ، مما يسهل ذلك
دمج نتيجة pgBadger في أدوات المراقبة الأخرى مثل Cacti أو الجرافيت.

مؤلفون

pgBadger هو عمل أصلي من جيل دارولد.

شعار pgBadger هو ابتكار أصلي لـ Damien Clochard.

يأتي تصميم pgBadger v4.x من شركة "Art is code".

هذا الموقع هو عمل جيل دارولد.

يتم الحفاظ على pgBadger بواسطة Gilles Darold ، والناس الطيبين في Dalibo ، وكل من يريد
للمساهمة.

لقد ساهم العديد من الأشخاص في pgBadger ، وقد تم اقتباسهم جميعًا في ملف Changelog.

استخدم pgbadgerp عبر الإنترنت باستخدام خدمات onworks.net