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, כלומר כניסה למצב שינה, תרדמת ({/1}) וכיבוי (כיבוי)

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 CPU @ 1.60GHz
architecture

enum (Architecture)

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

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

integer

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

boolean

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

boolean

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

ארכיטקטורה

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

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

CpuStatusReport

מספק מידע על הסטטוס של המעבד (CPU).

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

פלט בלבד. מדריך לחיבור רשת.
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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

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

string (int64 format)

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

string (int64 format)

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

integer

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

integer

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

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

פלט בלבד. משך הזמן במחיקה מאז האתחול האחרון. מחיקת הודעות היא כדי למחוק בלוקים ברורים שכבר לא נמצאים בשימוש. נתמך בליבה (kernel) 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 במורד הזרם של ה-Dock יוסרו.
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)

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

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

string (Duration format)

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

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

string (Timestamp format)

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

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

enum (ShutdownReason)

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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