Package google.monitoring.v3

אינדקס

• ‫Point (הודעה)
• ‫TimeInterval (הודעה)
• ‫TimeSeries (הודעה)
• ‫TypedValue (הודעה)

נקודה

נקודת נתונים יחידה בסדרת זמן.

שדות
interval	TimeInterval מרווח הזמן שאליו מתייחסת נקודת הנתונים. במקרה של מדדי GAUGE, שעת ההתחלה היא אופציונלית, אבל אם מציינים אותה, היא חייבת להיות שווה לשעת הסיום. במקרה של מדדי DELTA, זמני ההתחלה והסיום צריכים לציין מרווח זמן שאינו אפס, ונקודות עוקבות צריכות לציין מרווחי זמן רציפים שלא חופפים. במקרה של מדדי CUMULATIVE, שעת ההתחלה ושעת הסיום צריכות לציין מרווח זמן שאינו אפס, כאשר הנקודות הבאות מציינות את אותה שעת התחלה ושעות סיום הולכות וגדלות, עד שאירוע מאפס את הערך המצטבר לאפס ומגדיר שעת התחלה חדשה לנקודות הבאות.
value	TypedValue הערך של נקודה על הגרף.

TimeInterval

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

שדות
end_time	Timestamp חובה. סוף מרווח הזמן.
start_time	Timestamp זה שינוי אופציונלי. תחילת מרווח הזמן. ערך ברירת המחדל של שעת ההתחלה הוא שעת הסיום. שעת ההתחלה לא יכולה להיות מאוחרת משעת הסיום.

TimeSeries

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

שדות
metric	Metric המדד המשויך. מדד שצוין באופן מלא ומשמש לזיהוי סדרת הזמנים.
resource	MonitoredResource המשאב המשויך במעקב. במדדים בהתאמה אישית אפשר להשתמש רק בסוגים מסוימים של משאבים במעקב בנתוני הסדרות העיתיות שלהם. מידע נוסף זמין במאמר משאבים במעקב למדדים מותאמים אישית.
metadata	MonitoredResourceMetadata פלט בלבד. המטא-נתונים של המשאב במעקב שמשויך לנתונים. כשקוראים סדרת זמן, השדה הזה יכלול תוויות של מטא-נתונים שצוינו במפורש בצמצום. כשיוצרים סדרת זמן, המערכת מתעלמת מהשדה הזה.
metric_kind	MetricKind סוג המדד של הסדרה העיתית. כשמפרטים סדרות זמן, סוג המדד הזה עשוי להיות שונה מסוג המדד של המדד המשויך אם סדרת הזמן הזו היא יישור או צמצום של סדרות זמן אחרות. כשיוצרים סדרת נתונים כרונולוגית, השדה הזה הוא אופציונלי. אם הוא קיים, הוא חייב להיות זהה לסוג המדד המשויך. אם צריך ליצור אוטומטית את המתאר של המדד המשויך, השדה הזה מציין את סוג המדד של המתאר החדש, והוא חייב להיות GAUGE (ברירת המחדל) או CUMULATIVE.
value_type	ValueType סוג הערך של סדרת הזמן. כשמציגים רשימה של סדרות זמן, סוג הערך הזה עשוי להיות שונה מסוג הערך של המדד המשויך אם סדרת הזמן הזו היא יישור או צמצום של סדרות זמן אחרות. כשיוצרים סדרת נתונים כרונולוגית, השדה הזה הוא אופציונלי. אם מציינים ערך בשדה הזה, הוא חייב להיות זהה לסוג הנתונים בשדה points.
points[]	Point נקודות הנתונים של סדרת הזמן הזו. כשמציגים סדרות זמן, הנקודות מוחזרות בסדר זמן הפוך. כשיוצרים סדרת זמן, השדה הזה חייב להכיל בדיוק נקודה אחת, והסוג של הנקודה חייב להיות זהה לסוג הערך של המדד המשויך. אם צריך ליצור אוטומטית את תיאור המדד המשויך, סוג הערך של התיאור נקבע לפי סוג הנקודה, שחייב להיות BOOL, INT64, DOUBLE או DISTRIBUTION.
unit	string היחידות שבהן מדווח ערך המדד. התנאי הזה רלוונטי רק אם הערך של value_type הוא INT64,‏ DOUBLE או DISTRIBUTION. התג unit מגדיר את הייצוג של ערכי המדדים המאוחסנים. אפשר לשנות את השדה הזה רק באמצעות CreateTimeSeries כשהוא ריק.
description	string קלט בלבד. תיאור מפורט של סדרת הזמן שתשויך ל-google.api.MetricDescriptor של המדד. אחרי שמגדירים את השדה הזה, אי אפשר לשנות אותו באמצעות CreateTimeSeries.

TypedValue

ערך יחיד עם הקלדה חזקה.

שדות
שדה איחוד value. שדה הערך שהוקלד. הערך value יכול להיות רק אחד מהבאים:
bool_value	bool ערך בוליאני: true או false.
int64_value	int64 מספר שלם ב-64 ביט. הטווח שלו הוא בערך ‎±9.2x10^18.
double_value	double מספר בשיטת נקודה צפה (floating-point) עם דיוק כפול של 64 ביט. הגודל שלו הוא בערך ‎±10^±300 ויש לו 16 ספרות משמעותיות של דיוק.
string_value	string ערך מחרוזת באורך משתנה.
distribution_value	Distribution ערך התפלגות.