REST Resource: customers.telemetry.devices

משאב: TelemetryDevice

נתוני טלמטריה שנאספים ממכשיר מנוהל.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE
ייצוג ב-JSON 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
שדות
name

string

פלט בלבד. שם המשאב של המכשיר.
customer

string

פלט בלבד. לקוח Google Workspace שהארגון שלו רשם את המכשיר.
orgUnitId

string

פלט בלבד. מזהה היחידה הארגונית של המכשיר.
deviceId

string

פלט בלבד. המזהה הייחודי של המכשיר ב-Directory API. הערך הזה זהה למזהה Directory API במסוף Admin בכרטיסייה 'מכשירי ChromeOS'.
serialNumber

string

פלט בלבד. המספר הסידורי של המכשיר. הערך הזה זהה למספר הסידורי במסוף Admin בכרטיסייה 'מכשירי ChromeOS'.
cpuInfo[]

object (CpuInfo)

פלט בלבד. מידע על מפרט המעבד של המכשיר.
cpuStatusReport[]

object (CpuStatusReport)

פלט בלבד. דוחות סטטוס של המעבד שנאספים מעת לעת, ממוינים בסדר יורד לפי reportTime.
memoryInfo

object (MemoryInfo)

פלט בלבד. מידע על מפרט הזיכרון של המכשיר.
memoryStatusReport[]

object (MemoryStatusReport)

פלט בלבד. דוחות על סטטוס הזיכרון שנאספים מדי פעם, ממוינים בסדר יורד לפי reportTime.
networkInfo

object (NetworkInfo)

פלט בלבד. מידע על מכשירים ברשת.
networkStatusReport[]

object (NetworkStatusReport)

פלט בלבד. מפרטי הרשת נאספים מעת לעת.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

פלט בלבד. נתוני אבחון הרשת נאספים מעת לעת.
osUpdateStatus[]

object (OsUpdateStatus)

פלט בלבד. מכיל מידע רלוונטי לגבי סטטוס העדכון של ChromeOS.
graphicsInfo

object (GraphicsInfo)

פלט בלבד. מכיל מידע לגבי ציוד היקפי גרפי למכשיר.
graphicsStatusReport[]

object (GraphicsStatusReport)

פלט בלבד. דוחות גרפיים שנאספים מדי פעם.
batteryInfo[]

object (BatteryInfo)

פלט בלבד. מידע על מפרטי הסוללה של המכשיר.
batteryStatusReport[]

object (BatteryStatusReport)

פלט בלבד. דוחות הסוללה נאספים מדי פעם.
storageInfo

object (StorageInfo)

פלט בלבד. מידע על מפרטי האחסון של המכשיר.
storageStatusReport[]

object (StorageStatusReport)

פלט בלבד. דוחות אחסון שנאספים מדי פעם.
thunderboltInfo[]

object (ThunderboltInfo)

פלט בלבד. מידע על אפיק Thunderbolt.
audioStatusReport[]

object (AudioStatusReport)

פלט בלבד. דוחות אודיו שנאספים מעת לעת, ממוינים בסדר יורד לפי reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

פלט בלבד. דוחות על ביצועי האתחול של המכשיר.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

פלט בלבד. דוח סטטוס של פעימות לב שמכיל חותמות זמן שממוינות מעת לעת בסדר יורד של reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

פלט בלבד. דוח סטטוס של אפליקציית קיוסק למכשיר קיוסק
networkBandwidthReport[]

object (NetworkBandwidthReport)

פלט בלבד. דוחות רוחב פס ברשת שנאספים מעת לעת וממוינים בסדר יורד של reportTime.
peripheralsReport[]

object (PeripheralsReport)

פלט בלבד. דוחות על ציוד היקפי שנאספים מדי פעם וממוינים בסדר יורד של reportTime.
appReport[]

object (AppReport)

פלט בלבד. דוחות האפליקציה נאספים מדי פעם וממוינים בסדר יורד של reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

