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)

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

object (CpuStatusReport)

פלט בלבד. דוחות הסטטוס של המעבד (CPU) שנאספו מדי פעם ממוינים בסדר יורד של 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

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

enum (Architecture)

פלט בלבד. סוג הארכיטקטורה של ה-CPU.

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

integer

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

boolean

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

boolean

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

ארכיטקטורה

סוג הארכיטקטורה של המעבד.

טיפוסים בני מנייה (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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

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

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

integer

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

object (CpuTemperatureInfo)

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

CpuTemperatureInfo

הטמפרטורה של המעבד (CPU) של מכשיר. דגימה לכל ליבה של מעבד (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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)
}
שדות
reportTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

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

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)

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

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastUpdateCheckTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastRebootTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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
}
שדות
displayName

string

פלט בלבד. השם המוצג של המסך.
displayWidthMm

integer

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

integer

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

boolean

פלט בלבד. האם המסך פנימי או לא.
manufacturerId

string

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

integer

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

integer

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

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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
displays[]

object (DisplayInfo)

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

DisplayInfo

מידע על מסך.

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

string (int64 format)

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

integer

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

integer

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

integer

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

boolean

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

string

פלט בלבד. השם המוצג של המסך.

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)

פלט בלבד. קיבולת העיצוב (mAh).
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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
voltage

string (int64 format)

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

string (int64 format)

פלט בלבד. קיבולת הסוללה שנותר (mAh).
temperature

integer

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

integer

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

integer

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

string (int64 format)

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

string

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

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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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.

ThunderboltSecurityLevel

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

טיפוסים בני מנייה (enum)
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED רמת האבטחה של Thunderbolt לא מוגדרת.
THUNDERBOLT_SECURITY_NONE_LEVEL כל המכשירים מחוברים באופן אוטומטי על ידי הקושחה. לא נדרש אישור מהמשתמשים.
THUNDERBOLT_SECURITY_USER_LEVEL המשתמשים נשאלים אם אפשר לחבר את המכשיר.
THUNDERBOLT_SECURITY_SECURE_LEVEL המשתמש נשאל אם מותר לחבר את המכשיר. בנוסף, למכשיר נשלח אתגר שאמור להתאים לזה הצפוי, על סמך מפתח אקראי שנכתב במאפיין המפתח sysfs
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL הקושחה יוצרת באופן אוטומטי מנהרות ל-Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL הקושחה יוצרת באופן אוטומטי מנהרות לבקר ה-USB וליציאת התצוגה באביזר עגינה. כל הקישורים של 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)

חותמת הזמן של מועד הפעלת החשמל.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
shutdownDuration

string (Duration format)

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

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

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
shutdownReason

enum (ShutdownReason)

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

string (Timestamp format)

חותמת הזמן שבה הדוח נאסף.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

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)

חותמת הזמן של מועד הזיהוי של שינוי הסטטוס

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
state

enum (State)

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

מדינה

מצב המכשיר

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

KioskAppStatusReport

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

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

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
appId

string

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

string

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

RuntimeCountersReport

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

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

string (Timestamp format)

חותמת הזמן שבה הדוח נאסף.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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.

שיטות

get

 אחזור מכשיר טלמטריה.

list

 הצגת רשימה של כל מכשירי הטלמטריה.