REST Resource: vitals.stuckbackgroundwakelockrate

משאב: StuckBackgroundWakelockRateMetricSet

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

קבוצת המדדים הזו מכילה נתונים על משך הזמן של נעילת המכשיר במצב פעיל (wakelock) ב-PowerManager, בשילוב עם נתונים על מצב התהליך, כדי ליצור מדד מנורמל שלא תלוי במספר המשתמשים.

תקופות צבירת נתונים נתמכות:

  • ‫DAILY: המדדים מצטברים במרווחי תאריכים ביומן. בגלל אילוצים היסטוריים, אזור הזמן היחיד שנתמך הוא America/Los_Angeles.

מדדים נתמכים:

  • ‫stuckBgWakelockRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהאפליקציה שלהם חסמה מצב שינה ברקע למשך יותר משעה.
  • ‫stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ערך הממוצע הנע של stuckBgWakelockRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ערך הממוצע הנע של stuckBgWakelockRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך נורמליזציה למדד stuckBgWakelockRate. משתמש נספר במדד הזה אם האפליקציה שלו ביצעה פעולות כלשהן במכשיר, כלומר לא רק שימוש פעיל בחזית אלא גם פעולות ברקע. חשוב להיזהר ולא לצבור את הספירה הזו, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם לגודל הערך.

מידות נתמכות:

  • ‫apiLevel (string): רמת ה-API של Android שפעלה במכשיר של המשתמש, למשל 26.
  • ‫versionCode (int64): גרסת האפליקציה שהופעלה במכשיר של המשתמש.
  • ‫deviceModel (string): מזהה ייחודי של דגם המכשיר של המשתמש. הפורמט של המזהה הוא deviceBrand/device, כאשר deviceBrand תואם ל-Build.BRAND ו-device תואם ל-Build.DEVICE, לדוגמה, google/coral.
  • ‫deviceBrand (string): מזהה ייחודי של מותג המכשיר של המשתמש, למשל google.
  • ‫deviceType (string): הסוג (שנקרא גם גורם צורה) של המכשיר של המשתמש, למשל, PHONE.
  • ‫countryCode (string): המדינה או האזור של המכשיר של המשתמש על סמך כתובת ה-IP שלו, שמיוצגים כקוד ISO-3166 עם 2 אותיות (למשל US לארצות הברית).
  • ‫deviceRamBucket (int64): RAM של המכשיר, ב-MB, בדליים (למשל, 1024 ל-‎1-1.5GB, ‏ 4096 ל-‎4-6GB).
  • ‫deviceSocMake (string): יצרן המערכת הראשית על שבב (SoC) של המכשיר, למשל Samsung. חומרי עזר
  • ‫deviceSocModel (string): דגם של המערכת הראשית על שבב (SoC) של המכשיר, לדוגמה, Exynos 2100. חומרי עזר
  • ‫deviceCpuMake (string): יצרן המעבד של המכשיר, למשל Qualcomm.
  • ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל, Kryo 240.
  • ‫deviceGpuMake (string): סוג ה-GPU של המכשיר, למשל ARM.
  • ‫deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל Mali.
  • ‫deviceGpuVersion (string): גרסת המעבד הגרפי של המכשיר, למשל T750.
  • ‫deviceVulkanVersion (string): גרסת Vulkan של המכשיר, למשל '4198400'.
  • ‫deviceGlEsVersion (string): גרסת OpenGL ES של המכשיר, לדוגמה, '196610'.
  • ‫deviceScreenSize (string): גודל המסך של המכשיר, למשל: NORMAL,‏ LARGE.
  • ‫deviceScreenDpi (string): צפיפות המסך של המכשיר, למשל mdpi,‏ hdpi.

הרשאות נדרשות: כדי לגשת למשאב הזה, למשתמש שמבצע את הקריאה נדרשת ההרשאה הצגת פרטי האפליקציה (לקריאה בלבד) לאפליקציה.

ייצוג JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
שדות
name

string

מזהה. שם המשאב

פורמט: apps/{app}/stuckBackgroundWakelockRateMetricSet
freshnessInfo

object (FreshnessInfo)

סיכום לגבי עדכניות הנתונים במשאב הזה.

Methods

get

 תיאור המאפיינים של קבוצת המדדים.

query

 השאילתה מחפשת את המדדים בקבוצת המדדים.