פלט בלבד. בדוחות של מוני זמן ריצה מופיע זמן הריצה של המכשיר לאורך חייו, וגם מספר המעברים בין המצבים S0->S3,‏ S0->S4 ו-S0->S5, כלומר מעברים למצבי שינה, תרדמה וכיבוי

CpuInfo

מפרט המעבד (CPU) של המכשיר

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_CPU_INFO
ייצוג ב-JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
שדות
model

string

פלט בלבד. שם הדגם של המעבד. דוגמה: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
architecture

enum (Architecture)

פלט בלבד. סוג הארכיטקטורה של יחידת העיבוד המרכזית (CPU).

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
maxClockSpeed

integer

פלט בלבד. מהירות השעון המקסימלית של המעבד בקילוהרץ.
keylockerSupported

boolean

פלט בלבד. האם יש תמיכה ב-Key locker.
keylockerConfigured

boolean

פלט בלבד. אם Keylocker מוגדר.‫TRUE = מופעל; FALSE = מושבת. הערך הזה מדווח רק אם keylockerSupported = TRUE.

ארכיטקטורה

סוג הארכיטקטורה של יחידת העיבוד המרכזית (CPU).

טיפוסים בני מנייה (enum)
ARCHITECTURE_UNSPECIFIED הארכיטקטורה לא ידועה.
X64 ארכיטקטורת x64

CpuStatusReport

מספק מידע על סטטוס המעבד.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: כל 10 דקות
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_CPU_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן באלפיות השנייה שמייצגת את השעה שבה הדוח הזה נדגם.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

פלט בלבד. התדירות שבה מתבצעת דגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
cpuUtilizationPct

integer

פלט בלבד. דוגמה לניצול יחידת העיבוד המרכזית (0-100 אחוזים).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

פלט בלבד. פרטי דגימה של טמפרטורת המעבד (CPU) לכל ליבת מעבד במעלות צלזיוס

CpuTemperatureInfo

טמפרטורת המעבד (CPU) של מכשיר. הדגימה מתבצעת לכל ליבת מעבד במעלות צלזיוס.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: כל 10 דקות
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
ייצוג ב-JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
שדות
temperatureCelsius

integer

פלט בלבד. טמפרטורה של יחידת עיבוד מרכזית (CPU) במעלות צלזיוס.
label

string

פלט בלבד. תווית של יחידת עיבוד מרכזית (CPU). דוגמה: Core 0

MemoryInfo

מידע על הזיכרון של המכשיר.

  • בשדה הזה יש נתוני טלמטריה ופרטי מכשיר:
    • ‫totalRamBytes - פרטי המכשיר
    • ‫availableRamBytes – מידע על טלמטריה
    • ‫totalMemoryEncryption - פרטי המכשיר
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים:
    • ‫totalRamBytes – רק בזמן ההעלאה
    • ‫availableRamBytes – כל 10 דקות
    • ‫totalMemoryEncryption – בהפעלת המכשיר
  • תדירות הדיווח על נתונים שמוגדרת כברירת מחדל:
    • ‫totalRamBytes - 3 שעות
    • ‫availableRamBytes - 3 שעות
    • ‫totalMemoryEncryption – בהפעלת המכשיר
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספו נשמרים באופן מקומי, ויועברו כשיהיה אונליין: רק ל-totalMemoryEncryption
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_MEMORY_INFO
ייצוג ב-JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
שדות
totalRamBytes

string (int64 format)

פלט בלבד. סה"כ RAM בבייטים.
availableRamBytes

string (int64 format)

פלט בלבד. כמות ה-RAM הזמין בבייטים.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

פלט בלבד. מידע על הצפנת הזיכרון הכוללת של המכשיר.

TotalMemoryEncryptionInfo

מידע על הצפנת הזיכרון של המכשיר.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל של דיווח הנתונים: בהפעלת המכשיר
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא רלוונטי
ייצוג ב-JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
שדות
encryptionState

enum (MemoryEncryptionState)

המצב של הצפנת הזיכרון במכשיר.
maxKeys

string (int64 format)

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

string (int64 format)

האורך של מפתחות ההצפנה.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

אלגוריתם להצפנת זיכרון.

MemoryEncryptionState

