רכיבים של מודל המדדים

המודל של Cloud Monitoring לנתוני מעקב מורכב משלושה מושגים עיקריים:

  • סוגי משאבים במעקב
  • סוגי מדדים
  • פעולות על ציר הזמן

במסמך מודל המדדים מתוארים המושגים האלה של Cloud Monitoring במונחים כלליים. אם המושגים האלה חדשים לכם, כדאי לקרוא קודם את הדף הזה.

בדף הזה מתוארים סוגי מדדים, משאבים שנמצאים במעקב וסדרות זמן, וגם כמה מושגים קשורים, בפירוט רב יותר. המושגים האלה הם הבסיס לכל המדדים ב-Monitoring.

לפני שמנסים לאחזר נתוני מעקב גולמיים או מצטברים באמצעות Monitoring API, כמו שמתואר במאמר אחזור נתונים של סדרות זמן, חשוב להבין את המידע שבדף הזה. למידע נוסף על המושגים האלה ואיך הם ממופים ל-Cloud Monitoring API, אפשר לעיין במאמר מבנה של סדרות זמן, במיוחד אם אתם מתכננים להשתמש ב-Monitoring API.

כמה מילים על תוויות

גם סוגי המשאבים במעקב וגם סוגי המדדים תומכים בתוויות, שמאפשרות לסווג את הנתונים במהלך הניתוח. לדוגמה:

  • סוג של משאב בפיקוח למכונה וירטואלית יכול לכלול תוויות למיקום של המכונה ולמזהה הפרויקט שמשויך למכונה. כשמידע על המשאב במעקב מתועד, המידע כולל את הערכים של התוויות.
  • לסוג מדד שסופר בקשות ל-API יכולות להיות תוויות לתיעוד השם של השיטה שהופעלה והסטטוס של הבקשה.

מידע נוסף על השימוש בתוויות זמין במאמר תוויות.

סוגי משאבים במעקב

משאב במעקב הוא משאב שממנו נאספים נתונים של מדדים. ‫Cloud Monitoring תומך בכ-270 סוגים של משאבים במעקב.

סוגי המשאבים שבמעקב כוללים צמתים ומשימות כלליים, רכיבים ארכיטקטוניים ב-Google Kubernetes Engine ועוד.

כל סוג של משאב במעקב מתואר באופן רשמי במבנה נתונים שנקרא מתאר של משאב במעקב. מידע נוסף זמין במאמר מתארי משאבים במעקב.

לכל אחד מסוגי המשאבים במעקב הנתמכים יש רשומה ברשימת המשאבים במעקב. הערכים ברשימה נוצרים מתיאורי המשאבים המנוטרים. בקטע הזה מתואר המידע שמתועד בתיאור של משאב במעקב, ומוסבר איך הוא מוצג ברשימה.

דוגמה לסוג של משאב במעקב

בתמונה הבאה מוצגת רשומה ברשימה של קטגוריה של Cloud Storage:

רשימה של קטגוריית Cloud Storage.

כל הערכים ברשימה כוללים את הפרטים הבאים:

  • סוג: הכותרת ברשימות הרשומות מציינת את סוג המשאב במעקב. בדוגמה: gcs_bucket.
  • שם לתצוגה: תיאור קצר של המשאב שבמעקב.
  • תיאור: תיאור ארוך יותר של המשאב המפוקח.
  • תוויות: קבוצה של מאפיינים לסיווג נתונים. מידע נוסף זמין במאמר תוויות.

סוגי מדדים

סוג מדד מתאר מדידות שאפשר לאסוף ממקור שעובר מעקב. סוג מדד כולל תיאור של מה שנמדד ושל אופן הפרשנות של המדידות.

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

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

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

דוגמה לסוג מדד

בתמונה הבאה מוצגת רשומה של סוג מדד של Cloud Storage:

קטע מרשימת המדדים של Cloud Storage.

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

