סוגי ערכים וסוגי מדדים

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

סוג הערך

סוג הערך הוא סוג הנתונים של המדידות. כל סדרת נתונים מתעדת את סוג הערך (סוג ValueType) של הנקודות על הגרף.

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

    • ‫BOOL, ערך בוליאני
    • ‫INT64, מספר שלם של 64 ביט
    • ‫DOUBLE, מספר ממשי (float) עם דיוק כפול
    • ‫STRING, מחרוזת

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

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

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

סוג המדד

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

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

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

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

שילובים נתמכים

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

בטבלה הבאה מפורטים סוגי המדדים וסוגי הערכים הנתמכים:

סוג הערך GAUGE DELTA CUMULATIVE4
BOOL כן לא לא
INT64 כן כן1 כן
DOUBLE כן כן1 כן
מחרוזת כן1 לא לא
הפצה כן2 כן1, 3 כן

‫1 השילוב הזה לא מותר במדדים מותאמים אישית, custom.googleapis.com.
2 השילוב הזה לא מותר במדדים מבוססי-יומנים. מידע נוסף זמין במאמר הגדרת מדדים מבוססי-יומנים מסוג התפלגות.
3 זה השילוב היחיד שמותר למדדים מבוססי-יומנים, logging.googleapis.com/user, עם סוג הערך DISTRIBUTION. מידע נוסף זמין בשדה metricDescriptor במאמרי העזרה של Logging API LogMetric.
‫4 אי אפשר להשתמש במדדים מצטברים ישירות ליצירת תרשימים או התראות ב-Monitoring, אבל אפשר לצבור אותם למדדים לא מצטברים שבהם אפשר להשתמש בדרכים האלה. מידע נוסף זמין במאמר סוגים, טיפוסים והמרות.

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

הדמיה של מדדים מותאמים אישית עם ערכי מחרוזת

אי אפשר להשתמש בערכי מחרוזת במדדים מותאמים אישית, אבל אפשר לשכפל את הפונקציונליות של מדדים עם ערכי מחרוזת בדרכים הבאות:

  • יצירת מדד GAUGE באמצעות ערך INT64 כ-enum שממופה לערך מחרוזת. כששולחים שאילתה למדד, צריך לתרגם את ה-enum לערך מחרוזת באופן חיצוני.
  • יוצרים מדד GAUGE עם ערך BOOL ותווית שהערך שלה הוא אחת מהמחרוזות שרוצים לעקוב אחריהן. הערך הבוליאני מציין אם הערך הוא הערך הפעיל.

לדוגמה, נניח שאתם רוצים ליצור מדד עם ערך מחרוזת שנקרא "status" עם האפשרויות OK,‏ OFFLINE או PENDING. אפשר ליצור מדד GAUGE עם תווית בשם status_value. כל עדכון יכתוב שלוש סדרות זמנים, אחת לכל status_value (OK,‏ OFFLINE או PENDING), עם הערך 1 ל-true או 0 ל-false.