- 資源:TelemetryDevice
- CpuInfo
- 架構
- CpuStatusReport
- CpuTemperatureInfo
- MemoryInfo
- TotalMemoryEncryptionInfo
- MemoryEncryptionState
- MemoryEncryptionAlgorithm
- MemoryStatusReport
- NetworkInfo
- NetworkDevice
- NetworkDeviceType
- NetworkStatusReport
- NetworkType
- NetworkDiagnosticsReport
- OsUpdateStatus
- UpdateState
- GraphicsInfo
- GraphicsAdapterInfo
- DisplayDevice
- TouchScreenInfo
- TouchScreenDevice
- GraphicsStatusReport
- DisplayInfo
- BatteryInfo
- BatteryStatusReport
- BatterySampleReport
- BatteryHealth
- StorageInfo
- DiskVolume
- StorageStatusReport
- DiskInfo
- ThunderboltInfo
- ThunderboltSecurityLevel
- BootPerformanceReport
- ShutdownReason
- HeartbeatStatusReport
- 狀態
- KioskAppStatusReport
- RuntimeCountersReport
- 方法
資源:TelemetryDevice
收集自受管理裝置的遙測資料。
- 需要精細權限:TELEMETRY_API_DEVICE
JSON 表示法 |
---|
{ "name": string, "customer": string, "orgUnitId": string, "deviceId": string, "serialNumber": string, "cpuInfo": [ { object ( |
欄位 | |
---|---|
name |
僅供輸出。裝置的資源名稱。 |
customer |
僅供輸出。已註冊裝置的 Google Workspace 客戶。 |
orgUnitId |
僅供輸出。裝置的機構單位 ID。 |
deviceId |
僅供輸出。裝置的專屬 Directory API ID。這個值和 ChromeOS 裝置分頁中管理控制台的 Directory API ID |
serialNumber |
僅供輸出。裝置序號。這個值和管理控制台在 ChromeOS 裝置分頁中的序號相同。 |
cpuInfo[] |
僅供輸出。裝置的 CPU 規格相關資訊。 |
cpuStatusReport[] |
僅供輸出。系統會定期收集 CPU 狀態報告 (依 |
memoryInfo |
僅供輸出。裝置記憶體規格的相關資訊。 |
memoryStatusReport[] |
僅供輸出。收集的記憶體狀態報表會定期依 |
networkInfo |
僅供輸出。網路裝置資訊。 |
networkStatusReport[] |
僅供輸出。定期收集網路規格。 |
networkDiagnosticsReport[] |
僅供輸出。定期收集的網路診斷資料。 |
osUpdateStatus[] |
僅供輸出。包含 ChromeOS 更新狀態的相關資訊。 |
graphicsInfo |
僅供輸出。內含裝置圖形週邊裝置的相關資訊。 |
graphicsStatusReport[] |
僅供輸出。定期收集的圖形報告。 |
batteryInfo[] |
僅供輸出。裝置電池規格的資訊。 |
batteryStatusReport[] |
僅供輸出。電池報告會定期收集。 |
storageInfo |
僅供輸出。裝置儲存空間規格的資訊。 |
storageStatusReport[] |
僅供輸出。系統會定期收集儲存空間報表。 |
thunderboltInfo[] |
僅供輸出。Thunderbolt 公車的資訊。 |
audioStatusReport[] |
僅供輸出。系統會定期收集音訊報表 (依 |
bootPerformanceReport[] |
僅供輸出。裝置啟動效能報告。 |
heartbeatStatusReport[] |
僅供輸出。活動訊號狀態報表內含時間戳記,時間戳記會定期以「 |
kioskAppStatusReport[] |
僅供輸出。資訊站裝置的資訊站應用程式狀態報告 |
networkBandwidthReport[] |
僅供輸出。定期收集的網路頻寬報表 (依 |
peripheralsReport[] |
僅供輸出。定期收集的周邊裝置報表 (依 |
appReport[] |
僅供輸出。系統會定期收集應用程式報表 (依 |
runtimeCountersReport[] |
僅供輸出。執行階段計數器會回報裝置生命週期的執行階段,以及 S0->S3、S0->S4 和 S0->S5 轉場次數,也就是進入睡眠、休眠和關機狀態的次數 |
CpuInfo
裝置的 CPU 規格
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過政策控制:ReportDeviceCpuInfo
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_CPU_INFO
JSON 表示法 |
---|
{
"model": string,
"architecture": enum ( |
欄位 | |
---|---|
model |
僅供輸出。CPU 型號名稱。例如:Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz |
architecture |
僅供輸出。CPU 的架構類型。
|
maxClockSpeed |
僅供輸出。最大 CPU 時脈速度,kHz。 |
keylockerSupported |
僅供輸出。是否支援 Keylocker。 |
keylockerConfigured |
僅供輸出。是否已設定 Keylocker。 |
架構
CPU 的架構類型。
列舉 | |
---|---|
ARCHITECTURE_UNSPECIFIED |
架構未知。 |
X64 |
x64 架構 |
CpuStatusReport
提供 CPU 狀態的資訊。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDeviceCpuInfo
- 資料收集頻率:每 10 分鐘
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_CPU_REPORT
JSON 表示法 |
---|
{
"reportTime": string,
"sampleFrequency": string,
"cpuUtilizationPct": integer,
"cpuTemperatureInfo": [
{
object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。時間戳記 (以毫秒為單位),代表系統取樣這份報表的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
sampleFrequency |
僅供輸出。取樣報表的取樣頻率。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
cpuUtilizationPct |
僅供輸出。CPU 使用率範例 (0 - 100%)。 |
cpuTemperatureInfo[] |
僅供輸出。攝氏個別 CPU 核心的 CPU 溫度樣本資訊 |
CpuTemperatureInfo
裝置的 CPU 溫度。以攝氏為單位對每個 CPU 核心進行取樣。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDeviceCpuInfo
- 資料收集頻率:每 10 分鐘
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
JSON 表示法 |
---|
{ "temperatureCelsius": integer, "label": string } |
欄位 | |
---|---|
temperatureCelsius |
僅供輸出。CPU 溫度 (攝氏)。 |
label |
僅供輸出。CPU 標籤範例:核心 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 ( |
欄位 | |
---|---|
totalRamBytes |
僅供輸出。RAM 總量 (以位元組為單位)。 |
availableRamBytes |
僅供輸出。可用 RAM 容量 (以位元組為單位)。 |
totalMemoryEncryption |
僅供輸出。裝置的記憶體加密總資訊。 |
TotalMemoryEncryptionInfo
裝置的記憶體加密資訊。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過政策控制:ReportDeviceMemoryInfo
- 資料收集頻率:裝置啟動時
- 預設資料回報頻率:裝置啟動時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:是
- 僅回報關聯使用者的數據:不適用
JSON 表示法 |
---|
{ "encryptionState": enum ( |
欄位 | |
---|---|
encryptionState |
裝置的記憶體加密狀態。 |
maxKeys |
可用於加密的金鑰數量上限。 |
keyLength |
加密金鑰的長度。 |
encryptionAlgorithm |
記憶體加密演算法。 |
MemoryEncryptionState
裝置的記憶體加密狀態。
列舉 | |
---|---|
MEMORY_ENCRYPTION_STATE_UNSPECIFIED |
未設定記憶體加密狀態。 |
MEMORY_ENCRYPTION_STATE_UNKNOWN |
記憶體加密狀態不明。 |
MEMORY_ENCRYPTION_STATE_DISABLED |
裝置記憶體強化功能已停用。 |
MEMORY_ENCRYPTION_STATE_TME |
裝置的記憶體加密會使用記憶體總量加密。 |
MEMORY_ENCRYPTION_STATE_MKTME |
裝置的記憶體加密功能採用多金鑰總記憶體加密。 |
MemoryEncryptionAlgorithm
裝置使用的加密演算法。
列舉 | |
---|---|
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
- 資料收集頻率:只有在上傳時,系統每 10 分鐘會收集一次 SystemRamFreeByes 一次
- 預設資料報表頻率:每 3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_MEMORY_REPORT
JSON 表示法 |
---|
{ "reportTime": string, "sampleFrequency": string, "systemRamFreeBytes": string, "pageFaults": integer } |
欄位 | |
---|---|
reportTime |
僅供輸出。時間戳記 (以毫秒為單位),代表系統取樣這份報表的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
sampleFrequency |
僅供輸出。取樣報表的取樣頻率。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
systemRamFreeBytes |
僅供輸出。可用 RAM 容量 (以位元組為單位,因垃圾收集造成的不穩定)。 |
pageFaults |
僅供輸出。這個集合期間的頁面錯誤數量 |
NetworkInfo
網路裝置資訊。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過 ReportNetworkDeviceConfiguration 政策控制
- 資料收集頻率:裝置啟動時
- 預設資料回報頻率:裝置啟動時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:是
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_NETWORK_INFO
JSON 表示法 |
---|
{
"networkDevices": [
{
object ( |
欄位 | |
---|---|
networkDevices[] |
僅供輸出。網路裝置清單。 |
NetworkDevice
網路裝置的詳細資料。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過 ReportNetworkDeviceConfiguration 政策控制
- 資料收集頻率:裝置啟動時
- 預設資料回報頻率:裝置啟動時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:是
- 僅回報關聯使用者的數據:不適用
JSON 表示法 |
---|
{
"type": enum ( |
欄位 | |
---|---|
type |
僅供輸出。網路裝置類型。 |
macAddress |
僅供輸出。對應網路裝置的 MAC 位址 (如適用)。 |
meid |
僅供輸出。對應網路裝置的 MEID (如有)。 |
imei |
僅供輸出。對應網路裝置的 IMEI (如適用)。 |
iccid |
僅供輸出。與裝置 SIM 卡相關聯的整合式電路卡 ID。 |
mdn |
僅供輸出。與裝置 SIM 卡相關聯的行動目錄號碼。 |
NetworkDeviceType
網路裝置類型。
列舉 | |
---|---|
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 ( |
欄位 | |
---|---|
reportTime |
僅供輸出。回報網路狀態的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
sampleFrequency |
僅供輸出。取樣報表的取樣頻率。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
signalStrengthDbm |
僅供輸出。無線網路的訊號強度 (以分貝為單位)。 |
lanIpAddress |
僅供輸出。LAN IP 位址。 |
gatewayIpAddress |
僅供輸出。閘道 IP 位址。 |
transmissionBitRateMbps |
僅供輸出。傳輸位元率 (以百萬位元/秒為單位)。 |
receivingBitRateMbps |
僅供輸出。接收位元率的測量單位為每秒百萬位元數。 |
transmissionPowerDbm |
僅供輸出。傳輸功率 (以分貝為單位)。 |
encryptionOn |
僅供輸出。Wi-Fi 加密金鑰是否已關閉。 |
wifiLinkQuality |
僅供輸出。Wifi 連結品質。值的範圍為 [0, 70]。0 表示沒有訊號,70 表示訊號良好。 |
wifiPowerManagementEnabled |
僅供輸出。已啟用 Wi-Fi 電源管理功能 |
guid |
僅供輸出。網路連線指南。 |
connectionState |
僅供輸出。網路目前的連線狀態。 |
connectionType |
僅供輸出。網路連線類型。 |
NetworkType
網路連線類型。
列舉 | |
---|---|
NETWORK_TYPE_UNSPECIFIED |
未指定網路連線類型 |
CELLULAR |
行動網路連線。 |
ETHERNET |
乙太網路網路連線。 |
TETHER |
網路連線。 |
VPN |
VPN 網路連線。 |
WIFI |
Wi-Fi 網路連線。 |
NetworkDiagnosticsReport
判斷裝置網路連線狀況的網路測試結果,例如 HTTPS 延遲時間是高還是正常。
- 需要精細的權限:TELEMETRY_API_NETWORK_REPORT
JSON 表示法 |
---|
{
"reportTime": string,
"httpsLatencyData": {
object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。診斷時間時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
httpsLatencyData |
僅供輸出。HTTPS 延遲測試資料。 |
OsUpdateStatus
包含目前 OS 更新狀態的相關資訊。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDeviceOsUpdateStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_OS_REPORT
JSON 表示法 |
---|
{
"updateState": enum ( |
欄位 | |
---|---|
updateState |
僅供輸出。OS 更新的目前狀態。 |
newPlatformVersion |
僅供輸出。系統正在下載並套用新的 OS 映像檔平台版本。只有在更新狀態為 OS_IMAGE_DOWNLOAD_IN_PROGRESS 或 OS_UPDATE_NEED_REBOOT 時才會設定。請注意,對於某些極端案例,這可能是 OS_UPDATE_NEED_REBOOT 的虛擬「0.0.0.0」狀態,例如在未重新啟動的情況下重新啟動更新引擎。 |
newRequestedPlatformVersion |
僅供輸出。待處理的更新資訊站應用程式新要求的平台版本。 |
lastUpdateTime |
僅供輸出。上次成功更新的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastUpdateCheckTime |
僅供輸出。上次更新檢查的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastRebootTime |
僅供輸出。上次重新啟動的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
UpdateState
OS 更新狀態
列舉 | |
---|---|
UPDATE_STATE_UNSPECIFIED |
狀態不明。 |
OS_IMAGE_DOWNLOAD_NOT_STARTED |
OS 尚未開始下載。 |
OS_IMAGE_DOWNLOAD_IN_PROGRESS |
OS 已開始在裝置上下載。 |
OS_UPDATE_NEED_REBOOT |
裝置必須重新啟動才能完成上傳。 |
GraphicsInfo
圖形子系統的資訊。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過政策控制:ReportDeviceGraphicsStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_GRAPHICS_INFO
JSON 表示法 |
---|
{ "adapterInfo": { object ( |
欄位 | |
---|---|
adapterInfo |
僅供輸出。顯示卡 (GPU) 相關資訊。 |
eprivacySupported |
僅供輸出。是否支援電子隱私螢幕。 |
displayDevices[] |
僅供輸出。裝置螢幕的相關資訊。 |
touchScreenInfo |
僅供輸出。裝置內部觸控螢幕的資訊。 |
GraphicsAdapterInfo
顯示卡 (GPU) 資訊。
JSON 表示法 |
---|
{ "adapter": string, "driverVersion": string, "deviceId": string } |
欄位 | |
---|---|
adapter |
僅供輸出。轉接程式名稱。例如:Mesa DRI Intel(R) UHD 顯示卡 620 (Kabylake GT2)。 |
driverVersion |
僅供輸出。GPU 驅動程式的版本。 |
deviceId |
僅供輸出。代表顯示卡裝置 ID。 |
DisplayDevice
顯示裝置的資訊。
JSON 表示法 |
---|
{ "displayName": string, "displayWidthMm": integer, "displayHeightMm": integer, "internal": boolean, "manufacturerId": string, "modelId": integer, "manufactureYear": integer } |
欄位 | |
---|---|
displayName |
僅供輸出。顯示裝置名稱。 |
displayWidthMm |
僅供輸出。螢幕寬度 (以公釐為單位)。 |
displayHeightMm |
僅供輸出。顯示高度 (以公釐為單位)。 |
internal |
僅供輸出。僅限內部使用。 |
manufacturerId |
僅供輸出。由三個字母組成的製造商 ID。 |
modelId |
僅供輸出。製造商產品代碼。 |
manufactureYear |
僅供輸出。製造年份。 |
TouchScreenInfo
裝置觸控螢幕上的資訊。
JSON 表示法 |
---|
{
"touchpadLibrary": string,
"devices": [
{
object ( |
欄位 | |
---|---|
touchpadLibrary |
僅供輸出。輸入堆疊使用的觸控板程式庫名稱。 |
devices[] |
僅供輸出。內部觸控螢幕裝置清單。 |
TouchScreenDevice
內部觸控螢幕裝置資訊。
JSON 表示法 |
---|
{ "displayName": string, "touchPointCount": integer, "stylusCapable": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。觸控螢幕裝置顯示名稱。 |
touchPointCount |
僅供輸出。裝置支援的接觸點數量。 |
stylusCapable |
僅供輸出。觸控螢幕裝置支援或無法使用觸控筆。 |
GraphicsStatusReport
圖形子系統的資訊。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDeviceGraphicsInfo
- 資料收集頻率:3 小時。
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_GRAPHICS_REPORT
JSON 表示法 |
---|
{
"reportTime": string,
"displays": [
{
object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。影像資料回報的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
displays[] |
僅供輸出。裝置螢幕的相關資訊。 |
DisplayInfo
顯示畫面的資訊。
JSON 表示法 |
---|
{ "deviceId": string, "resolutionWidth": integer, "resolutionHeight": integer, "refreshRate": integer, "isInternal": boolean, "displayName": string } |
欄位 | |
---|---|
deviceId |
僅供輸出。代表顯示卡裝置 ID。 |
resolutionWidth |
僅供輸出。解析度寬度 (以像素為單位)。 |
resolutionHeight |
僅供輸出。解析度高度 (單位為像素)。 |
refreshRate |
僅供輸出。刷新率 (以 Hz 為單位)。 |
isInternal |
僅供輸出。表示顯示是否為內部螢幕。 |
displayName |
僅供輸出。顯示裝置名稱。 |
BatteryInfo
電池相關資訊。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過政策控制:ReportDevicePowerStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_BATTERY_INFO
JSON 表示法 |
---|
{
"serialNumber": string,
"manufacturer": string,
"designCapacity": string,
"designMinVoltage": integer,
"manufactureDate": {
object ( |
欄位 | |
---|---|
serialNumber |
僅供輸出。電池序號。 |
manufacturer |
僅供輸出。電池製造商。 |
designCapacity |
僅供輸出。設計容量 (mAmpere 時數)。 |
designMinVoltage |
僅供輸出。設計的最低輸出電壓 (mV) |
manufactureDate |
僅供輸出。電池製造日期。 |
technology |
僅供輸出。電池技術。例如:鋰離子 |
BatteryStatusReport
電池狀態資料。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDevicePowerStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_BATTERY_REPORT
JSON 表示法 |
---|
{ "reportTime": string, "serialNumber": string, "sample": [ { object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。在裝置上收集樣本的時間戳記 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
serialNumber |
僅供輸出。電池序號。 |
sample[] |
僅供輸出。電池資料取樣 (依 |
batteryHealth |
僅供輸出。電池健康度。 |
fullChargeCapacity |
僅供輸出。充飽電容量 (mAmpere 時數)。 |
cycleCount |
僅供輸出。週期數。 |
BatterySampleReport
針對電池取樣資料。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控制:ReportDevicePowerStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
JSON 表示法 |
---|
{ "reportTime": string, "voltage": string, "remainingCapacity": string, "temperature": integer, "dischargeRate": integer, "chargeRate": integer, "current": string, "status": string } |
欄位 | |
---|---|
reportTime |
僅供輸出。在裝置上收集樣本的時間戳記 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
voltage |
僅供輸出。電池電壓 (毫電)。 |
remainingCapacity |
僅供輸出。電池剩餘電量 (mAmpere 時數)。 |
temperature |
僅供輸出。溫度 (攝氏)。 |
dischargeRate |
僅供輸出。電池放電速率的測量單位為 mW。如果電池正在放電,則為負數;如果正在充電,則為負值。 |
chargeRate |
僅供輸出。電池充電百分比。 |
current |
僅供輸出。電池電流 (mA)。 |
status |
僅供輸出。從 sysfs 讀取的電池狀態。示例:放電中 |
BatteryHealth
代表電池的目前健康狀態。
- 這個狀態並非測量指標,也不是電池有瑕疵。計算方式是將目前的充飽電容量除以設計容量。
- 電池完整性和保固政策由製造商全權決定。
列舉 | |
---|---|
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 ( |
欄位 | |
---|---|
volume[] |
磁碟區相關資訊 |
availableDiskBytes |
裝置的可用使用者資料儲存空間 (以位元組為單位)。 |
totalDiskBytes |
裝置的使用者資料儲存空間總空間 (以位元組為單位)。 |
DiskVolume
磁碟區相關資訊
JSON 表示法 |
---|
{ "volumeId": string, "storageFreeBytes": string, "storageTotalBytes": string } |
欄位 | |
---|---|
volumeId |
磁碟磁碟區 ID。 |
storageFreeBytes |
釋出儲存空間 (以位元組為單位)。 |
storageTotalBytes |
儲存空間總量 (以位元組為單位)。 |
StorageStatusReport
儲存空間的狀態資料。
- 這個欄位是遙測資訊,且會隨著使用裝置而改變。
- 這個欄位的資料是透過政策控管:ReportDeviceStorageStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_STORAGE_REPORT
JSON 表示法 |
---|
{
"reportTime": string,
"disk": [
{
object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。在裝置上收集樣本的時間戳記 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
disk[] |
僅供輸出。磁碟報告。 |
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 |
僅供輸出。磁碟序號。 |
manufacturer |
僅供輸出。磁碟製造商。 |
model |
僅供輸出。磁碟模型 |
sizeBytes |
僅供輸出。磁碟大小 |
type |
僅供輸出。磁碟類型:eMMC / NVMe / ATA / SCSI。 |
health |
僅供輸出。磁碟健康狀態。 |
volumeIds[] |
僅供輸出。磁碟磁碟區。 |
bytesReadThisSession |
僅供輸出。自上次啟動以來讀取的位元組數。 |
bytesWrittenThisSession |
僅供輸出。自上次啟動以來寫入的位元組數。 |
readTimeThisSession |
僅供輸出。自上次啟動後從磁碟讀取所花費的時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
writeTimeThisSession |
僅供輸出。自上次啟動後寫入磁碟的時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
ioTimeThisSession |
僅供輸出。計算磁碟和佇列忙碌的時間,因此與上述欄位不同,平行要求不會重複計算。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
discardTimeThisSession |
僅供輸出。自上次啟動後捨棄的時間。捨棄動作會清除不再使用的區塊。支援核心 4.18 以上版本。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
ThunderboltInfo
Thunderbolt 公車資訊。
- 這個欄位提供的裝置資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是透過政策控管:ReportDeviceSecurityStatus
- 資料收集頻率:裝置啟動時
- 預設資料回報頻率:裝置啟動時
- 政策控制:否
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:是
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_BUS_DEVICE_INFO
JSON 表示法 |
---|
{
"securityLevel": enum ( |
欄位 | |
---|---|
securityLevel |
Thunderbolt 公車的安全等級。 |
ThunderboltSecurityLevel
Thunderbolt 公車的安全等級。
列舉 | |
---|---|
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 控制器和充電埠中的 Display Port 建立通道。移除座架下游的所有 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 ( |
欄位 | |
---|---|
bootUpDuration |
總開機時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
bootUpTime |
電源開啟時的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
shutdownDuration |
關機後經過的總時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
shutdownTime |
關機時的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
shutdownReason |
關閉原因。 |
reportTime |
收集報表的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
ShutdownReason
關閉原因。
列舉 | |
---|---|
SHUTDOWN_REASON_UNSPECIFIED |
未指定關閉原因。 |
USER_REQUEST |
使用者啟動。 |
SYSTEM_UPDATE |
系統更新已開始。 |
LOW_BATTERY |
因電量不足而關機。 |
OTHER |
關閉。 |
HeartbeatStatusReport
裝置的活動訊號狀態報告。
- 適用於資訊站
- 這個欄位會顯示裝置的線上/離線/不明狀態,且只有在狀態已變更 (例如「線上」->「離線」) 時才會納入。
- 這個欄位的資料是透過政策控管:HeartbeatEnabled 更多資訊
- 活動訊號頻率:2 分鐘
- 注意:如果裝置未連上網路,系統最多可能需要 12 分鐘才能更新裝置的上線狀態
- 快取:如果裝置處於離線狀態,收集到的資料會儲存在本機,並在裝置下次連上網路時回報:不適用
- 僅回報關聯使用者的數據:不適用
- 需要精細權限:TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON 表示法 |
---|
{
"reportTime": string,
"state": enum ( |
欄位 | |
---|---|
reportTime |
偵測到狀態變更的時間戳記 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
state |
裝置的狀態已變更 |
狀態
裝置狀態
列舉 | |
---|---|
STATE_UNSPECIFIED |
未指定狀態 |
UNKNOWN |
裝置不符合心率監控功能的條件 |
ONLINE |
裝置已連上網路 |
OFFLINE |
裝置處於離線狀態 |
KioskAppStatusReport
裝置的資訊站應用程式狀態報告。
- 適用於資訊站
- 這個欄位提供在資訊站裝置上執行的應用程式 ID 和版本號碼,以及報告上次更新時的時間戳記
- 這個欄位的資料是透過政策控制:ReportDeviceSessionStatus
- 資料收集頻率:只在上傳時
- 預設資料報表頻率:3 小時
- 政策受到控制:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:否
- 僅回報關聯使用者的數據:不適用
- 需要精細的權限:TELEMETRY_API_APPS_REPORT
JSON 表示法 |
---|
{ "reportTime": string, "appId": string, "appVersion": string } |
欄位 | |
---|---|
reportTime |
收集報表的時間戳記 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
appId |
資訊站應用程式的應用程式 ID,例如「mdmkkicfmmkgmpkmkdikhlbggogpicma」 |
appVersion |
資訊站應用程式的應用程式版本編號,例如「1.10.118」 |
RuntimeCountersReport
從 CPU 擷取到的執行階段計數器。目前只有 Intel vPro PSR 在 14 以上版本中支援執行階段計數器遙測功能。
JSON 表示法 |
---|
{ "reportTime": string, "uptimeRuntimeDuration": string, "enterSleepCount": string, "enterHibernationCount": string, "enterPoweroffCount": string } |
欄位 | |
---|---|
reportTime |
收集報表的時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
uptimeRuntimeDuration |
生命週期總執行階段。目前一律從 Intel vPro PSR 執行 S0 執行階段。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
enterSleepCount |
裝置進入睡眠狀態的次數。目前是透過 PSR 取得,計數從 S0 到 S3。 |
enterHibernationCount |
裝置進入休眠狀態的次數。目前是透過 PSR 取得,計數從 S0 到 S4。 |
enterPoweroffCount |
裝置進入關機狀態的次數。目前是透過 PSR 取得,計數從 S0 到 S5。 |
方法 |
|
---|---|
|
取得遙測裝置。 |
|
列出所有遙測裝置。 |