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

برنامج:

اسم

com.dbpmda - مصحح أخطاء PMDAs Co-Pilot للأداء

موجز

com.dbpmda [-اي] [-n pmns ملف] [-q مهلة] [-U اسم المستخدم]

الوصف

com.dbpmda هي واجهة تفاعلية للتفاعلات بين مجال قياس الأداء
عامل (PMDA(3)) وبرنامج تجميع مقاييس الأداء (com.pmcd(1)). هذا يسمح PMDAs
ليتم إرفاقها وتهيئتها وممارستها لاختبار صحتها.

com.dbpmda يطالب المستخدم بشكل تفاعلي بالأوامر ، والتي يحاكي العديد منها البروتوكول
وحدات البيانات (PDUs) التي يمكن إرسالها بواسطة أ com.pmcd(1) عملية. بعد تشغيل com.dbpmda، دخول
أمر مساعدة للحصول على قائمة بالأوامر المتاحة. قسم المثال أدناه
يوضح جلسة باستخدام com.dbpmda لاختبار PMDA.

لتبسيط الاختبار المتكرر لملف PMDA .dbpmdarc في العمل الحالي
يمكن أن يحتوي الدليل على قائمة بالأوامر التي سيتم تنفيذها بواسطة com.dbpmda بطريق الانطلاق،
قبل مطالبة المستخدم بإدخال أوامر أخرى بشكل تفاعلي. أثناء معالجة ملف
.dbpmdarc يتم تمكين الملف والوضع التفاعلي وترديد صدى الأوامر ثم إعادة ضبطهما في النهاية
ل .dbpmdarc ملف (انظر ملف -i و -e وسيطات سطر الأوامر أدناه).

إذا كان النظام يدعم يقوم readline(3) ثم سيتم استخدام هذا لقراءة الأوامر عندما يكون الإدخال
من جهاز tty ، لذلك يتوفر تحرير السجل وسطر الأوامر.

com.dbpmda يقبل وسيطات سطر الأوامر التالية:

-e صدى المدخلات إلى المعياري. يكون هذا مفيدًا عند إعادة توجيه الإدخال من ملف.

-i محاكاة السلوك التفاعلي والمطالبة بأوامر جديدة ، حتى لو كان الإدخال القياسي
ليس جهاز tty.

-n pmns ملف
عادة com.dbpmda تعمل على مساحة اسم مقاييس الأداء الموزعة (PMNS) ،
ولكن إذا كان -n يتم تحديد الخيار يتم تحميل PMNS محلي بديل من ملف
ملف pmns ملف.

-q مهلة
بروتوكول تبادل إصدار pmcd إلى وكيل (جديد في PCP 2.0 - تم تقديمه لتوفير
التوافق مع الإصدارات السابقة) يستخدم هذه المهلة لتحديد المدة com.dbpmda يجب أن تنتظر
قبل افتراض عدم ورود أي استجابة للإصدار من الوكيل. إذا كانت هذه المهلة
تم الوصول إليه ، يُفترض أن يكون الوكيل وكيلًا لا يفهم PCP
2.0 بروتوكول. الفاصل الزمني الافتراضي للمهلة هو خمس ثوانٍ ، لكن ملف -q خيار
يسمح بفاصل زمني بديل للمهلة (يجب أن يكون أكبر من الصفر) ليكون
محدد. وحدة الوقت هي ثواني.

-U اسم المستخدم
حساب المستخدم الذي يتم تشغيله بموجبه com.dbpmda.

نظرًا لعدم وجود قيود المهلة على PMDA أثناء استخدام com.dbpmda (مقارنة ب com.pmcd(1،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX))،
مصحح آخر مثل جدب(1) يمكن استخدامها في عملية PMDA بمجرد إرفاقها
com.dbpmda.

مثال

وفيما يلي com.dbpmda جلسة باستخدام بسيط PMDA. أ .dbpmdarc يتم استخدام الملف لضبط ملف
علامة التصحيح ، افتح PMDA واعرض الحالة الحالية لمصحح الأخطاء:

$ القط .dbpmdarc
تصحيح libpmda
فتح dso pmda_simple.so simple_init 253
الحالة

