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

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

• סוג הערך
• סוג המדד

סוג הערך

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

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

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

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

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

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

סוג המדד

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

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

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

  הערה: כל המדדים שסופרים פריטים נפרדים במרווח זמן מסוים הם מדדי דלתא. אפשר לצפות שהערכים האלה יהיו מספרים שלמים, אבל מסיבות היסטוריות של הטמעה, הם מדווחים כמספרים עם נקודה צפה (floating-point).

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

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

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

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

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

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

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

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

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

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

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