דוגמה לערך בטבלת Cloud Storage מספקת את המידע הבא על סוג מדד אחד:

  • סוג המדד: מזהה של סוג המדד, storage.googleapis.com/api/request_count בדוגמה.

    הקידומת storage.googleapis.com משמשת כמרחב שמות ל-Cloud Storage. כל סוגי המדדים שמשויכים לסוג מסוים של משאב במעקב משתמשים באותו מרחב שמות.

    מרחבי שמות מושמטים מהערכים בטבלאות.

    כל סוגי המדדים שמשויכים ל-Cloud Storage מפורטים בטבלה של מדדי Cloud Storage.

  • שלב ההשקה: בלוק צבעוני שמציין את שלב ההשקה של סוג המדד עם ערך כמו אלפא, בטא וזמינות כללית (GA).

  • שם לתצוגה: מחרוזת קצרה שמתארת את סוג המדד, למשל 'מספר הבקשות'.

  • ‫Kind, Type, Unit: בשורה הזו מופיע מידע שיעזור לכם להבין את ערכי הנתונים: בדוגמה מוצג מדד דלתא שנרשם כמספר שלם של 64 ביט ללא יחידה (זה הערך 1).

    • סוג: הדוגמה הזו היא מדד דלתא, שמתעד שינוי לאורך תקופה. כלומר, כל נקודה על הגרף מתעדת את מספר הקריאות ל-API מאז שנכתבה נקודת הנתונים הקודמת. מידע נוסף על סוגים זמין במאמר סוגי ערכים וסוגי מדדים.

    • סוג: בדוגמה הזו, הערכים נרשמים כמספרים שלמים בגודל 64 ביט. מידע נוסף על סוגים זמין במאמר סוגי ערכים וסוגי מדדים.

    • יחידה: לא צריך לציין יחידה למדד הזה כי הוא מייצג ספירה. הספרה 1 מציינת שלא צריך יחידה.

  • משאבים במעקב: המשאבים במעקב שסוג המדד הזה זמין עבורם. הערכים כאן זהים לאלה שמתוארים בקטע סוגי משאבים במעקב.

  • תיאור: מידע מפורט יותר על מה שמתועד ואיך. השם מוצג באותיות מוטות כדי להבדיל אותו מהתוויות.

  • תוויות: קבוצה של מאפיינים לסיווג נתונים. מידע נוסף זמין במאמר תוויות.

כשניגשים לנתוני מעקב דרך Cloud Monitoring API, צריך לכלול Cloud de Confiance פרויקט בקריאה ל-API. אפשר לאחזר רק את הנתונים שגלויים בפרויקט Cloud de Confiance . לדוגמה, אם תבקשו את נתוני הפרויקט שלכם עבור סוג המדד storage.googleapis.com/api/request_count, תראו את ספירת ה-API רק עבור קטגוריות של Cloud Storage בפרויקט. אם הפרויקט לא משתמש בקטגוריות של Cloud Storage, לא יוחזרו נתוני מדדים.

סוגים של מדדים מובנים

סוגי מדדים מובנים מוגדרים על ידי Cloud de Confiance by S3NS שירותים, כולל Cloud Monitoring. סוגי המדדים האלה מתארים מדידות סטנדרטיות למגוון רחב של תשתיות נפוצות, וכל אחד יכול להשתמש בהם.

ברשימת המדדים מוצג כל סט סוגי המדדים המובנים.

תוויות

תווית היא צמד מפתח/ערך שאפשר להשתמש בו כדי לספק מידע על ערך נתונים.

תוויות של מדדים ומשאבים במעקב

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

  • לסוג המדד Cloud Storage storage.googleapis.com/api/request_count יש שתי תוויות, response_code ו-method.
  • סוג המשאב המנוטר של Cloud Storage‏ gcs_bucket כולל שלוש תוויות: project_id,‏ bucket_name ו-location. התוויות מזהות מקרים ספציפיים של סוג המשאב.

לכן, כל הנתונים שנאספים עבור בקשות API מקטגוריה של Cloud Storage מסווגים לפי השיטה שהופעלה, קוד התגובה של הקריאה, השם, המיקום והפרויקט של הקטגוריה הרלוונטית. קבוצת התוויות משתנה בהתאם למדד או לסוג המשאב במעקב. התוויות הזמינות מתועדות בדפים רשימת המדדים ורשימת המשאבים במעקב.

אם עוקבים אחרי קוד התגובה, שם השיטה והמיקום כשסופרים קריאות ל-API, אפשר לאחזר את מספר הקריאות לשיטת API מסוימת, את מספר הקריאות שנכשלו לשיטה כלשהי או את מספר הקריאות שנכשלו לשיטה ספציפית במיקום ספציפי.

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

סדרת זמן: נתונים ממשאב במעקב

בקטע הזה מוסבר מהם נתוני מעקב ואיך הם מסודרים בסדרות זמן. כאן הרכיבים המושגיים של מודל המדדים הופכים לארטיפקטים מוחשיים.

ב-Cloud Monitoring נשמרות מדידות רגילות לאורך זמן של זוגות של מדדים וסוגי משאבים במעקב. הנתונים נאספים בסדרות עיתיות, וכל סדרה עיתית מכילה את הפריטים הבאים:

  • השם של סוג המדד שאליו שייכת סדרת הזמן, ושילוב אחד של ערכים לתוויות של המדד.

  • סדרה של זוגות (חותמת זמן, ערך). הערך value הוא המדידה, והערך timestamp הוא השעה שבה המדידה בוצעה.

  • המשאב המנוטר שהוא המקור של נתוני סדרת הזמן, ושילוב אחד של ערכים לתוויות של המשאב.