המצב של הצפנת הזיכרון במכשיר.

טיפוסים בני מנייה (enum)
MEMORY_ENCRYPTION_STATE_UNSPECIFIED מצב הצפנת הזיכרון לא מוגדר.
MEMORY_ENCRYPTION_STATE_UNKNOWN מצב ההצפנה של הזיכרון לא ידוע.
MEMORY_ENCRYPTION_STATE_DISABLED ההצפנה של הזיכרון במכשיר מושבתת.
MEMORY_ENCRYPTION_STATE_TME הצפנת הזיכרון במכשיר משתמשת בהצפנת זיכרון כוללת.
MEMORY_ENCRYPTION_STATE_MKTME הצפנת הזיכרון במכשיר מתבצעת באמצעות הצפנת זיכרון כוללת של מספר מפתחות.

MemoryEncryptionAlgorithm

אלגוריתם ההצפנה שבו נעשה שימוש במכשיר.

טיפוסים בני מנייה (enum)
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED לא הוגדר אלגוריתם להצפנת הזיכרון.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN אלגוריתם הצפנת הזיכרון שבו נעשה שימוש לא ידוע.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 אלגוריתם הצפנת הזיכרון משתמש באלגוריתם ההצפנה AES_XTS עם הצפנת בלוק של 128 ביט.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 אלגוריתם הצפנת הזיכרון משתמש באלגוריתם ההצפנה AES_XTS עם הצפנת בלוק של 256 ביט.

MemoryStatusReport

מכיל דוגמאות לדוחות על סטטוס הזיכרון.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים: רק בהעלאה, המערכת אוספת את SystemRamFreeByes כל 10 דקות
  • תדירות דיווח הנתונים שמוגדרת כברירת מחדל: כל 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_MEMORY_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן באלפיות השנייה שמייצגת את השעה שבה הדוח הזה נדגם.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

פלט בלבד. התדירות שבה מתבצעת דגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
systemRamFreeBytes

string (int64 format)

פלט בלבד. כמות ה-RAM הפנוי בבייטים (לא אמין בגלל איסוף אשפה).
pageFaults

integer

פלט בלבד. מספר השגיאות בדפים במהלך האיסוף הזה

NetworkInfo

פרטי המכשיר ברשת.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportNetworkDeviceConfiguration
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל של דיווח הנתונים: בהפעלת המכשיר
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_INFO
ייצוג ב-JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
שדות
networkDevices[]

object (NetworkDevice)

פלט בלבד. רשימה של מכשירים ברשת.

NetworkDevice

פרטים על מכשיר הרשת.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportNetworkDeviceConfiguration
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל של דיווח הנתונים: בהפעלת המכשיר
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא רלוונטי
ייצוג ב-JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
שדות
type

enum (NetworkDeviceType)

פלט בלבד. סוג מכשיר הרשת.
macAddress

string

פלט בלבד. כתובת ה-MAC (אם רלוונטי) של מכשיר הרשת המתאים.
meid

string

פלט בלבד. מספר ה-MEID (אם רלוונטי) של מכשיר הרשת המתאים.
imei

string

פלט בלבד. מזהה ה-IMEI (אם רלוונטי) של מכשיר הרשת המתאים.
iccid

string

פלט בלבד. מזהה כרטיס המעגל המשולב שמשויך לכרטיס ה-SIM של המכשיר.
mdn

string

פלט בלבד. מספר הטלפון הנייד שמשויך לכרטיס ה-SIM של המכשיר.

NetworkDeviceType

סוגים של מכשירים ברשת.

טיפוסים בני מנייה (enum)
NETWORK_DEVICE_TYPE_UNSPECIFIED לא צוין סוג מכשיר הרשת.
CELLULAR_DEVICE מכשיר סלולרי.
ETHERNET_DEVICE מכשיר אתרנט.
WIFI_DEVICE מכשיר Wi-Fi.

NetworkStatusReport

המצב של רשתות גלויות או מוגדרות.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportNetworkStatus
  • תדירות איסוף הנתונים: 60 דקות
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • האם האירוע מדווח רק למשתמשים משויכים: כן
  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. השעה שבה דווח מצב הרשת.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

