dbpmda - מקוון בענן

תָכְנִית:

שֵׁם

dbpmda - באגים עבור PMDAs Co-Pilot של ביצועים

תַקצִיר

dbpmda [-יי] [-n pmnsfile] [-q פסק זמן] [-U שם משתמש]

תיאור

dbpmda הוא ממשק אינטראקטיבי לאינטראקציות בין דומיין מדדי ביצועים
סוכן (PMDA(3)) ודימון אוסף מדדי הביצועים (pmcd(1)). זה מאפשר PMDAs
להצמדה, לאתחל ולתרגל לבדיקת נכונות.

dbpmda באופן אינטראקטיבי מבקש מהמשתמש פקודות, שרבות מהן מחקות את הפרוטוקול
יחידות נתונים (PDUs) העשויות להישלח על ידי א pmcd(1) תהליך. אחרי ריצה dbpmda, להיכנס ל
הפקודה לעזור כדי לקבל רשימה של הפקודות הזמינות. הקטע לדוגמה למטה
ממחיש הפעלה באמצעות dbpmda לבדיקת PMDA.

כדי לפשט בדיקה חוזרת של PMDA, הקובץ .dbpmdarc בעבודה הנוכחית
ספרייה יכולה להכיל רשימה של פקודות שיבוצעו על ידי dbpmda בהפעלה,
לפני שהמשתמש מתבקש להזין פקודות נוספות באופן אינטראקטיבי. תוך כדי עיבוד ה
.dbpmdarc קובץ, מצב אינטראקטיבי והדהוד פקודה מופעלים ואז מתאפסים בסוף
של .dbpmdarc קובץ (ראה את -i ו -e ארגומנטים של שורת הפקודה למטה).

אם המערכת תומכת קריאת שורה(3) אז זה ישמש לקריאת פקודות כאשר הקלט הוא
ממכשיר tty, כך שההיסטוריה ועריכת שורת הפקודה זמינות.

dbpmda מקבל את הארגומנטים הבאים של שורת הפקודה:

-e הד את הקלט ל stdout. זה שימושי כאשר הקלט מנותב מחדש מקובץ.

-i חיקוי התנהגות אינטראקטיבית ובקש פקודות חדשות, גם אם קלט סטנדרטי כן
לא מכשיר tty.

-n pmnsfile
בדרך כלל dbpmda פועל על מרחב השמות המבוזר של מדדי ביצועים (PMNS),
אולם אם ה -n אפשרות מוגדרת PMNS מקומי חלופי נטען מה-
פילה pmnsfile.

-q פסק זמן
פרוטוקול החלפת גרסאות pmcd לסוכן (חדש ב-PCP 2.0 - הוצג כדי לספק
תאימות לאחור) משתמש בפסק זמן זה כדי לציין כמה זמן dbpmda צריך לחכות
לפני שמניחים ששום תגובת גרסה לא מגיעה מסוכן. אם פסק הזמן הזה
הושגה, ההנחה היא שהסוכן הוא סוכן שאינו מבין את ה-PCP
פרוטוקול 2.0. מרווח הזמן הקצוב המוגדר כברירת מחדל הוא חמש שניות, אבל -q אוֹפְּצִיָה
מאפשר מרווח זמן קצוב חלופי (שחייב להיות גדול מאפס).
נָקוּב. יחידת הזמן היא שניות.

-U שם משתמש
חשבון משתמש תחתיו לפעול dbpmda.

מכיוון שאין אילוצי זמן קצוב על PMDA בזמן השימוש dbpmda (לעומת pmcd(1)),
עוד באגים כמו gdb(1) ניתן להשתמש בתהליך PMDA לאחר שהוא התחבר אליו
dbpmda.

דוגמא

להלן א dbpmda הפעלה באמצעות ה פשוט PMDA. א .dbpmdarc הקובץ משמש להגדרת ה
דגל איתור באגים, פתח את ה-PMDA והצג את המצב הנוכחי של מאתר הבאגים:

$ cat .dbpmdarc
ניפוי באגים libpmda
פתח את dso pmda_simple.so simple_init 253
מצב

מתי dbpmda מופעל, הפקודות ב- .dbpmdarc הקובץ מבוצע תחילה:

$dbpmda
.dbpmdarc> נפה באגים ב-libpmda
.dbpmdarc> פתח את dso pmda_simple.so simple_init 253
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) ניפוי באגים: pmdaInit: PMDA DSO פשוט: מטרי 0.0.1(1) תואם לאנדום 253.0(0)
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) ניפוי באגים: pmdaInit: PMDA פשוט DSO: קובץ עזרה $PCP_PMDAS_DIR/simple/help נפתח
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) מידע: שם = DSO פשוט
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) מידע: דומיין = 253
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) מידע: מספר מדדים = 4
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) מידע: num indom = 1
[שישי 19 בספטמבר 10:19:55] dbpmda(11651) מידע: מפה ישירה = 1
‎.dbpmdarc> סטטוס

מרחב שמות: (ברירת מחדל)
PMDA: ./pmda_simple.so
חיבור: dso
גרסת ממשק DSO: 2
גרסת PMDA PMAPI: 2
pmDebug: 32768 ( libpmda )
טיימר: כבוי
Getdesc: כבוי

