במאמר הזה מוסבר איך לקרוא נתוני מדדים, שנקראים גם נתונים של סדרות זמן, באמצעות השיטה timeSeries.list ב-Monitoring API.
במאמר הזה מוסבר איך להשתמש בספריות לקוח כדי לקרוא לשיטה timeSeries.list.
סקירה כללית
כל קריאה לשיטה timeSeries.list יכולה להחזיר כל מספר של סדרות זמן מסוג מדד יחיד. לדוגמה, אם אתם משתמשים ב-Compute Engine, למדד compute.googleapis.com/instance/cpu/usage_time יש סדרת זמן נפרדת לכל אחד מהמופעים של המכונות הווירטואליות.
במאמר מדדים, סדרות זמנים ומשאבים מופיע מבוא למדדים ולסדרות זמנים.
כדי לציין את נתוני הסדרות העיתיות שרוצים, צריך לספק את הפרטים הבאים לשיטה timeSeries.list:
- ביטוי מסנן שמציין את סוג המדד. אפשר גם להשתמש במסנן כדי לבחור קבוצת משנה של סדרת הזמן של המדד על ידי ציון המשאבים שמפיקים את סדרת הזמן או על ידי ציון ערכים לתוויות מסוימות בסדרת הזמן.
- מרווח זמן שמגביל את כמות הנתונים שמוחזרת.
- אפשרות נוספת: ציון של אופן השילוב של כמה סדרות זמן כדי ליצור סיכום מצטבר של הנתונים. מידע נוסף ודוגמאות מופיעים במאמר בנושא צבירת נתונים.
מסננים של נתונים כרונולוגיים
כדי לציין אילו סדרות זמנים לאחזר, מעבירים מסנן סדרות זמנים לשיטה timeSeries.list.
הרשימה הבאה מפרטת את רכיבי המסנן הנפוצים:
המסנן חייב לציין סוג מדד יחיד. לדוגמה:
metric.type = "compute.googleapis.com/instance/cpu/usage_time"כדי לאחזר מדדים שהוגדרו על ידי המשתמש, צריך לשנות את הקידומת metric.type במסנן ל-
custom.googleapis.comאו לקידומת אחרת אם נעשה בה שימוש.external.googleapis.comהיא קידומת נפוצה.במסנן אפשר לציין ערכים לתוויות המאפיינים של המדד. סוג המדד קובע אילו תוויות מוצגות. לדוגמה:
(metric.label.instance_name = "your-instance-id" OR metric.label.instance_name = "your-other-instance-id")בביטוי הקודם,
labelהוא הערך הנכון למרות שאובייקט המדד בפועל משתמש ב-labelsכמפתח שלו.המסנן יכול לבחור רק את סדרות הזמן שמכילות סוג ספציפי של משאב שנמצא במעקב:
resource.type = "gce_instance"
אפשר לשלב את רכיבי המסנן במסנן יחיד של סדרת זמן, כמו בדוגמה הבאה:
metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
(metric.label.instance_name = "your-instance-id" OR
metric.label.instance_name = "your-other-instance-id")
אם לא מציינים ערכים לכל תוויות המדדים, השיטה list מחזירה סדרת זמנים לכל שילוב של ערכים בתוויות שלא צוינו. השיטה מחזירה רק סדרות זמן שיש בהן נתונים.
מרווחי זמן
כשמשתמשים ב-API כדי לקרוא נתונים, צריך לציין את מרווח הזמן שרוצים לאחזר עבורו נתונים על ידי הגדרת שעת התחלה ושעת סיום.
ה-API מאחזר נתונים מהמרווח (start, end], כלומר, מהזמן שאחרי שעת ההתחלה ועד שעת הסיום.
שעת ההתחלה לא יכולה להיות מאוחרת משעת הסיום. אם מציינים שעת התחלה שמאוחרת משעת הסיום, ה-API מחזיר שגיאה.
אם רוצים לאחזר רק נתונים עם חותמת זמן ספציפית, צריך להגדיר את שעת ההתחלה כשווה לשעת הסיום, או לחלופין לא להגדיר את שעת ההתחלה.
פורמט השעה
צריך לציין את זמני ההתחלה והסיום כמחרוזות בפורמט RFC 3339. לדוגמה:
2024-03-01T12:34:56+04:00 2024-03-01T12:34:56.992Z
הפקודה date -Iseconds ב-Linux שימושית ליצירת חותמות זמן.
פעולות בסיסיות ברשימה
אפשר להשתמש בשיטה timeSeries.list כדי להחזיר נתונים גולמיים פשוטים, או כדי להחזיר נתונים שעברו עיבוד מורכב. בקטע הזה מוסבר איך מציגים את סדרות הזמן הזמינות ואיך מקבלים את הערכים בסדרת זמן ספציפית.
דוגמה: הצגת סדרות זמנים זמינות
בדוגמה הזו מוצגות רק השמות והתיאורים של סדרות הזמן שתואמות למסנן, במקום להחזיר את כל הנתונים הזמינים:
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Ruby
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
אם נתקלתם בבעיות, תוכלו להיעזר במאמר פתרון בעיות ב-Monitoring API.
דוגמה: קבלת נתונים של סדרות עיתיות
בדוגמה הזו מוחזרים נתוני השימוש במעבד שתועדו במרווח של 20 דקות במכונה ספציפית של Compute Engine. כמות הנתונים שמוחזרת תלויה בשיעור הדגימה של המדד. מכיוון שהמערכת דוגמת את השימוש במעבד כל דקה, התוצאות של השאילתה הזו הן כ-20 נקודות נתונים. כשמוחזרות כמה נקודות נתונים עבור סדרת זמן, ה-API מחזיר את נקודות הנתונים בכל סדרת זמן בסדר זמן הפוך. אי אפשר לשנות את סדר הנקודות הזה.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Ruby
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
אם נתקלתם בבעיות, תוכלו להיעזר במאמר פתרון בעיות ב-Monitoring API.
צבירת נתונים
שיטת timeSeries.list
יכולה לבצע צבירות סטטיסטיות וצמצומים בנתוני סדרת הזמן שמוחזרים. בקטעים הבאים מוצגות שתי דוגמאות.
מידע נוסף על סינון וצבירה: שינוי של סדרות זמן
דוגמה: יישור של סדרות זמן
בדוגמה הזו, 20 מדידות השימוש הנפרדות בכל סדרת זמן מצטמצמות ל-2 מדידות: השימוש הממוצע בשני פרקי הזמן של 10 דקות בתוך פרק הזמן של 20 דקות. הנתונים מכל סדרת זמן מיושרים קודם לתקופות של 10 דקות, ואז מחושב ממוצע של הערכים בכל תקופה של 10 דקות.
לפעולת ההתאמה יש שני יתרונות: היא מחליקה את הנתונים ומתאימה את הנתונים מכל נתוני הסדרות העיתיות לגבולות מדויקים של 10 דקות. לאחר מכן אפשר לעבד את הנתונים המתאימים.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Ruby
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
אם נתקלתם בבעיות, תוכלו להיעזר במאמר פתרון בעיות ב-Monitoring API.
דוגמה: צמצום בסדרות זמן
בדוגמה הזו אנחנו מרחיבים את הדוגמה הקודמת ומשלבים את סדרות הזמנים המיושרות משלושת המכונות הווירטואליות לסדרת זמן אחת שמודדת את ממוצע השימוש בכל המכונות.
C#
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Go
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Java
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
PHP
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Ruby
כדי לבצע אימות ב-Monitoring, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
אם נתקלתם בבעיות, תוכלו להיעזר במאמר פתרון בעיות ב-Monitoring API.