פלט בלבד. התדירות שבה מתבצעת דגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
signalStrengthDbm

integer

פלט בלבד. עוצמת האות של רשתות אלחוטיות שנמדדת בדציבלים.
lanIpAddress

string

פלט בלבד. כתובת IP ברשת LAN.
gatewayIpAddress

string

פלט בלבד. כתובת ה-IP של השער.
transmissionBitRateMbps

string (int64 format)

פלט בלבד. קצב העברת הנתונים בשידור, שנמדד במגה-ביט לשנייה.
receivingBitRateMbps

string (int64 format)

פלט בלבד. קצב העברת הנתונים המתקבל, שנמדד במגה-ביט לשנייה.
transmissionPowerDbm

integer

פלט בלבד. עוצמת השידור נמדדת בדציבלים.
encryptionOn

boolean

פלט בלבד. האם מפתח ההצפנה של ה-Wi-Fi מושבת.
wifiPowerManagementEnabled

boolean

פלט בלבד. ניהול צריכת החשמל של ה-Wi-Fi מופעל
guid

string

פלט בלבד. ‫GUID של חיבור לרשת.
connectionState

enum (NetworkConnectionState)

פלט בלבד. מצב החיבור הנוכחי של הרשת.
connectionType

enum (NetworkType)

פלט בלבד. סוג החיבור לרשת.
ipv6Address[]

string

פלט בלבד. כתובות IPv6 שהוקצו לרשת הזו, אם יש כאלה. כל כתובת היא מחרוזת בייצוג טקסט סטנדרטי של IPv6 (למשל, '2001:db8::1').
gatewayIpv6Address

string

פלט בלבד. כתובת ה-IPv6 של השער עבור הממשק הזה, אם היא מזוהה
metered

boolean

פלט בלבד. האם הרשת זוהתה כרשת מוגבלת.

NetworkType

סוגי החיבור לרשת.

טיפוסים בני מנייה (enum)
NETWORK_TYPE_UNSPECIFIED לא צוין סוג החיבור לרשת
CELLULAR חיבור לרשת סלולרית.
ETHERNET חיבור לרשת אתרנט.
TETHER שיתוף חיבור לרשת.
VPN חיבור לרשת VPN.
WIFI חיבור לרשת Wi-Fi.

NetworkDiagnosticsReport

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

  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן שבה נאספו נתוני האבחון.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

פלט בלבד. נתונים של בדיקת זמן האחזור של HTTPS.

OsUpdateStatus

כולל מידע על הסטטוס הנוכחי של עדכון מערכת ההפעלה.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceOsUpdateStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_OS_REPORT
ייצוג ב-JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
שדות
updateState

enum (UpdateState)

פלט בלבד. המצב הנוכחי של עדכון מערכת ההפעלה.
newPlatformVersion

string

פלט בלבד. מתבצעת הורדה של גרסה חדשה של פלטפורמת תמונת מערכת ההפעלה והחלתה. המאפיין הזה מוגדר רק כשהסטטוס של העדכון הוא OS_IMAGE_DOWNLOAD_IN_PROGRESS או OS_UPDATE_NEED_REBOOT. הערה: יכול להיות שזו כתובת פיקטיבית '0.0.0.0' לסטטוס OS_UPDATE_NEED_REBOOT במקרים קיצוניים מסוימים, למשל אם מנוע העדכון מופעל מחדש בלי הפעלה מחדש.
newRequestedPlatformVersion

string

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

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון שבוצע בהצלחה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של בדיקת העדכון האחרונה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של ההפעלה מחדש האחרונה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

UpdateState

מצב העדכון של מערכת ההפעלה

טיפוסים בני מנייה (enum)
UPDATE_STATE_UNSPECIFIED הסטטוס לא צוין.
OS_IMAGE_DOWNLOAD_NOT_STARTED ההורדה של מערכת ההפעלה לא התחילה.
OS_IMAGE_DOWNLOAD_IN_PROGRESS הורדת מערכת ההפעלה החלה במכשיר.
OS_UPDATE_NEED_REBOOT צריך להפעיל מחדש את המכשיר כדי לסיים את ההעלאה.