متى com.dbpmda يتم تشغيل الأوامر الموجودة في .dbpmdarc يتم تنفيذ الملف أولاً:

$ dbpmda
.dbpmdarc> تصحيح أخطاء libpmda
.dbpmdarc> فتح dso pmda_simple.so simple_init 253
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) تصحيح الخطأ: pmdaInit: PMDA simple DSO: Metric 0.0.1(1) مطابقة للإندوم 253.0(0)
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) تصحيح الخطأ: pmdaInit: PMDA simple DSO: ملف المساعدة $ PCP_PMDAS_DIR / simple / help تم فتحه
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) معلومات: الاسم = DSO بسيط
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) معلومات: المجال = 253
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) المعلومات: عدد المقاييس = 4
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) معلومة: رقم إندوم = 1
[الجمعة 19 سبتمبر 10:19:55] com.dbpmda(11651) المعلومات: خريطة مباشرة = 1
.dbpmdarc> الحالة

Namespace: (افتراضي)
PMDA: ./pmda_simple.so
الاتصال: dso
إصدار واجهة DSO: 2
إصدار PMDA PMAPI: 2
pmDebug: 32768 (ليبمدا)
انتهى الوقت
Getdesc: إيقاف

حالة ملف تعريف مثيل التفريغ = تضمين ، 0 ملفات تعريف

.dbpmdarc>

لفحص واصفات المقاييس والمثيلات ، يتم استخدام ملف تنازلي و مثل يمكن أن تكون الأوامر
مستخدم. يمكن تحديد المقاييس إما بالاسم أو باستخدام الترميز `` المنقط '' لـ
تحديد مجالات المجال والكتلة والعنصر لميد. يجب أن تكون مجالات المثيل
تم تحديده باستخدام تدوين `` منقط '' لتحديد المجال والحقول التسلسلية. بناء الجملة
بالنسبة لمعظم الأوامر ، سيتم عرض الأمر إذا تم إعطاء الأمر بدون أي وسيطات:

dbpmda> desc 253.0.0
PMID: 253.0.0
نوع البيانات: int غير موقعة 32 بت InDom: PM_INDOM_NULL 0xffffffff
الدلالات: الوحدات الفورية: لا شيء
dbpmda> مثيل
مثيل إندوم # [رقم | الاسم | "اسم" ]
dbpmda> مثيل 253.0
مساءًإندوم: 253.0
[0] inst: 0 اسم: "أحمر"
[1] inst: 1 الاسم: "أخضر"
[2] inst: 2 الاسم: "أزرق"

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

dbpmda> المؤقت قيد التشغيل
dbpmda> جلب simple.numfetch 253.0.1
PMID (s): 253.0.0 253.0.1
pm نتيجة التفريغ من 0x100078e0 الطابع الزمني: 0.000000 11: 00: 00.000 numpmid: 2
253.0.0 (simple.numfetch): numval: 1 valfmt: 0 vlist []:
القيمة 1 1.4012985e-45 0x1
253.0.1 (simple.color): عدد: 3 valfmt: 0 vlist []:
inst [0 or ؟؟؟] القيمة 1 1 1.4012985e-45 0x1
inst [1 or ؟؟؟] القيمة 101 1.4153114e-43 0x65
inst [2 or ؟؟؟] القيمة 201 2.8166099e-43 0xc9
الموقت: 0.003921 ثانية
dbpmda> إيقاف تشغيل المؤقت

الأعداد الصحيحة والفاصلة العائمة وترجمات السداسي عشرية للقيم الموجودة في مساء النتيجة بناء
ملقاة إذا com.getdesc ومن المقرر أن خصم (الافتراضي). جلسة com.getdesc إلى on من شأنه أن يؤدي إلى
يتم إغراق قيم الأعداد الصحيحة فقط في الجلب أعلاه كما يصف الواصف
مقاييس الأعداد الصحيحة بدون إشارة 32 بت.

يدعم PMDA البسيط أيضًا متجر العملية التي يمكن اختبارها لاحقًا
جلب أوامر:

dbpmda> store simple.numfetch "42"
PMID: 253.0.0
الحصول على الوصف ...
الحصول على بنية النتيجة ...
253.0.0: 2 -> 42
dbpmda> جلب simple.numfetch
PMID (s): 253.0.0
pm نتيجة التفريغ من 0x100078e0 الطابع الزمني: 0.000000 11: 00: 00.000 numpmid: 1
253.0.0 (simple.numfetch): numval: 1 valfmt: 0 vlist []:
قيمة 43

وسيطة القيمة في ملف متجر يجب أن يكون الأمر عبارة عن سلسلة مضمنة في أي منهما
علامات الاقتباس المفردة (") أو علامات الاقتباس المزدوجة (").

A البيانات الشخصية يمكن تحديدها لكل مجال مثيل يتضمن كل أو بعض أو لا
الأمثلة:

dbpmda> ملف المساعدة

ملف التعريف إندوم # [الكل | لا أحد ]
ملف التعريف إندوم # [إضافة | حذف] الرقم

بالنسبة لمجال المثيل المحدد ، قد يتم تغيير ملف التعريف إلى
تتضمن "جميع" مثيلات ، لا توجد حالات ، إضافة مثيل أو حذف
حالة.

dbpmda> الملف الشخصي 253.0 لا شيء
dbpmda> getdesc on
dbpmda> جلب 253.0.1
PMID (s): 253.0.1
pm نتيجة التفريغ من 0x100078e0 الطابع الزمني: 0.000000 11: 00: 00.000 numpmid: 1
253.0.1 (simple.color): لم يتم إرجاع أية قيم!
dbpmda> الملف الشخصي 253.0 إضافة 2
dbpmda> جلب 253.0.1
PMID (s): 253.0.1
pm نتيجة التفريغ من 0x100078e0 الطابع الزمني: 0.000000 11: 00: 00.000 numpmid: 1
253.0.1 (simple.color): عدد: 1 valfmt: 0 vlist []:
قيمة 202
dbpmda> الملف الشخصي 253.0 إضافة 0
dbpmda> جلب 253.0.1
PMID (s): 253.0.1
pm نتيجة التفريغ من 0x100078e0 الطابع الزمني: 0.000000 11: 00: 00.000 numpmid: 1
253.0.1 (simple.color): عدد: 2 valfmt: 0 vlist []:
inst [0 or ؟؟؟] القيمة 2
inst [2 or ؟؟؟] القيمة 203
dbpmda> الحالة

PMDA =pmda_simple.so
اتصال = dso
pmDebug = 32768 (ليبمدا)
الموقت = إيقاف

حالة ملف تعريف مثيل التفريغ = تضمين ، 1 ملفات تعريف
الملف الشخصي [0] indom = 1061158913 [253.0] state = استثناء 2 مثيل
المثيلات: [2] [0]
dbpmda> إنهاء

• راقب الأمر (الاستخدام: راقب اسم الملف ) يفتح نافذة xwsh التي تخلف الملف المحدد
ملف تسجيل. يجب أن يتم إغلاق هذه النافذة من قبل المستخدم عند عدم الحاجة إليها.

• انتظر الأمر يعادل النوم (1) ويأخذ حجة عدد صحيح واحد.

إدخال الأشجار الفرعية الديناميكية في PMNS و PMDA_INTERFACE_4 بتنسيق libpcp_pmda لديها
أدت إلى أوامر إضافية يتم دعمها في com.dbpmda لممارسة الديناميكية المرتبطة
خدمات PMNS. الأمثلة أدناه تستند إلى عينة PMDA.

$ dbpmda
dbpmda> فتح الأنابيب / var / lib / pcp / pmdas / sample / pmdasample -d 29
بدء pmdasample PMDA: / var / lib / pcp / pmdas / sample / pmdasample -d 29
dbpmda> عينة الأطفال
متري: عينة. سرية
فو غير أوراق
شريط ورقة
dbpmda> اجتياز العينة
متري: sample.secret.foo
Sample.secret.foo.bar.max.redirect
Sample.secret.foo.one
عينة. سر. فو. اثنين
Sample.secret.foo.bar.three
Sample.secret.foo.bar.four
Sample.secret.foo.bar.grunt.five
Sample.secret.foo.bar.grunt.snort.six
Sample.secret.foo.bar.grunt.snort.huff.puff.seven
dbpmda> عينة pmid.secret.foo.bar.four
متري: sample.secret.foo.bar.four
29.0.1004
dbpmda> الاسم 29.0.1006
PMID: 29.0.1006
Sample.secret.foo.bar.grunt.snort.six