Dump Instance Profile state=INCLUDE, 0 פרופילים

.dbpmdarc>

כדי לבחון את מתארי המדד והמופע, ה יורד ו למשל פקודות יכולות להיות
בשימוש. ניתן לזהות מדדים לפי שם, או באמצעות הסימון ``מנוקד'' כדי
ציין את שדות הדומיין, האשכול והפריט של PMID. דומיינים של מופע חייבים להיות
מזוהה באמצעות סימון ``מנוקד'' כדי לציין את התחום והשדות הטוריים. התחביר
עבור רוב הפקודות יוצגו אם הפקודה תינתן ללא ארגומנטים כלשהם:

dbpmda> desc 253.0.0
PMID: 253.0.0
סוג נתונים: 32-bit unsigned int InDom: PM_INDOM_NULL 0xffffffff
סמנטיקה: יחידות מיידיות: אין
מופע dbpmda>
מופע indom# [ מספר | שם | "שם"]
dbpmda> מופע 253.0
pmInDom: 253.0
[ 0] inst: 0 שם: "אדום"
[1] inst: שם 1: "ירוק"
[2] inst: 2 שם: "כחול"

כדי לבדוק את המרכיב החשוב ביותר של PMDA, ה לְהָבִיא, לעתים קרובות שימושי לקבוע
הזמן שלוקח ל-PMDA להגיב. ה שעון עצר עשוי להיות מופעל לפני מתן א לְהָבִיא:

dbpmda> טיימר מופעל
dbpmda> fetch simple.numfetch 253.0.1
PMID(ים): 253.0.0 253.0.1
pmResult dump מ-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 או ???] ערך 1 1 1.4012985e-45 0x1
inst [1 או ???] ערך 101 1.4153114e-43 0x65
inst [2 או ???] ערך 201 2.8166099e-43 0xc9
טיימר: 0.003921 שניות
dbpmda> טיימר כבוי

התרגום השלם, הנקודה הצפה וההקסדה של הערכים ב- pmResult מִבְנֶה
נזרקים אם getdesc מוגדר כבוי (ברירת המחדל). הגדרה getdesc ל on יביא ל
רק ערכי מספרים שלמים מושלכים באחזור לעיל כפי שהמתאר מתאר את
מדדים של מספרים שלמים ללא סימנים של 32 סיביות.

ה-PMDA הפשוט תומך גם ב- חנות פעולה שניתן לבדוק עם הבאות
לְהָבִיא פקודות:

dbpmda> store simple.numfetch "42"
PMID: 253.0.0
מקבל תיאור...
מקבל מבנה תוצאה...
253.0.0: 2 -> 42
dbpmda> להביא simple.numfetch
PMID(ים): 253.0.0
pmResult dump מ-0x100078e0 חותמת זמן: 0.000000 11:00:00.000 numpmid: 1
253.0.0 (simple.numfetch): numval: 1 valfmt: 0 vlist[]:
ערך 43