GraphicsInfo

מידע על מערכת המשנה של הגרפיקה.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceGraphicsStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_GRAPHICS_INFO
ייצוג ב-JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
שדות
adapterInfo

object (GraphicsAdapterInfo)

פלט בלבד. מידע על מתאם הגרפיקה (GPU).
eprivacySupported

boolean

פלט בלבד. האם מסך הפרטיות האלקטרונית נתמך או לא.
displayDevices[]

object (DisplayDevice)

פלט בלבד. מידע על המסכים של המכשיר.
touchScreenInfo

object (TouchScreenInfo)

פלט בלבד. מידע על מסכי המגע הפנימיים של המכשיר.

GraphicsAdapterInfo

פרטים של מתאם גרפיקה (GPU).

ייצוג ב-JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
שדות
adapter

string

פלט בלבד. שם המתאם. דוגמה: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

פלט בלבד. גרסת מנהל ההתקן של ה-GPU.
deviceId

string (int64 format)

פלט בלבד. מייצג את מזהה המכשיר של כרטיס המסך.

DisplayDevice

מידע על מכשיר תצוגה.

ייצוג ב-JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
שדות
displayName

string

פלט בלבד. השם המוצג של המכשיר.
displayWidthMm

integer

פלט בלבד. רוחב התצוגה במילימטרים.
displayHeightMm

integer

פלט בלבד. גובה המסך במילימטרים.
internal

boolean

פלט בלבד. האם התצוגה פנימית או לא.
manufacturerId

string

פלט בלבד. מזהה היצרן בן שלוש האותיות.
modelId

integer

פלט בלבד. קוד המוצר של היצרן.
manufactureYear

integer

פלט בלבד. שנת הייצור.
serialNumber

integer

פלט בלבד. מספר סידורי.
edidVersion

string

פלט בלבד. גרסת EDID.

TouchScreenInfo

מידע על מסך המגע של המכשיר.

ייצוג ב-JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
שדות
touchpadLibrary

string

פלט בלבד. שם ספריית לוח המגע שבה נעשה שימוש במערכת הקלט.
devices[]

object (TouchScreenDevice)

פלט בלבד. רשימה של מכשירים פנימיים עם מסך מגע.

TouchScreenDevice

מידע על מכשיר פנימי עם מסך מגע.

ייצוג ב-JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
שדות
displayName

string

פלט בלבד. השם המוצג של מכשיר עם מסך מגע.
touchPointCount

integer

פלט בלבד. מספר נקודות הנגיעה שהמכשיר תומך בהן.
stylusCapable

boolean

פלט בלבד. האם מכשיר עם מסך מגע תומך בעט סטיילוס.

GraphicsStatusReport

מידע על מערכת המשנה של הגרפיקה.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceGraphicsInfo
  • תדירות איסוף הנתונים: 3 שעות.
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_GRAPHICS_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. השעה שבה דווחו נתוני הגרפיקה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

פלט בלבד. מידע על המסכים של המכשיר.

DisplayInfo

מידע על תצוגה.

ייצוג ב-JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
שדות
deviceId

string (int64 format)

פלט בלבד. מייצג את מזהה המכשיר של כרטיס המסך.
resolutionWidth

integer

פלט בלבד. רוחב הרזולוציה בפיקסלים.
resolutionHeight

integer

פלט בלבד. גובה הרזולוציה בפיקסלים.
refreshRate

integer

פלט בלבד. קצב רענון בהרץ.
isInternal

boolean

פלט בלבד. מציין אם התצוגה היא פנימית או לא.
displayName

string

פלט בלבד. השם המוצג של המכשיר.
serialNumber

integer

פלט בלבד. מספר סידורי.
edidVersion

string

פלט בלבד. גרסת EDID.

BatteryInfo

מידע על הסוללה.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_BATTERY_INFO
ייצוג ב-JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
שדות
serialNumber

string