• الأطفال يُرجع الأمر مكون الاسم التالي لجميع الأحفاد المباشرة لملف
عقدة داخل شجرة فرعية ديناميكية من PMNS. وذات الصلة طريق مختصر الأمر يعيد كامل
أسماء متري لجميع العقد الطرفية في PMNS أسفل العقدة غير الورقية المحددة في ديناميكي
الشجرة الفرعية لـ PMNS.

• الاسم و pmid تمارس الأوامر ترجمة أسماء المقاييس إلى PMIDs (والعكس
بالعكس) للمقاييس داخل الشجرة الفرعية الديناميكية لـ PMNS.

إذا كانت الأوامر الأطفال, طريق مختصر, pmid or الاسم تستخدم مع PMDA وهذا هو ليس استخدام
PMDA_INTERFACE_4 أو بأسماء مقاييس أداء ليست جزءًا من شجرة فرعية ديناميكية
من PMNS ، فمن المتوقع أن تقوم PMDA بإرجاع أخطاء (PM_ERR_NAME أو PM_ERR_PMID)
لتعكس حقيقة أن العملية خاطئة (خارج الشجرة الفرعية الديناميكية لـ PMNS
أنه com.pmcd(1) وليست PMDA المسؤولة عن تنفيذ هذه الوظائف).

تم دمج آليات مصادقة العميل في PMCS ، مما يوفر لكل مستخدم
(ولكل اتصال) المعلومات المتوفرة ل PMDAs. باستخدام PMDA
PMDA_INTERFACE_6 أو أحدث بتنسيق libpcp_pmda قادر على الاستفادة من طريقة "السمة"
الحصول على رؤية لهذه الاتصالات المصدق عليها ، مع الوصول إلى المعلومات بما في ذلك
معرفات المستخدم والمجموعة واسم المستخدم وما إلى ذلك. الحاجة إلى ممارسة هذا وتصحيحه
أدى إلى واجهة جديدة com.dbpmda يأمر. المثال التالي يستند إلى عينة
PMDA.

$ dbpmda
dbpmda> فتح الأنابيب pmdasample -D AUTH -l ملف السجل
ابدأ pmdasample PMDA: ملف السجل pmdasample -D AUTH -l
dbpmda> attr "اسم المستخدم" "tanya"
السمة: اسم المستخدم = تانيا
للنجاح
dbpmda> attr 11 "0"
السمة: معرف المستخدم = 0
للنجاح
dbpmda>

• ATTR الأمر يمرر سمات الاتصال (مفاتيح PCP_ATTR) وقيمها إلى PMDA
بنفس الطريقة التي يستخدمها PMCD لاتصال العميل. com.dbpmda دائما يمر أ
معرف سياق العميل صفر ، وبينما لا يتم إجراء فحص الصلاحية على القيم
يمكن تعيين السمات المعترف بها فقط.

في المثال أعلاه مصادقة تم تعيين علامة التصحيح لـ PMDA ، والتي تستخدم هذا في ملف
نداء السمة ويسجل كل سمة وقيمة زوج يتم إرسالها إليه في ملف ملف تسجيل.

لاحظ أن فحوصات المصادقة قد تم إجراؤها بالفعل بواسطة PMCD بحلول الوقت الذي يتم فيه إجراء PMDA
مع هذه السمات ، لذلك لا حاجة لمزيد من التحقق من قبل PMDA.

تحفظات

لا يمكن تخزين قيمة في مقاييس من النوع PM_TYPE_AGGREGATE or PM_TYPE_EVENT.

com.dbpmda يستخدم شوكة(2) و EXEC(2) لإرفاق PMDAs الخفي. com.dbpmda لا يبذل أي محاولة ل
الكشف عن إنهاء عملية الخفي PMDA ، لذلك من الممكن أن يتم الخروج من PMDA
بشكل غير متوقع دون أي إشعار. ومع ذلك ، فإن أي محاولات تواصل أخرى مع
سوف ينتج عن PMDA أخطاء ستشير إلى أن PMDA لم تعد تستجيب.

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