ה-method timeSeries.list ב-Monitoring API מאפשרת לאחזר, לסנן ולצבור נתונים גולמיים או מעובדים של סדרות זמנים, במרווח זמן מסוים. אפשר להפעיל את timeSeries.list באמצעות ספריית לקוח ספציפית לשפה.
סקירה כללית
כל קריאה ל-method timeSeries.list יכולה להחזיר מספר כלשהו של סדרות זמן מסוג מדד אחד. לדוגמה, אם אתם משתמשים ב-Compute Engine, לסוג המדד compute.googleapis.com/instance/cpu/usage_time יש סדרת נתונים נפרדת לכל אחת מהמכונות הווירטואליות.
למבוא על מדדים וסדרות זמנים, ראו מדדים, סדרות זמנים ומשאבים.
כדי לציין את נתוני סדרת הזמנים שרוצים, מספקים את הפרטים הבאים ל-method timeSeries.list:
- ביטוי סינון שמציין את סוג המדד. אפשר גם להשתמש במסנן כדי לבחור קבוצת משנה של סדרות הזמנים של המדד, על ידי ציון המשאבים שיוצרים את סדרות הזמנים או ציון ערכים של תוויות מסוימות בסדרות הזמנים.
- מרווח זמן שמגביל את כמות הנתונים שמוחזרים.
- אפשרות להגדיר איך לשלב כמה סדרות זמנים כדי ליצור סיכום מצטבר של הנתונים. למידע נוסף ולדוגמאות, קראו את המאמר צבירת נתונים.
מסננים של סדרות זמנים
כדי לציין את סדרות הזמנים שרוצים לאחזר, מעבירים מסנן של סדרות זמנים ל-method 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.
דוגמה: קבלת נתונים של סדרת זמנים
בדוגמה הזו מוחזרות מדידות של ניצול ה-CPU שתועדו במרווח זמן של 20 דקות במכונה ספציפית של Compute Engine. כמות הנתונים שמוחזרת תלויה בתדירות הדגימה של המדד. מכיוון שהשימוש ב-CPU נדגם כל דקה, התוצאה של השאילתה הזו היא כ-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.
המאמרים הבאים
- מידע ולמידה על שמירה וזמן אחזור של נתוני מדדים
- מידע ולמידה על סינון וצבירה: שינוי של סדרות זמנים