פלט בלבד. המספר הסידורי של הסוללה.
manufacturer

string

פלט בלבד. יצרן הסוללה.
designCapacity

string (int64 format)

פלט בלבד. קיבולת העיצוב (מיליאמפר-שעה).
designMinVoltage

integer

פלט בלבד. מתח יציאה מינימלי מתוכנן (mV)
manufactureDate

object (Date)

פלט בלבד. התאריך שבו הסוללה יוצרה.
technology

string

פלט בלבד. טכנולוגיית הסוללה. דוגמה: Li-ion

BatteryStatusReport

נתוני סטטוס של הסוללה.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • הרשאה מפורטת שנדרשת: TELEMETRY_API_BATTERY_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של איסוף הדגימה במכשיר

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
serialNumber

string

פלט בלבד. המספר הסידורי של הסוללה.
sample[]

object (BatterySampleReport)

פלט בלבד. נתוני הדגימה של הסוללה ממוינים בסדר יורד של reportTime.
batteryHealth

enum (BatteryHealth)

פלט בלבד. תקינות הסוללה.
fullChargeCapacity

string (int64 format)

פלט בלבד. קיבולת טעינה מלאה (מיליאמפר-שעה).
cycleCount

integer

פלט בלבד. מספר מחזורי הטעינה.

BatterySampleReport

דגימת נתוני הסוללה.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
ייצוג ב-JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של איסוף הדגימה במכשיר

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

פלט בלבד. מתח הסוללה (מיליוולט).
remainingCapacity

string (int64 format)

פלט בלבד. הקיבולת שנותרה בסוללה (מיליאמפר-שעה).
temperature

integer

פלט בלבד. הטמפרטורה במעלות צלזיוס.
dischargeRate

integer

פלט בלבד. שיעור הפריקה של הסוללה שנמדד במילי-ואט (mW). חיובי אם הסוללה מתרוקנת, שלילי אם היא נטענת.
chargeRate

integer

פלט בלבד. אחוז הטעינה של הסוללה.
current

string (int64 format)

פלט בלבד. זרם הסוללה (mA).
status

string

פלט בלבד. קריאת סטטוס הסוללה מ-sysfs. דוגמה: פריקה

BatteryHealth

מייצג את התקינות הנוכחית של הסוללה.

  • הסטטוס הזה לא מציין שהסוללה פגומה. הוא מחושב על ידי חלוקת הקיבולת הנוכחית של הטעינה המלאה בקיבולת התכנון.
  • היצרן הוא זה שמגדיר את תקינות הסוללה ואת מדיניות האחריות.
טיפוסים בני מנייה (enum)
BATTERY_HEALTH_UNSPECIFIED מצב הבריאות לא ידוע.
BATTERY_HEALTH_NORMAL הסוללה תקינה, קיבולת הטעינה המלאה / קיבולת העיצוב > 80%
BATTERY_REPLACE_SOON מצב הסוללה בינוני, מומלץ להחליף אותה בקרוב. קיבולת טעינה מלאה / קיבולת מתוכננת 75% - 80%
BATTERY_REPLACE_NOW הסוללה לא תקינה ומומלץ להחליף אותה. קיבולת הטעינה המלאה חלקי הקיבולת המתוכננת קטנה מ-75%

StorageInfo

נתוני סטטוס של האחסון.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceStorageStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_STORAGE_INFO
ייצוג ב-JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
שדות
volume[]

object (DiskVolume)

מידע על נפחי דיסק
availableDiskBytes

string (int64 format)

הנפח שזמין לאחסון נתוני משתמשים במכשיר, בבייטים.
totalDiskBytes

string (int64 format)

הנפח הכולל לאחסון נתוני משתמשים במכשיר בבייטים.

DiskVolume

מידע על נפחי דיסק

ייצוג ב-JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
שדות
volumeId

string

מזהה נפח הדיסק.
storageFreeBytes

string (int64 format)

נפח האחסון הפנוי בבייטים.
storageTotalBytes

string (int64 format)

נפח האחסון הכולל בבייטים.

StorageStatusReport

