- 資源: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 |
僅供輸出。是否支援 Key Locker。 |
keylockerConfigured |
僅供輸出。是否已設定 Key Locker。 |
架構
CPU 的架構類型。
| 列舉 | |
|---|---|
ARCHITECTURE_UNSPECIFIED |
架構不明。 |
X64 |
x64 架構 |
CpuStatusReport
提供 CPU 狀態的相關資訊。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料是由「ReportDeviceCpuInfo」政策控管。
- 資料收集頻率:每 10 分鐘一次
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_CPU_REPORT
| JSON 表示法 |
|---|
{
"reportTime": string,
"sampleFrequency": string,
"cpuUtilizationPct": integer,
"cpuTemperatureInfo": [
{
object ( |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。以毫秒為單位的時間戳記,代表系統取樣這份報表的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
sampleFrequency |
僅供輸出。取樣回報頻率。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
cpuUtilizationPct |
僅供輸出。CPU 使用率樣本 (0 到 100%)。 |
cpuTemperatureInfo[] |
僅供輸出。每個 CPU 核心的攝氏溫度樣本資訊 |
CpuTemperatureInfo
裝置的 CPU 溫度。以攝氏溫度為單位,針對每個 CPU 核心取樣。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料是由「ReportDeviceCpuInfo」政策控管。
- 資料收集頻率:每 10 分鐘一次
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
| JSON 表示法 |
|---|
{ "temperatureCelsius": integer, "label": string } |
| 欄位 | |
|---|---|
temperatureCelsius |
僅供輸出。CPU 溫度 (攝氏)。 |
label |
僅供輸出。CPU 標籤。範例:核心 0 |
MemoryInfo
裝置的記憶體資訊。
- 這個欄位包含遙測和裝置資訊:
totalRamBytes- 裝置資訊availableRamBytes- 遙測資訊totalMemoryEncryption- 裝置資訊
- 這個欄位的資料由「ReportDeviceMemoryInfo」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」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」ReportDeviceMemoryInfo政策控管。
- 資料收集頻率:僅在上傳時收集,每 10 分鐘收集一次 SystemRamFreeByes
- 預設資料回報頻率:每 3 小時一次
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_MEMORY_REPORT
| JSON 表示法 |
|---|
{ "reportTime": string, "sampleFrequency": string, "systemRamFreeBytes": string, "pageFaults": integer } |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。以毫秒為單位的時間戳記,代表系統取樣這份報表的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
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」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 |
僅供輸出。回報網路狀態的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
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 |
僅供輸出。網路連線 GUID。 |
connectionState |
僅供輸出。網路目前的連線狀態。 |
connectionType |
僅供輸出。網路連線類型。 |
ipv6Address[] |
僅供輸出。指派給這個網路的 IPv6 位址 (如有)。每個位址都是標準 IPv6 文字表示法中的字串 (例如「2001:db8::1」)。 |
gatewayIpv6Address |
僅供輸出。這個介面的閘道 IPv6 (如偵測到) |
metered |
僅供輸出。系統是否偵測到網路為計量付費。 |
linkDownSpeedKbps |
僅供輸出。網路介面或連線回報的每秒最大下行頻寬 (Kbps)。 |
NetworkType
網路連線類型。
| 列舉 | |
|---|---|
NETWORK_TYPE_UNSPECIFIED |
未指定網路連線類型 |
CELLULAR |
行動網路連線。 |
ETHERNET |
乙太網路連線。 |
TETHER |
網路共用網路連線。 |
VPN |
VPN 網路連線。 |
WIFI |
Wi-Fi 網路連線。 |
NetworkDiagnosticsReport
網路測試結果,可判斷裝置網路連線的健康狀態,例如 HTTPS 延遲時間是否過長。
- 必要精細權限:TELEMETRY_API_NETWORK_REPORT
| JSON 表示法 |
|---|
{
"reportTime": string,
"httpsLatencyData": {
object ( |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。收集診斷資訊的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
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 |
僅供輸出。上次成功更新的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
lastUpdateCheckTime |
僅供輸出。上次檢查更新的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
lastRebootTime |
僅供輸出。上次重新啟動的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
UpdateState
作業系統更新狀態
| 列舉 | |
|---|---|
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 Graphics 620 (Kabylake GT2)。 |
driverVersion |
僅供輸出。GPU 驅動程式版本。 |
deviceId |
僅供輸出。代表顯示卡裝置 ID。 |
DisplayDevice
顯示裝置的資訊。
| JSON 表示法 |
|---|
{ "displayName": string, "displayWidthMm": integer, "displayHeightMm": integer, "internal": boolean, "manufacturerId": string, "modelId": integer, "manufactureYear": integer, "serialNumber": integer, "edidVersion": string } |
| 欄位 | |
|---|---|
displayName |
僅供輸出。顯示裝置名稱。 |
displayWidthMm |
僅供輸出。螢幕寬度 (以公釐為單位)。 |
displayHeightMm |
僅供輸出。螢幕高度 (公釐)。 |
internal |
僅供輸出。是否顯示內部資訊。 |
manufacturerId |
僅供輸出。三字母製造商 ID。 |
modelId |
僅供輸出。製造商產品代碼。 |
manufactureYear |
僅供輸出。製造年份。 |
serialNumber |
僅供輸出。序號。 |
edidVersion |
僅供輸出。EDID 版本。 |
TouchScreenInfo
裝置觸控螢幕上的資訊。
| JSON 表示法 |
|---|
{
"touchpadLibrary": string,
"devices": [
{
object ( |
| 欄位 | |
|---|---|
touchpadLibrary |
僅供輸出。輸入堆疊使用的觸控板程式庫名稱。 |
devices[] |
僅供輸出。內部觸控螢幕裝置清單。 |
TouchScreenDevice
內部觸控螢幕裝置的資訊。
| JSON 表示法 |
|---|
{ "displayName": string, "touchPointCount": integer, "stylusCapable": boolean } |
| 欄位 | |
|---|---|
displayName |
僅供輸出。觸控螢幕裝置顯示名稱。 |
touchPointCount |
僅供輸出。裝置支援的觸控點數量。 |
stylusCapable |
僅供輸出。觸控螢幕裝置是否支援觸控筆。 |
GraphicsStatusReport
圖形子系統的資訊。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料會透過「ReportDeviceGraphicsInfo」ReportDeviceGraphicsInfo政策控管
- 資料收集頻率:3 小時。
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_GRAPHICS_REPORT
| JSON 表示法 |
|---|
{
"reportTime": string,
"displays": [
{
object ( |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。回報圖形資料的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
displays[] |
僅供輸出。裝置螢幕的相關資訊。 |
DisplayInfo
螢幕的相關資訊。
| JSON 表示法 |
|---|
{ "deviceId": string, "resolutionWidth": integer, "resolutionHeight": integer, "refreshRate": integer, "isInternal": boolean, "displayName": string, "serialNumber": integer, "edidVersion": string } |
| 欄位 | |
|---|---|
deviceId |
僅供輸出。代表顯示卡裝置 ID。 |
resolutionWidth |
僅供輸出。解析度寬度 (以像素為單位)。 |
resolutionHeight |
僅供輸出。解析度高度 (以像素為單位)。 |
refreshRate |
僅供輸出。以 Hz 為單位的刷新率。 |
isInternal |
僅供輸出。指出螢幕是否為內部螢幕。 |
displayName |
僅供輸出。顯示裝置名稱。 |
serialNumber |
僅供輸出。序號。 |
edidVersion |
僅供輸出。EDID 版本。 |
BatteryInfo
電池相關資訊。
- 這個欄位提供裝置資訊,這些資訊是靜態的,不會隨時間改變。
- 這個欄位的資料是由「ReportDevicePowerStatus」ReportDevicePowerStatus政策控管。
- 資料收集頻率:僅限上傳時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 需要精細權限:TELEMETRY_API_BATTERY_INFO
| JSON 表示法 |
|---|
{
"serialNumber": string,
"manufacturer": string,
"designCapacity": string,
"designMinVoltage": integer,
"manufactureDate": {
object ( |
| 欄位 | |
|---|---|
serialNumber |
僅供輸出。電池序號。 |
manufacturer |
僅供輸出。電池製造商。 |
designCapacity |
僅供輸出。設計容量 (毫安培小時)。 |
designMinVoltage |
僅供輸出。設計的最低輸出電壓 (mV) |
manufactureDate |
僅供輸出。電池的製造日期。 |
technology |
僅供輸出。電池技術。範例:鋰離子 |
BatteryStatusReport
電池狀態資料。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料是由「ReportDevicePowerStatus」ReportDevicePowerStatus政策控管。
- 資料收集頻率:僅限上傳時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_BATTERY_REPORT
| JSON 表示法 |
|---|
{ "reportTime": string, "serialNumber": string, "sample": [ { object ( |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。裝置上收集樣本的時間戳記 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
serialNumber |
僅供輸出。電池序號。 |
sample[] |
僅供輸出。電池的取樣資料,依 |
batteryHealth |
僅供輸出。電池健康度。 |
fullChargeCapacity |
僅供輸出。充飽電容量 (毫安培小時)。 |
cycleCount |
僅供輸出。充電週期數。 |
BatterySampleReport
電池的取樣資料。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料是由「ReportDevicePowerStatus」ReportDevicePowerStatus政策控管。
- 資料收集頻率:僅限上傳時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
| JSON 表示法 |
|---|
{ "reportTime": string, "voltage": string, "remainingCapacity": string, "temperature": integer, "dischargeRate": integer, "chargeRate": integer, "current": string, "status": string } |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。裝置上收集樣本的時間戳記 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
voltage |
僅供輸出。電池電壓 (毫伏特)。 |
remainingCapacity |
僅供輸出。電池剩餘電量 (毫安培小時)。 |
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」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」ReportDeviceStorageStatus政策控管。
- 資料收集頻率:僅限上傳時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_STORAGE_REPORT
| JSON 表示法 |
|---|
{
"reportTime": string,
"disk": [
{
object ( |
| 欄位 | |
|---|---|
reportTime |
僅供輸出。裝置上收集樣本的時間戳記 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
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 控制器和 DisplayPort 建立通道。移除擴充座下游的所有 PCIe 連結。 |
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL |
PCIE 通道已停用。 |
BootPerformanceReport
裝置的啟動效能報告。
- 這個欄位是遙測資訊,會隨著裝置使用情況而改變。
- 這個欄位的資料是由「ReportDeviceBootMode」ReportDeviceBootMode控管。
- 資料收集頻率:每次啟動時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:是
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_OS_REPORT
| JSON 表示法 |
|---|
{
"bootUpDuration": string,
"bootUpTime": string,
"shutdownDuration": string,
"shutdownTime": string,
"shutdownReason": enum ( |
| 欄位 | |
|---|---|
bootUpDuration |
啟動所需總時間。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
bootUpTime |
電源開啟時的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
shutdownDuration |
從開始關機到關機為止的總時間。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
shutdownTime |
關機時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
shutdownReason |
關閉原因。 |
reportTime |
收集報表的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
ShutdownReason
關閉原因。
| 列舉 | |
|---|---|
SHUTDOWN_REASON_UNSPECIFIED |
未指定關機原因。 |
USER_REQUEST |
使用者啟動。 |
SYSTEM_UPDATE |
已開始系統更新。 |
LOW_BATTERY |
因電量不足而關機。 |
OTHER |
因其他原因而關機。 |
HeartbeatStatusReport
裝置的心跳狀態報告。
- 適用於資訊亭
- 這個欄位會提供裝置的線上/離線/不明狀態,且只會在狀態變更時 (例如從「線上」變更為「離線」) 顯示
- 這個欄位的資料是透過「HeartbeatEnabled」HeartbeatEnabled政策控管。瞭解詳情
- 活動訊號頻率:2 分鐘
- 注意:如果裝置離線,系統最多可能需要 12 分鐘才能更新裝置的上線狀態
- 快取:如果裝置處於離線狀態,系統會將收集到的資料儲存在本機,並在裝置下次連上網路時回報:不適用
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_DEVICE_ACTIVITY_REPORT
| JSON 表示法 |
|---|
{
"reportTime": string,
"state": enum ( |
| 欄位 | |
|---|---|
reportTime |
偵測到狀態變更的時間戳記 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
state |
裝置變更後的狀態 |
州
裝置狀態
| 列舉 | |
|---|---|
STATE_UNSPECIFIED |
未指定州別 |
UNKNOWN |
裝置不符合心跳監控資格 |
ONLINE |
裝置已連上網路 |
OFFLINE |
裝置處於離線狀態 |
DEVICE_OUTDATED |
裝置版本過舊 |
KioskAppStatusReport
裝置的資訊站應用程式狀態報告。
- 適用於資訊亭
- 這個欄位會提供資訊站裝置上執行的應用程式 ID 和版本號碼,以及上次更新報表的時間戳記
- 這個欄位的資料由「ReportDeviceSessionStatus」ReportDeviceSessionStatus政策控管。
- 資料收集頻率:僅限上傳時
- 預設資料回報頻率:3 小時
- 受政策控管:是
- 快取:如果裝置處於離線狀態,系統會在本機儲存收集到的資料,並在裝置下次連上網路時回報:否
- 僅針對關聯使用者回報:不適用
- 必要精細權限:TELEMETRY_API_APPS_REPORT
| JSON 表示法 |
|---|
{ "reportTime": string, "appId": string, "appVersion": string } |
| 欄位 | |
|---|---|
reportTime |
收集報表的時間戳記 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
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 |
收集報表的時間戳記。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
uptimeRuntimeDuration |
生命週期總執行時間。目前一律是 Intel vPro PSR 的 S0 執行階段。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
enterSleepCount |
裝置進入休眠狀態的次數。目前透過 PSR 取得,從 S0->S3 開始計算。 |
enterHibernationCount |
裝置進入休眠狀態的次數。目前透過 PSR 取得,從 S0 到 S4 計算。 |
enterPoweroffCount |
裝置進入關機狀態的次數。目前透過 PSR 取得,從 S0 到 S5 計算。 |
方法 |
|
|---|---|
|
取得遙測裝置。 |
|
列出所有遙測裝置。 |