נוצרת סדרת זמן לכל שילוב של מדד ותוויות משאבים שמפיק נתונים.

דוגמה עם סגנון: לסוג המדד storage.googleapis.com/api/request_count יכולות להיות הרבה סדרות זמן עבור קטגוריות Cloud Storage של הפרויקט. בטבלה הבאה מוצגות כמה סדרות זמן אפשריות.

בטבלה, הערך bucket: xyz מייצג את הערך של התווית bucket_name בסוג המשאב שבמעקב, והערכים response_code ו-method הם תוויות בסוג המדד. יש סדרת זמן אחת לכל שילוב של ערכים בתוויות של המשאב והמדד. בטבלה מוצגים חלק מהם:

תווית
המשאב במעקב		 תוויות מדדים נתוני מדדים
bucket: 1234 response_code: OK,
method: read		 {
(3, Wed 2:00pm),
(2, Wed 2:05pm),
(8, Wed 2:10pm),
...}
bucket: 1234 response_code: OK,
method: write		 {
(1, Wed 2:01pm),
(2, Wed 2:04pm),
(7, Wed 2:09pm),
...}
bucket: 1234 response_code: FAIL,
method: write		 {
(1, Wed 2:01pm),
(0, Wed 2:04pm),
(0, Wed 2:09pm),
...}
bucket: 9876 response_code: OK,
method: read		 {
(2, Wed 1:59pm),
(4, Wed 2:05pm),
(3, Wed 2:10pm),
...}

‫Cloud Monitoring לא מתעד סדרות זמן 'ריקות'. בדוגמה של דלי Cloud Storage, אם אתם לא משתמשים בדלי מסוים או אף פעם לא קוראים לשיטה מסוימת של API, לא נאספים נתונים לגבי התווית הזו, ולא מוזכרת סדרת זמן. המשמעות היא שאם בפרויקט שלכם אין נתונים בכלל לגבי מדד מסוים, לא תראו את סוג המדד.

סוגי המדדים לא מציינים אילו סוגים של משאבים במעקב נמצאים בסדרות הזמן של המדדים. ב-Cloud Storage יש רק סוג אחד של משאב במעקב – gcs_bucket. יש סוגים של מדדים שמשויכים ליותר ממשאב אחד במעקב.

עוצמה (cardinality): סדרות זמן ותוויות

כל סדרת זמן משויכת לזוג ספציפי של מדד וסוג משאב במעקב. כל אחד מהמדדים ומהסוגים של המשאבים שבמעקב מספק מספר מסוים של תוויות. ב-Cloud Monitoring, מספר השילובים הייחודיים של ערכים עבור קבוצת התוויות הוא העוצמה (cardinality) של סוג המדד או סוג המשאב שבמעקב. הערכים האלה נקראים עוצמת המדד ועוצמת המשאב, והם קובעים כמה סדרות זמן אפשריות, העוצמה הכוללת, עשויות להיווצר.

נניח שיש לכם סוג מדד שמציין שתי תוויות, color ו-zone. העוצמה של המדד תלויה במספר הערכים האפשריים של התוויות האלה:

  • אם יש רק שלושה צבעים אפשריים, 'אדום', 'ירוק' ו'כחול', התווית color יכולה לכלול עד שלושה ערכים שונים.
  • אם יש רק שני אזורים אפשריים, 'מזרח' ו'מערב', אז לתווית zone יכולים להיות עד שני ערכים שונים.

העוצמה של המדד הזה היא 6 (3×2). אם יש 1,000 ערכים אפשריים לתווית color, ואם כל צבע יכול להופיע בכל אזור, הקרדינליות של המדד היא 2,000 (1,000‎×2). אותו חישוב חל אם אלה תוויות בסוג של משאב למעקב ולא בסוג של מדד.

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

הקרדינליות תלויה בערכים שיכולים להיות לתוויות.

כשנתונים של סדרות זמנים נכתבים, הם מסווגים לפי מדד וסוגי משאבים במעקב. לכל צמד של מדד וסוג משאב, העוצמה הכוללת היא המכפלה של עוצמת המדד ועוצמת המשאב. אם יש לכם מדד עם קרדינליות של 1,000, ולמשאב יש קרדינליות של 100, ואם כל ערך של תווית מופיע, אז יש לכם 100,000 סדרות זמן (1,000‎×100).