נתוני סטטוס של האחסון.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceStorageStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_STORAGE_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של איסוף הדגימה במכשיר

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

פלט בלבד. דוחות בדיסק.

DiskInfo

הסטטוס של התקן אחסון יחיד.

ייצוג ב-JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
שדות
serialNumber

string

פלט בלבד. המספר הסידורי של הדיסק.
manufacturer

string

פלט בלבד. יצרן הדיסק.
model

string

פלט בלבד. דגם הדיסק.
sizeBytes

string (int64 format)

פלט בלבד. גודל הדיסק.
type

string

פלט בלבד. סוג הדיסק: eMMC / NVMe / ATA / SCSI.
health

string

פלט בלבד. תקינות הדיסק.
volumeIds[]

string

פלט בלבד. נפחי דיסק.
bytesReadThisSession

string (int64 format)

פלט בלבד. מספר הבייטים שנקראו מאז ההפעלה האחרונה.
bytesWrittenThisSession

string (int64 format)

פלט בלבד. מספר הבייטים שנכתבו מאז ההפעלה האחרונה.
readTimeThisSession

string (Duration format)

פלט בלבד. הזמן שחלף מאז ההפעלה האחרונה של המחשב, שבו המחשב קרא מהדיסק.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
writeTimeThisSession

string (Duration format)

פלט בלבד. הזמן שחלף מאז ההפעלה האחרונה של המחשב, שבו המחשב כתב לדיסק.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
ioTimeThisSession

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
discardTimeThisSession

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".

ThunderboltInfo

פרטים של אפיק Thunderbolt.

  • בשדה הזה מופיע מידע על המכשיר, שהוא סטטי ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceSecurityStatus
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל של דיווח הנתונים: בהפעלת המכשיר
    • מבוקר על ידי מדיניות: לא
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_BUS_DEVICE_INFO
ייצוג ב-JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
שדות
securityLevel

enum (ThunderboltSecurityLevel)

רמת האבטחה של Thunderbolt bus.

ThunderboltSecurityLevel

רמת האבטחה של Thunderbolt bus.

טיפוסים בני מנייה (enum)
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED רמת האבטחה של Thunderbolt לא מוגדרת.
THUNDERBOLT_SECURITY_NONE_LEVEL הקושחה מחברת את כל המכשירים באופן אוטומטי. לא נדרש אישור מהמשתמש.
THUNDERBOLT_SECURITY_USER_LEVEL המשתמש נשאל אם מותר לחבר את המכשיר.
THUNDERBOLT_SECURITY_SECURE_LEVEL המשתמש נשאל אם מותר לחבר את המכשיר. בנוסף, למכשיר נשלחת שאלה שאמורה להתאים למה שצפוי על סמך מפתח אקראי שנכתב למאפיין key sysfs
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL הקושחה יוצרת אוטומטית מנהרות ל-Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL הקושחה יוצרת אוטומטית מנהרות עבור בקר ה-USB ויציאת DisplayPort במעגן. כל קישורי ה-PCIe במורד הזרם של תחנת העגינה מוסרים.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL מנהור PCIE מושבת.

BootPerformanceReport

דוח ביצועי האתחול של מכשיר.

  • השדה הזה מכיל מידע טלמטרי, והוא ישתנה לאורך זמן ככל שהמכשיר יהיה בשימוש.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceBootMode
  • תדירות איסוף הנתונים: בכל אירוע הפעלה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים נשמרים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_OS_REPORT
ייצוג ב-JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
שדות
bootUpDuration

string (Duration format)

משך הזמן הכולל עד להפעלה.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
bootUpTime

string (Timestamp format)

חותמת הזמן שבה המכשיר הופעל.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

הזמן הכולל מתחילת הכיבוי ועד הכיבוי.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
shutdownTime

string (Timestamp format)

חותמת הזמן של הכיבוי.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

הסיבה לכיבוי.
reportTime

string (Timestamp format)

חותמת זמן של מועד איסוף הנתונים בדוח.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

ShutdownReason

הסיבה לכיבוי.

