זוהי הפקודה pmlogextract שניתן להריץ בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות החינמיות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS.
תָכְנִית:
שֵׁם
pmlogextract - צמצום, חילוץ, שרשור ומיזוג של ארכיוני Performance Co-Pilot
תַקצִיר
pmlogextract [-dfwz] [-c configfile] [-S שעת התחלה] [-s דגימות] [-T זמן סיום] [-v
דגימות נפח] [-Z אזור זמן] קלט [...] תפוקה
תיאור
pmlogextract קורא יומן ארכיון אחד או יותר של Performance Co-Tailer (PCP) שזוהו על ידי קלט
ויוצר יומן ארכיון PCP ממוזג ו/או מצומצם באופן זמני תפוקהטבעו של
המיזוג נשלט על ידי מספר יומני הארכיון הקלט, בעוד שאופי הנתונים
ההפחתה נשלטת על ידי ארגומנטים משורת הפקודה. הקלט/ים חייב/ים להיות ארכיון PCP
יומנים שנוצרו על ידי pmlogger(1) עם נתוני ביצועים שנאספו מ- אותו מארח, אבל
בדרך כלל לאורך תקופות זמן שונות ואולי (אם כי לא בדרך כלל) עם תקופות שונות
מדדי ביצועים נרשמים.
אם רק אחד קלט מצוין, אזי התנהגות ברירת המחדל פשוט מעתיקה את ה-PCP של הקלט
יומן ארכיון, לתוך יומן ארכיון PCP הפלט. כאשר שני יומני ארכיון PCP או יותר נמצאים
צוין כ קלט, הלוגים ממוזגים (או משורשרים) ונכתבים אל תפוקה.
ביומן ארכיון הפלט תתווסף רשומת ``mark'' ברגע שרק אחרי הסוף
של כל אחד מיומני ארכיון הקלט כדי לציין אי רציפות זמנית אפשרית בין
סוף יומן ארכיון קלט אחד ותחילת יומן ארכיון הקלט הבא. ראה את
סימן רשומות סעיף להלן לקבלת מידע נוסף. אין רשומת "סימן" לאחר
סוף ה אחרון (לפי סדר זמני) של יומני ארכיון הקלט.
פקודה קו אפשרויות
אפשרויות שורת הפקודה עבור pmlogextract הם כדלקמן:
-c configfile
חילץ רק את המדדים שצוינו ב configfile מ קלט יומן/יומני ארכיון PCP.
השמיים configfile תחביר מקובל על ידי pmlogextract מוסבר ביתר פירוט ב-
תְצוּרָה שלח תחביר סָעִיף.
-d מצב נואש. בדרך כלל, אם מתרחשת שגיאה חמורה, כל עקבות של החלקיקים
ארכיון PCP כתוב תפוקה מוסר. עם ה- -d אפשרות, תפוקה יומן ארכיון
לא מוסר.
-f עבור רוב השימושים הנפוצים, כל יומני ארכיון הקלט נאספו ב-
אותו אזור זמן. אבל אם זה לא המקרה, אז pmlogextract חייב לבחור אחד מ
אזורי הזמן מארכיון יומני הקלט שישמשו כאזור הזמן עבור הפלט
יומן ארכיון. ברירת המחדל היא להשתמש באזור הזמן מה- אחרון יומן ארכיון קלט.
השמיים -f האפשרות כופה את אזור הזמן מ- ראשון יומן ארכיון קלט שיש להשתמש בו.
-S שעת התחלה
הגדר את תחילת חלון הזמן כדי להגביל את הדגימות שנאספו או ציין
יישור "טבעי" של זמני דגימת הפלט; עיין ב PCPIintro(1). ראה גם
מה היא -w אוֹפְּצִיָה.
-s דגימות
הוויכוח דגימות מגדיר את מספר הדגימות שיש לכתוב אליהן תפוקה. אם
דגימות הוא 0 או -s לא מצוין, pmlogextract ידגום עד סוף ה-
יומן ארכיון PCP, או סוף חלון הזמן כפי שצוין על ידי -T, מה שיבוא
ראשון. ה -s האפשרות תעקוף את -T אפשרות אם זה יקרה מוקדם יותר.
-T זמן סיום
הגדר את סיום חלון הזמן כדי להגביל את הדגימות שנאספו או
ציין יישור "טבעי" של זמני דגימת הפלט; עיין ב PCPIintro(1).
ראה גם -w אוֹפְּצִיָה.
-v דגימות נפח
השמיים תפוקה יומן ארכיון הוא פוטנציאלית מערך נתונים מרובה כרכים, ו- -v אוֹפְּצִיָה
גורמים pmlogextract כדי להתחיל כרך חדש לאחר מכן דגימות נפח רישומי יומן היו
נכתב ליומן הארכיון.
בלתי תלוי בכל -v אפשרות, כל כרך בארכיון מוגבל ללא יותר מ
2^31 בתים, אז pmlogextract ייצור אוטומטית אמצעי אחסון חדש עבור הארכיון
לפני שמגיעים למגבלה זו.
-w איפה -S ו -T לציין חלון זמן באותו יום, -w דגל יגרום
הנתונים בתוך חלון הזמן שיש לחלץ, עבור כל יום ביומן הארכיון.
לדוגמה, האפשרויות -w -S @11:00 -T @15:00 לציין זאת pmlogextract צריך
לכלול רשומות יומן ארכיון רק לתקופות שבין השעות 11:3 ל-XNUMX:XNUMX בכל יום.
מתי -w משמש, את תפוקה יומן הארכיון יכיל רשומות ``סמן'' כדי לציין
אי הרציפות הזמנית בין סוף חלון זמן אחד לתחילתו של
הבא.
-Z אזור זמן
השתמש אזור זמן בעת הצגת התאריך והשעה. אזור זמן הוא בפורמט של
משתנה הסביבה TZ כמתואר ב על(7).
-z השתמש באזור הזמן המקומי של המארח מיומני ארכיון הקלט. ברירת המחדל היא
השתמש בתחילה באזור הזמן של המארח המקומי.
תְצוּרָה קובץ תחביר
השמיים configfile מכיל מדדים מעניינים - רק אותם מדדים (או מקרים) שהוזכרו
במפורש או במשתמע בקובץ התצורה ייכלל ב- תפוקה ארכיון.
כל מפרט חייב להתחיל בשורה חדשה, ויכול להשתרע על פני מספר שורות ב
קובץ תצורה. ניתן גם לציין מופעים, אך הם אופציונליים. הפורמט
עבור כל מפרט הוא
מדד [[מופע[,מופע...]]]
איפה מטרי יכול להיות שם עלה או שם שאינו עלה במרחב השמות של מדדי ביצועים (PMNS,
לִרְאוֹת pmns(5)). אם מטריקה מתייחסת לצומת שאינו עלה ב-PMNS, pmlogextract יצטרך
לרדת באופן רקורסיבי ב-PMNS ולכלול את כל המדדים התואמים לעלה היורד
צמתים.
מופעים הם אופציונליים, וניתן לציין אותם כרשימה של רווח אחד או יותר (או פסיק)
שמות, מספרים או מחרוזות מופרדים (מוקפים במירכאות בודדות או כפולות). אלמנטים ב
הרשימה שהן מספרים מניחים שהיא מזהה פנימי של מופעים - ראה
pmGetInDom(3) למידע נוסף. אם לא ניתנו דוגמאות, אז את כל מקרים של ה-
המדד/ים המשויכים יחולצו.
כל רווח לבן נוסף מתעלם וניתן להוסיף הערות עם קידומת `#`.
תְצוּרָה קובץ דוגמא
זוהי דוגמה לדבר תקף configfile:
#
# קובץ תצורה עבור pmlogextract
#
kernel.all.cpu
kernel.percpu.cpu.sys ["cpu0", "cpu1"]
דיסק.dev ["dks0d1"]
סימן רשומות
כאשר יותר מיומן ארכיון קלט אחד תורם נתוני ביצועים לארכיון הפלט
יומן, לאחר מכן מוכנסות רשומות ``mark'' כדי לציין אי רציפות אפשרית ב-
נתוני ביצועים.
רשומת ``mark'' מכילה חותמת זמן ואינה מכילה נתוני ביצועים ומשמשת לציון
שיש פרק זמן ביומן ארכיון ה-PCP שבו איננו יודעים את הערכים של כל
מדדי ביצועים, מכיוון שלא היו pmlogger(1) איסוף נתוני ביצועים במהלך
תקופה זו. מכיוון שתקופות אלו קשורות לעיתים קרובות להפעלה מחדש של שירות או
pmcd(1) או מערכת, ייתכן ספק ניכר לגבי המשכיות הביצועים
נתונים לאורך תקופת זמן זו.
ניתן להדגים את ההיגיון מאחורי "סימון" רשומות באמצעות דוגמה. חשבו על אחת מהן.
יומן ארכיון קלט שמתחיל בשעה 00:10 ומסתיים בשעה 09:15 באותו יום, ועוד אחד
יומן ארכיון קלט שמתחיל בשעה 09:20 באותו היום ומסתיים בשעה 00:10 ביום שלאחר מכן
בוקר. זה יהיה מקרה נפוץ מאוד עבור ארכיונים המנוהלים ומסובבים על ידי
pmlogger_check(1) ו pmlogger_daily(1).
יומן ארכיון הפלט יכיל:
00:10.000 רשומה ראשונה מיומן ארכיון הקלט הראשון
...
09:15.000 רשומה אחרונה מיומן ארכיון הקלט הראשון
09:15.001
09:20.000 רשומה ראשונה מיומן ארכיון קלט שני
...
01:10.000 רשומה אחרונה מיומן ארכיון הקלט השני
פרק הזמן שבו חסרים נתוני הביצועים מתחיל מיד לאחר 09:15 ומסתיים
קצת לפני 09:20. כאשר יומן ארכיון הפלט מעובד עם כל אחד מדיווחי ה-PCP
כלים, רשומת ה-``mark`` משמשת לציון תקופה של נתונים חסרים. לדוגמה ב
בארכיון שלמעלה, אם היה מדווח על קצב הקלט/פלט הממוצע במרווחים של 30 דקות,
מיושר לפי השעה, אז יהיו נתונים עבור המרווחים המסתיימים ב-09:00 וב-10:00
אך לא דווחו נתונים עבור פרק הזמן שמסתיים ב-09:30 מכיוון שזה משתרע על פני שיא של "סימן".
ניתן לקבוע את נוכחותן של רשומות ``mark'' ביומן ארכיון PCP באמצעות
pmdumplog(1) כאשר חותמת זמן והביאור משמש לציון "סימן"
תקליט.
מטא נתונים בדיקות
כאשר יותר מאחד קלט הארכיון צוין, pmlogextract מבצע מספר בדיקות כדי
ודא שהמטא-דאטה עקבי עבור מדדים המופיעים ביותר מאחד מה- קלט
ארכיונים. בדיקות אלה כוללות:
* סוג נתוני המדד זהה
* הסמנטיקה המטרית זהה
יחידות מטריות זהות
* המטריקה היא תמיד סינגולרית או שתמיד בעלת אותו תחום מופע
* מדדים עם אותו שם בעלי אותו PMID
* מדדים עם אותו PMID נושאים את אותו שם
אם אחת מהבדיקות הללו נכשלת, pmlogextract מדווח על הפרטים ומפסיק ללא יצירה
מה היא תפוקה ארכיון.
כדי לטפל בבעיות סמנטיות אלו, השתמשו pmlogrewrite(1) לתרגם את קלט ארכיונים לתוך
ארכיונים מקבילים עם מטא-נתונים עקביים לפני השימוש pmlogextract.
השתמש ב-pmlogextract באופן מקוון באמצעות שירותי onworks.net
