- 資源: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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
sampleFrequency |
僅供輸出。取樣報表的頻率。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
signalStrengthDbm |
僅供輸出。無線網路的訊號強度 (以分貝為單位)。 |
lanIpAddress |
僅供輸出。LAN IP 位址 |
gatewayIpAddress |
僅供輸出。閘道 IP 位址。 |
transmissionBitRateMbps |
僅供輸出。傳輸位元率是以百萬位元/秒為單位。 |
receivingBitRateMbps |
僅供輸出。接收位元率是以百萬位元/秒為單位。 |
transmissionPowerDbm |
僅供輸出。傳輸功率,以分貝為單位。 |
encryptionOn |
僅供輸出。Wi-Fi 加密金鑰是否關閉。 |
wifiLinkQuality |
僅供輸出。Wi-Fi 連結品質。值的範圍從 [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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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 時,才會設定此屬性。請注意,這可以是虛擬「0.0.0.0」適用於部分極端情況的 OS_UPDATE_NEED_REBOOT 狀態,例如:更新引擎在不重新啟動的情況下重新啟動。 |
newRequestedPlatformVersion |
僅供輸出。針對待處理的更新版資訊站應用程式,新增要求的平台版本。 |
lastUpdateTime |
僅供輸出。上次成功更新的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
lastUpdateCheckTime |
僅供輸出。上次更新檢查的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
lastRebootTime |
僅供輸出。上次重新啟動的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
UpdateState
OS 更新狀態
列舉 | |
---|---|
UPDATE_STATE_UNSPECIFIED |
狀態不明。 |
OS_IMAGE_DOWNLOAD_NOT_STARTED |
OS 尚未開始下載。 |
OS_IMAGE_DOWNLOAD_IN_PROGRESS |
作業系統已開始在裝置上下載作業。 |
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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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-hours)。 |
designMinVoltage |
僅供輸出。設計的最低輸出電壓 (mV) |
manufactureDate |
僅供輸出。電池製造日期。 |
technology |
僅供輸出。電池的技術。例如:鋰離子 |
BatteryStatusReport
電池狀態資料。
- 這個欄位是遙測資訊,這項資訊會隨著使用裝置而改變。
- 這個欄位的資料是透過以下政策控制:ReportDevicePowerStatus
- 資料收集頻率:僅在上傳時
- 預設資料報表頻率:3 小時
- 受政策控制:是
- 快取:如果裝置處於離線狀態,收集的資料會儲存在本機上,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 所需的精細權限:TELEMETRY_API_BATTERY_REPORT
JSON 表示法 |
---|
{ "reportTime": string, "serialNumber": string, "sample": [ { object ( |
欄位 | |
---|---|
reportTime |
僅供輸出。裝置收集樣本時的時間戳記 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
serialNumber |
僅供輸出。電池序號。 |
sample[] |
僅供輸出。電池的取樣資料,按 |
batteryHealth |
僅供輸出。電池健康度。 |
fullChargeCapacity |
僅供輸出。完全充電容量 (mAmpere-hours)。 |
cycleCount |
僅供輸出。週期數。 |
BatterySampleReport
正在對電池進行資料取樣。
- 這個欄位是遙測資訊,這項資訊會隨著使用裝置而改變。
- 這個欄位的資料是透過以下政策控制:ReportDevicePowerStatus
- 資料收集頻率:僅在上傳時
- 預設資料報表頻率:3 小時
- 受政策控制:是
- 快取:如果裝置處於離線狀態,收集的資料會儲存在本機上,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
JSON 表示法 |
---|
{ "reportTime": string, "voltage": string, "remainingCapacity": string, "temperature": integer, "dischargeRate": integer, "chargeRate": integer, "current": string, "status": string } |
欄位 | |
---|---|
reportTime |
僅供輸出。裝置收集樣本時的時間戳記 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
voltage |
僅供輸出。電池電壓 (毫電)。 |
remainingCapacity |
僅供輸出。電池剩餘電量 (mAmpere-hour)。 |
temperature |
僅供輸出。攝氏溫度。 |
dischargeRate |
僅供輸出。電池放電速率是以 mW 為單位。如果電池未充電,則為陽性;如果電池已充飽,則為負數。 |
chargeRate |
僅供輸出。電池充電百分比。 |
current |
僅供輸出。電池電流 (mA)。 |
status |
僅供輸出。從 sysf 讀取電池狀態。示例:放電 |
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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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 |
系統會詢問使用者是否允許連結裝置。此外,該裝置還收到一項驗證要求,此挑戰是根據寫入金鑰 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 ( |
欄位 | |
---|---|
bootUpDuration |
開機總時間。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
bootUpTime |
開機時的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
shutdownDuration |
從關機開始到關機的總時間。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
shutdownTime |
關機時的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
shutdownReason |
關閉原因。 |
reportTime |
收集報表的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
state |
裝置變更狀態 |
州
裝置狀態
列舉 | |
---|---|
STATE_UNSPECIFIED |
未指定狀態 |
UNKNOWN |
裝置不符合活動訊號監控功能的資格條件 |
ONLINE |
裝置已連上網路 |
OFFLINE |
裝置處於離線狀態 |
KioskAppStatusReport
裝置的資訊站應用程式狀態報告。
- 適用於資訊站
- 這個欄位會提供資訊站裝置執行的應用程式 ID 和版本號碼,以及報告上次更新時間的時間戳記
- 這個欄位的資料是透過 ReportDeviceSessionStatus 政策控制
- 資料收集頻率:僅在上傳時
- 預設資料報表頻率:3 小時
- 受政策控制:是
- 快取:如果裝置處於離線狀態,收集的資料會儲存在本機上,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 所需的精細權限:TELEMETRY_API_APPS_REPORT
JSON 表示法 |
---|
{ "reportTime": string, "appId": string, "appVersion": string } |
欄位 | |
---|---|
reportTime |
收集報表時間的時間戳記 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
appId |
資訊站應用程式的應用程式 ID,例如「mdmkkicfmmkgmpkmkdikhlbggogpicma」 |
appVersion |
資訊站應用程式的版本號碼,例如「1.10.118」 |
RuntimeCountersReport
從 CPU 擷取的執行階段計數器。目前只有第 14 代的 Intel vPro PSR 支援執行階段計數器遙測功能。
JSON 表示法 |
---|
{ "reportTime": string, "uptimeRuntimeDuration": string, "enterSleepCount": string, "enterHibernationCount": string, "enterPoweroffCount": string } |
欄位 | |
---|---|
reportTime |
收集報表的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
uptimeRuntimeDuration |
生命週期總執行時間。目前一律使用 Intel vPro PSR 的 S0 執行階段。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
enterSleepCount |
裝置進入睡眠狀態的次數。目前透過 PSR 取得,計數為 S0->S3。 |
enterHibernationCount |
裝置進入休眠狀態的次數。目前透過 PSR 取得,計數為 S0->S4。 |
enterPoweroffCount |
裝置進入關機狀態的次數。目前透過 PSR 取得,計數為 S0->S5。 |
方法 |
|
---|---|
|
取得遙測裝置。 |
|
列出所有遙測裝置。 |