טיפוסים בני מנייה (enum)
SHUTDOWN_REASON_UNSPECIFIED לא צוינה סיבת הכיבוי.
USER_REQUEST בהפעלת המשתמש.
SYSTEM_UPDATE הופעל עדכון מערכת.
LOW_BATTERY המכשיר כבוי כי הסוללה חלשה.
OTHER כיבוי בגלל סיבות אחרות.

HeartbeatStatusReport

דוח סטטוס של פעימת הלב של המכשיר.

  • זמין לקיוסקים
  • בשדה הזה מופיע הסטטוס של המכשיר (אונליין, אופליין או לא ידוע), והוא יופיע רק אם הסטטוס השתנה (לדוגמה, אונליין -> אופליין)
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: HeartbeatEnabled מידע נוסף
  • תדירות פעימות הלב: 2 דקות
    • הערה: אם מכשיר עובר למצב אופליין, יכולות לעבור עד 12 דקות עד שסטטוס האונליין של המכשיר מתעדכן.
  • מטמון: אם המכשיר אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, ויועברו בדיווח כשהמכשיר יהיה אונליין: לא רלוונטי
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "state": enum (State)
}
שדות
reportTime

string (Timestamp format)

חותמת הזמן שבה זוהה שינוי הסטטוס

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
state

enum (State)

המצב שאליו המכשיר השתנה

מדינה (State)

מצב המכשיר

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED המצב לא צוין
UNKNOWN המכשיר לא עומד בדרישות למעקב אחר אותות חיים
ONLINE המכשיר במצב אונליין
OFFLINE המכשיר לא מקוון
DEVICE_OUTDATED המכשיר מיושן

KioskAppStatusReport

דוח סטטוס של אפליקציית קיוסק במכשיר.

  • זמין לקיוסקים
  • בשדה הזה מופיעים מזהה האפליקציה ומספר הגרסה שפועלים במכשיר קיוסק, וחותמת הזמן של העדכון האחרון של הדוח
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceSessionStatus
  • תדירות איסוף הנתונים: רק בהעלאה
  • תדירות ברירת המחדל של דיווח הנתונים: 3 שעות
    • האם המדיניות נשלטת: כן
  • מטמון: אם המכשיר אופליין, הנתונים שנאספים מאוחסנים באופן מקומי, ויועברו דיווח כשהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא רלוונטי
  • נדרשת הרשאה מפורטת: TELEMETRY_API_APPS_REPORT
ייצוג ב-JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
שדות
reportTime

string (Timestamp format)

חותמת הזמן של איסוף הדוח

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
appId

string

מזהה האפליקציה של אפליקציית הקיוסק, לדוגמה: mdmkkicfmmkgmpkmkdikhlbggogpicma
appVersion

string

מספר הגרסה של אפליקציית הקיוסק, לדוגמה: ‎1.10.118

RuntimeCountersReport

מוני זמן ריצה שאוחזרו מהמעבד (CPU). בשלב הזה, טלמטריה של מוני זמן ריצה נתמכת רק על ידי Intel vPro PSR ב-Gen 14 ואילך.

ייצוג ב-JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
שדות
reportTime

string (Timestamp format)

חותמת זמן של מועד איסוף הנתונים בדוח.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

משך זמן הריצה הכולל. כרגע תמיד זמן הריצה S0 מ-Intel vPro PSR.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
enterSleepCount

string (int64 format)

מספר הפעמים שהמכשיר נכנס למצב שינה. כרגע, הנתונים מתקבלים דרך ה-PSR, והספירה היא מ-S0 עד S3.
enterHibernationCount

string (int64 format)

מספר הפעמים שהמכשיר נכנס למצב שינה. כרגע, הנתונים מתקבלים דרך ה-PSR, והספירה היא מ-S0 עד S4.
enterPoweroffCount

string (int64 format)

מספר הפעמים שהמכשיר נכנס למצב כבוי. כרגע, הנתונים מתקבלים דרך ה-PSR, והספירה היא מ-S0 עד S5.

Methods

get

 קבלת נתוני טלמטריה של המכשיר.

list

 רשימה של כל מכשירי הטלמטריה.