ארגומנט הערך ב- חנות הפקודה חייבת להיות מחרוזת, המוקפת בכל אחת מהן
מרכאות בודדות (') או מרכאות כפולות (").

A פרופיל ניתן לציין עבור כל תחום מופע הכולל הכל, חלק או לא
מקרים:

dbpmda> פרופיל עזרה

פרופיל indom# [ הכל | אף אחד ]
פרופיל indom# [ הוסף | מחק ] מספר

עבור תחום המופע שצוין, הפרופיל עשוי להשתנות ל
כלול 'כל' המופעים, ללא מופעים, הוסף מופע או מחק
מופע.

dbpmda> פרופיל 253.0 אין
dbpmda> getdesc on
dbpmda> להביא את 253.0.1
PMID(ים): 253.0.1
pmResult dump מ-0x100078e0 חותמת זמן: 0.000000 11:00:00.000 numpmid: 1
253.0.1 (simple.color): לא הוחזרו ערכים!
dbpmda> profile 253.0 add 2
dbpmda> להביא את 253.0.1
PMID(ים): 253.0.1
pmResult dump מ-0x100078e0 חותמת זמן: 0.000000 11:00:00.000 numpmid: 1
253.0.1 (simple.color): מספר: 1 valfmt: 0 vlist[]:
ערך 202
dbpmda> profile 253.0 add 0
dbpmda> להביא את 253.0.1
PMID(ים): 253.0.1
pmResult dump מ-0x100078e0 חותמת זמן: 0.000000 11:00:00.000 numpmid: 1
253.0.1 (simple.color): מספר: 2 valfmt: 0 vlist[]:
inst [0 או ???] ערך 2
inst [2 או ???] ערך 203
מצב dbpmda>

PMDA = pmda_simple.so
חיבור = dso
pmDebug = 32768 ( libpmda )
טיימר = כבוי

Dump Instance Profile state=INCLUDE, 1 פרופילים
פרופיל [0] indom=1061158913 [253.0] state=EXCLUDE 2 מופעים
מופעים: [2] [0]
dbpmda> צא

השמיים שעון פקודה (שימוש: שעון שם הקובץ ) פותח חלון xwsh המתאים לצוין
קובץ לוג. חלון זה חייב להיסגר על ידי המשתמש כאשר אינו נדרש עוד.

השמיים לחכות פקודה שווה ערך ל לִישׁוֹן (1) ולוקח ארגומנט של מספר שלם בודד.

הצגת תתי-עצים דינמיים ב-PMNS וב-PMDA_INTERFACE_4 אינץ' libpcp_pmda יש ל
הוביל לתמיכה בפקודות נוספות dbpmda לממש את הדינמיקה הקשורה
שירותי PMNS. הדוגמאות שלהלן מבוססות על לִטעוֹם PMDA.

$dbpmda
dbpmda> צינור פתוח /var/lib/pcp/pmdas/sample/pmdasample -d 29
התחל pmdasample PMDA: /var/lib/pcp/pmdas/sample/pmdasample -d 29
dbpmda> children sample.secret
מדד: sample.secret
foo ללא עלים
סרגל עלים
dbpmda> traverse sample.secret.foo
מדד: sample.secret.foo
sample.secret.foo.bar.max.redirect
sample.secret.foo.one
sample.secret.foo.two
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 sample.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

השמיים ילדים הפקודה מחזירה את רכיב השם הבא עבור כל הצאצאים הישירים של a
צומת בתוך תת-עץ דינמי של ה-PMNS. הקשורים לַחֲצוֹת הפקודה מחזירה את מלא
שמות מדדים לכל צמתי העלים ב-PMNS מתחת לצומת הלא-עלים שצוין בדינמיקה
תת-עץ של ה-PMNS.

השמיים שם ו pmid פקודות מפעילות את התרגום של שמות מדדים ל-PMIDs (וסגנו
להיפך) עבור מדדים בתוך תת-עץ דינמי של ה-PMNS.

אם הפקודות ילדים, לַחֲצוֹת, pmid or שם משמשים עם PMDA כלומר לֹא באמצעות
PMDA_INTERFACE_4 או עם שמות ערכי ביצועים שאינם חלק מתת-עץ דינמי
מה-PMNS, אז ה-PMDA צפוי להחזיר שגיאות (PM_ERR_NAME או PM_ERR_PMID)
לשקף את העובדה שהפעולה שגויה (מחוץ לעץ משנה דינמי של ה-PMNS
זה pmcd(1) ולא ה-PMDA האחראי על יישום פונקציות אלו).

מנגנוני אימות לקוח שולבו ב-PMCS, המספקים לכל משתמש
מידע (ולכל חיבור) הזמין ל-PMDAs. PMDA משתמש
PMDA_INTERFACE_6 או מאוחר יותר ב libpcp_pmda מסוגל לעשות שימוש בשיטת "תכונה" ל
לקבל נראות לתוך הקשרים המאומתים הללו, עם גישה למידע כולל
מזהי משתמש וקבוצה, שם משתמש וכן הלאה. הצורך לממש ולתקן את זה
ממשק הוביל לחדש dbpmda פקודה. הדוגמה הבאה מבוססת על לִטעוֹם
PMDA.

$dbpmda
dbpmda> צינור פתוח pmdasample -D AUTH -l logfile
התחל את pmdasample PMDA: pmdasample -D AUTH -l logfile
dbpmda> attr "שם משתמש" "טניה"
תכונה: שם משתמש=טניה
הַצלָחָה
dbpmda> attr 11 "0"
תכונה: userid=0
הַצלָחָה
dbpmda>

השמיים attr הפקודה מעבירה תכונות חיבור (מפתחות PCP_ATTR) והערכים שלהן ל-PMDA
באופן כמעט דומה ל-PMCD עבור חיבור לקוח. dbpmda תמיד עובר א
מזהה הקשר לקוח של אפס, ולמרות שלא מתבצעת בדיקת תקפות על ערכים
ניתן להגדיר רק תכונות מוכרות.

בדוגמה שלמעלה AUTH דגל ניפוי באגים מוגדר עבור ה- PMDA, שמשתמש בזה
תכונה התקשרות חוזרת ומתעדת כל תכונה וזוג ערכים שנשלחים אליו ברשימה שלו קובץ לוג.

שים לב שבדיקות אימות כבר בוצעו על ידי PMCD עד לתאריך PMDA
מוצגות עם תכונות אלה, כך שאין צורך באימות נוסף על ידי PMDA.

מערות

לא ניתן לאחסן ערך במדדים מסוג PM_TYPE_AGGREGATE or PM_TYPE_EVENT.

dbpmda שימושים מזלג(2) ו Exec(2) לצרף לדימון PMDAs. dbpmda לא עושה ניסיון
לזהות את סיום תהליך ה-demon PMDA, כך שניתן ל-PMDA לצאת
באופן בלתי צפוי ללא כל הודעה. עם זאת, כל ניסיונות תקשורת נוספים עם
ה-PMDA יגרור שגיאות שיצביעו על כך שה-PMDA כבר לא מגיב.

השתמש ב-dbpmda באינטרנט באמצעות שירותי onworks.net