REST Resource: customers.telemetry.devices

Tài nguyên: TelemetryDevice

Dữ liệu đo từ xa được thu thập từ một thiết bị được quản lý.

  • Cần có quyền chi tiết: TELEMETRY_API_DEVICE
Biểu diễn dưới dạng 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)
    }
  ]
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của thiết bị.
customer

string

Chỉ có đầu ra. Khách hàng Google Workspace mà doanh nghiệp của họ đã đăng ký thiết bị.
orgUnitId

string

Chỉ có đầu ra. Mã nhận dạng đơn vị tổ chức của thiết bị.
deviceId

string

Chỉ có đầu ra. Mã Directory API duy nhất của thiết bị. Giá trị này giống với Mã Directory API của Bảng điều khiển dành cho quản trị viên trong thẻ Thiết bị ChromeOS
serialNumber

string

Chỉ có đầu ra. Số sê-ri của thiết bị. Giá trị này giống với Số sê-ri của Bảng điều khiển dành cho quản trị viên trong thẻ Thiết bị ChromeOS.
cpuInfo[]

object (CpuInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của CPU cho thiết bị.
cpuStatusReport[]

object (CpuStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái CPU được thu thập định kỳ được sắp xếp theo thứ tự giảm dần của reportTime.
memoryInfo

object (MemoryInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của bộ nhớ cho thiết bị.
memoryStatusReport[]

object (MemoryStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái bộ nhớ được thu thập định kỳ được sắp xếp theo thứ tự giảm dần theo reportTime.
networkInfo

object (NetworkInfo)

Chỉ có đầu ra. Thông tin về thiết bị mạng.
networkStatusReport[]

object (NetworkStatusReport)

Chỉ có đầu ra. Thông số kỹ thuật mạng được thu thập định kỳ.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Chỉ có đầu ra. Dữ liệu chẩn đoán mạng được thu thập định kỳ.
osUpdateStatus[]

object (OsUpdateStatus)

Chỉ có đầu ra. Chứa thông tin liên quan đến trạng thái cập nhật ChromeOS.
graphicsInfo

object (GraphicsInfo)

Chỉ có đầu ra. Chứa thông tin liên quan đến thiết bị ngoại vi Đồ hoạ cho thiết bị.
graphicsStatusReport[]

object (GraphicsStatusReport)

Chỉ có đầu ra. Báo cáo đồ hoạ được thu thập định kỳ.
batteryInfo[]

object (BatteryInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của pin cho thiết bị.
batteryStatusReport[]

object (BatteryStatusReport)

Chỉ có đầu ra. Báo cáo pin được thu thập định kỳ.
storageInfo

object (StorageInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của bộ nhớ cho thiết bị.
storageStatusReport[]

object (StorageStatusReport)

Chỉ có đầu ra. Báo cáo bộ nhớ được thu thập định kỳ.
thunderboltInfo[]

object (ThunderboltInfo)

Chỉ có đầu ra. Thông tin về bus Thunderbolt.
audioStatusReport[]

object (AudioStatusReport)

Chỉ có đầu ra. Các báo cáo âm thanh được thu thập định kỳ được sắp xếp theo thứ tự giảm dần của reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

Chỉ có đầu ra. Báo cáo hiệu suất khởi động của thiết bị.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái nhịp tim chứa các dấu thời gian được sắp xếp định kỳ theo thứ tự giảm dần của reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái ứng dụng kiosk cho thiết bị kiosk
networkBandwidthReport[]

object (NetworkBandwidthReport)

Chỉ có đầu ra. Báo cáo băng thông mạng được thu thập định kỳ được sắp xếp theo thứ tự giảm dần của reportTime.
peripheralsReport[]

object (PeripheralsReport)

Chỉ có đầu ra. Các báo cáo về thiết bị ngoại vi được thu thập định kỳ được sắp xếp theo thứ tự giảm dần của reportTime.
appReport[]

object (AppReport)

Chỉ có đầu ra. Các báo cáo ứng dụng được thu thập định kỳ được sắp xếp theo thứ tự giảm dần của reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

Chỉ có đầu ra. Bộ đếm thời gian chạy báo cáo thời gian chạy trong vòng đời của thiết bị đã thu thập, cũng như số lần chuyển đổi S0->S3, S0->S4 và S0->S5, nghĩa là chuyển sang trạng thái ngủ, ngủ đông và tắt nguồn

CpuInfo

Thông số kỹ thuật của CPU cho thiết bị

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_CPU_INFO
Biểu diễn dưới dạng JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Trường
model

string

Chỉ có đầu ra. Tên mẫu CPU. Ví dụ: CPU Intel(R) Core(TM) i5-8250U @ 1.60GHz
architecture

enum (Architecture)

Chỉ có đầu ra. Loại cấu trúc cho CPU.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
maxClockSpeed

integer

Chỉ có đầu ra. Tốc độ xung nhịp CPU tối đa tính bằng kHz.
keylockerSupported

boolean

Chỉ có đầu ra. Liệu có hỗ trợ khoá khoá hay không.
keylockerConfigured

boolean

Chỉ có đầu ra. Liệu keylocker có được định cấu hình hay không.TRUE = Đã bật; FALSE = đã tắt. Chỉ được báo cáo nếu keylockerSupported = TRUE.

Kiến trúc

Loại cấu trúc cho CPU.

Enum
ARCHITECTURE_UNSPECIFIED Cấu trúc không xác định.
X64 Kiến trúc x64

CpuStatusReport

Cung cấp thông tin về trạng thái của CPU.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: 10 phút/lần
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_CPU_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tính bằng mili giây, thể hiện thời điểm lấy mẫu báo cáo này.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
cpuUtilizationPct

integer

Chỉ có đầu ra. Mẫu mức sử dụng CPU (0-100%).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Chỉ có đầu ra. Thông tin mẫu nhiệt độ CPU cho mỗi nhân CPU theo độ C

CpuTemperatureInfo

Nhiệt độ CPU của một thiết bị. Lấy mẫu theo lõi CPU theo độ C.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: 10 phút/lần
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
Trường
temperatureCelsius

integer

Chỉ có đầu ra. Nhiệt độ CPU tính theo độ C.
label

string

Chỉ có đầu ra. Nhãn CPU. Ví dụ: Lõi 0

MemoryInfo

Thông tin bộ nhớ của thiết bị.

  • Trường này có cả dữ liệu đo từ xa và thông tin thiết bị:
    • totalRamBytes – Thông tin thiết bị
    • availableRamBytes – Thông tin đo từ xa
    • totalMemoryEncryption – Thông tin thiết bị
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu:
    • totalRamBytes – Chỉ khi tải lên
    • availableRamBytes – 10 phút một lần
    • totalMemoryEncryption – khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định:
    • totalRamBytes – 3 giờ
    • availableRamBytes – 3 giờ
    • totalMemoryEncryption – khi khởi động thiết bị
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị có mạng trở lại: chỉ dành cho totalMemoryEncryption
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_MEMORY_INFO
Biểu diễn dưới dạng JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Trường
totalRamBytes

string (int64 format)

Chỉ có đầu ra. Tổng dung lượng RAM tính bằng byte.
availableRamBytes

string (int64 format)

Chỉ có đầu ra. Dung lượng RAM còn trống tính bằng byte.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Chỉ có đầu ra. Thông tin về tính năng mã hoá tổng bộ nhớ cho thiết bị.

TotalMemoryEncryptionInfo

Thông tin về phương thức mã hoá bộ nhớ của một thiết bị.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi khởi động thiết bị
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Trường
encryptionState

enum (MemoryEncryptionState)

Trạng thái của quá trình mã hoá bộ nhớ trên thiết bị.
maxKeys

string (int64 format)

Số lượng khoá tối đa có thể dùng để mã hoá.
keyLength

string (int64 format)

Độ dài của khoá mã hoá.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Thuật toán mã hoá bộ nhớ.

MemoryEncryptionState

Trạng thái của quá trình mã hoá bộ nhớ trên thiết bị.

Enum
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Trạng thái mã hoá bộ nhớ chưa được đặt.
MEMORY_ENCRYPTION_STATE_UNKNOWN Không xác định được trạng thái mã hoá bộ nhớ.
MEMORY_ENCRYPTION_STATE_DISABLED Tính năng mã hoá bộ nhớ trên thiết bị đã bị tắt.
MEMORY_ENCRYPTION_STATE_TME Tính năng mã hoá bộ nhớ trên thiết bị sử dụng phương thức mã hoá tổng bộ nhớ.
MEMORY_ENCRYPTION_STATE_MKTME Tính năng mã hoá bộ nhớ trên thiết bị sử dụng phương thức mã hoá tổng bộ nhớ bằng nhiều khoá.

MemoryEncryptionAlgorithm

Thuật toán mã hoá đang được sử dụng trên thiết bị.

Enum
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED Chưa đặt thuật toán mã hoá bộ nhớ.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Không xác định được thuật toán mã hoá bộ nhớ đang được sử dụng.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 Thuật toán mã hoá bộ nhớ đang sử dụng thuật toán mã hoá AES_XTS với thuật toán khối 128 bit.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 Thuật toán mã hoá bộ nhớ đang sử dụng thuật toán mã hoá AES_XTS với thuật toán khối 256 bit.

MemoryStatusReport

Chứa các mẫu báo cáo trạng thái bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên, SystemRamFreeByes được thu thập 10 phút một lần
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ một lần
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_MEMORY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tính bằng mili giây, thể hiện thời điểm lấy mẫu báo cáo này.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
systemRamFreeBytes

string (int64 format)

Chỉ có đầu ra. Dung lượng RAM trống tính bằng byte (không đáng tin cậy do tính năng Thu thập rác).
pageFaults

integer

Chỉ có đầu ra. Số lỗi trên trang trong quá trình thu thập dữ liệu này

NetworkInfo

Thông tin về thiết bị mạng.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkDeviceConfiguration
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi khởi động thiết bị
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_INFO
Biểu diễn dưới dạng JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Trường
networkDevices[]

object (NetworkDevice)

Chỉ có đầu ra. Danh sách thiết bị mạng.

NetworkDevice

Thông tin chi tiết về thiết bị mạng.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkDeviceConfiguration
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi khởi động thiết bị
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Trường
type

enum (NetworkDeviceType)

Chỉ có đầu ra. Loại thiết bị mạng.
macAddress

string

Chỉ có đầu ra. Địa chỉ MAC (nếu có) của thiết bị mạng tương ứng.
meid

string

Chỉ có đầu ra. MEID (nếu có) của thiết bị mạng tương ứng.
imei

string

Chỉ có đầu ra. IMEI (nếu có) của thiết bị mạng tương ứng.
iccid

string

Chỉ có đầu ra. Mã thẻ mạch tích hợp được liên kết với thẻ SIM của thiết bị.
mdn

string

Chỉ có đầu ra. Số điện thoại trong danh bạ di động được liên kết với thẻ SIM của thiết bị.

NetworkDeviceType

Các loại thiết bị mạng.

Enum
NETWORK_DEVICE_TYPE_UNSPECIFIED Chưa chỉ định loại thiết bị mạng.
CELLULAR_DEVICE Thiết bị di động.
ETHERNET_DEVICE Thiết bị Ethernet.
WIFI_DEVICE Thiết bị Wi-Fi.

NetworkStatusReport

Trạng thái của các mạng hiển thị/đã định cấu hình.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkStatus
  • Tần suất thu thập dữ liệu: 60 phút
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Có
  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng 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)
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm báo cáo trạng thái mạng.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
signalStrengthDbm

integer

Chỉ có đầu ra. Cường độ tín hiệu của mạng không dây được đo bằng decibel.
lanIpAddress

string

Chỉ có đầu ra. Địa chỉ IP của mạng LAN.
gatewayIpAddress

string

Chỉ có đầu ra. Địa chỉ IP của cổng.
transmissionBitRateMbps

string (int64 format)

Chỉ có đầu ra. Tốc độ bit của hoạt động truyền được đo bằng Megabit/giây.
receivingBitRateMbps

string (int64 format)

Chỉ có đầu ra. Tốc độ bit nhận được đo bằng Megabit/giây.
transmissionPowerDbm

integer

Chỉ có đầu ra. Công suất truyền được đo bằng decibel.
encryptionOn

boolean

Chỉ có đầu ra. Liệu khoá mã hoá wifi có bị tắt hay không.
wifiPowerManagementEnabled

boolean

Chỉ có đầu ra. Đã bật tính năng quản lý nguồn Wi-Fi
guid

string

Chỉ có đầu ra. Mã nhận dạng duy nhất của kết nối mạng.
connectionState

enum (NetworkConnectionState)

Chỉ có đầu ra. Trạng thái kết nối hiện tại của mạng.
connectionType

enum (NetworkType)

Chỉ có đầu ra. Loại kết nối mạng.

NetworkType

Các loại kết nối mạng.

Enum
NETWORK_TYPE_UNSPECIFIED Chưa xác định loại kết nối mạng
CELLULAR Kết nối mạng di động.
ETHERNET Kết nối mạng Ethernet.
TETHER Kết nối mạng chia sẻ Internet.
VPN Kết nối mạng VPN.
WIFI Kết nối mạng Wi-Fi.

NetworkDiagnosticsReport

Kết quả kiểm thử mạng để xác định tình trạng kết nối mạng của thiết bị, ví dụ như độ trễ HTTPS có cao hay bình thường.

  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm thu thập dữ liệu chẩn đoán.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

Chỉ có đầu ra. Dữ liệu kiểm thử độ trễ HTTPS.

OsUpdateStatus

Chứa thông tin về trạng thái cập nhật hệ điều hành hiện tại.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceOsUpdateStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_OS_REPORT
Biểu diễn dưới dạng JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Trường
updateState

enum (UpdateState)

Chỉ có đầu ra. Trạng thái hiện tại của bản cập nhật hệ điều hành.
newPlatformVersion

string

Chỉ có đầu ra. Phiên bản nền tảng mới của hình ảnh hệ điều hành đang được tải xuống và áp dụng. Giá trị này chỉ được đặt khi trạng thái cập nhật là OS_IMAGE_DOWNLOAD_IN_PROGRESS hoặc OS_UPDATE_NEED_REBOOT. Lưu ý rằng đây có thể là giá trị "0.0.0.0" giả cho trạng thái OS_UPDATE_NEED_REBOOT trong một số trường hợp đặc biệt, ví dụ: công cụ cập nhật được khởi động lại mà không cần khởi động lại.
newRequestedPlatformVersion

string

Chỉ có đầu ra. Phiên bản nền tảng mới được yêu cầu từ ứng dụng kiosk đang chờ cập nhật.
lastUpdateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần cập nhật thành công gần đây nhất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần kiểm tra bản cập nhật gần đây nhất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần khởi động lại gần đây nhất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

UpdateState

Trạng thái của bản cập nhật hệ điều hành

Enum
UPDATE_STATE_UNSPECIFIED Trạng thái chưa được chỉ định.
OS_IMAGE_DOWNLOAD_NOT_STARTED Hệ điều hành chưa bắt đầu tải xuống.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Hệ điều hành đã bắt đầu tải xuống thiết bị.
OS_UPDATE_NEED_REBOOT Thiết bị cần khởi động lại để hoàn tất quá trình tải lên.

GraphicsInfo

Thông tin về hệ thống con đồ hoạ.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceGraphicsStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_GRAPHICS_INFO
Biểu diễn dưới dạng JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Trường
adapterInfo

object (GraphicsAdapterInfo)

Chỉ có đầu ra. Thông tin về bộ chuyển đổi đồ hoạ (GPU).
eprivacySupported

boolean

Chỉ có đầu ra. Liệu màn hình ePrivacy có được hỗ trợ hay không.
displayDevices[]

object (DisplayDevice)

Chỉ có đầu ra. Thông tin về(các) màn hình của thiết bị.
touchScreenInfo

object (TouchScreenInfo)

Chỉ có đầu ra. Thông tin về(các) màn hình cảm ứng bên trong của thiết bị.

GraphicsAdapterInfo

Thông tin về bộ chuyển đổi đồ hoạ (GPU).

Biểu diễn dưới dạng JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Trường
adapter

string

Chỉ có đầu ra. Tên bộ chuyển đổi. Ví dụ: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

Chỉ có đầu ra. Phiên bản trình điều khiển GPU.
deviceId

string (int64 format)

Chỉ có đầu ra. Biểu thị mã thiết bị của thẻ đồ hoạ.

DisplayDevice

Thông tin về thiết bị hiển thị.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
Trường
displayName

string

Chỉ có đầu ra. Hiển thị tên thiết bị.
displayWidthMm

integer

Chỉ có đầu ra. Chiều rộng màn hình tính bằng milimet.
displayHeightMm

integer

Chỉ có đầu ra. Chiều cao màn hình tính bằng milimet.
internal

boolean

Chỉ có đầu ra. Màn hình có phải là màn hình nội bộ hay không.
manufacturerId

string

Chỉ có đầu ra. Mã nhận dạng nhà sản xuất gồm 3 chữ cái.
modelId

integer

Chỉ có đầu ra. Mã sản phẩm của nhà sản xuất.
manufactureYear

integer

Chỉ có đầu ra. Năm sản xuất.

TouchScreenInfo

Thông tin trên màn hình cảm ứng của thiết bị.

Biểu diễn dưới dạng JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Trường
touchpadLibrary

string

Chỉ có đầu ra. Tên thư viện bàn di chuột mà ngăn xếp đầu vào sử dụng.
devices[]

object (TouchScreenDevice)

Chỉ có đầu ra. Danh sách các thiết bị màn hình cảm ứng tích hợp.

TouchScreenDevice

Thông tin về thiết bị màn hình cảm ứng bên trong.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của thiết bị màn hình cảm ứng.
touchPointCount

integer

Chỉ có đầu ra. Số điểm chạm được hỗ trợ trên thiết bị.
stylusCapable

boolean

Chỉ có đầu ra. Thiết bị màn hình cảm ứng có hỗ trợ bút cảm ứng hay không.

GraphicsStatusReport

Thông tin về hệ thống con đồ hoạ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceGraphicsInfo
  • Tần suất thu thập dữ liệu: 3 giờ.
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_GRAPHICS_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian báo cáo dữ liệu đồ hoạ.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

Chỉ có đầu ra. Thông tin về màn hình của thiết bị.

DisplayInfo

Thông tin cho màn hình.

Biểu diễn dưới dạng JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
Trường
deviceId

string (int64 format)

Chỉ có đầu ra. Biểu thị mã thiết bị của thẻ đồ hoạ.
resolutionWidth

integer

Chỉ có đầu ra. Chiều rộng độ phân giải tính bằng pixel.
resolutionHeight

integer

Chỉ có đầu ra. Chiều cao độ phân giải tính bằng pixel.
refreshRate

integer

Chỉ có đầu ra. Tốc độ làm mới tính bằng Hz.
isInternal

boolean

Chỉ có đầu ra. Cho biết màn hình có phải là màn hình nội bộ hay không.
displayName

string

Chỉ có đầu ra. Hiển thị tên thiết bị.

BatteryInfo

Thông tin về pin.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_BATTERY_INFO
Biểu diễn dưới dạng JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Trường
serialNumber

string

Chỉ có đầu ra. Số sê-ri của pin.
manufacturer

string

Chỉ có đầu ra. Nhà sản xuất pin.
designCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng thiết kế (mA-giờ).
designMinVoltage

integer

Chỉ có đầu ra. Điện áp đầu ra tối thiểu được thiết kế (mV)
manufactureDate

object (Date)

Chỉ có đầu ra. Ngày sản xuất pin.
technology

string

Chỉ có đầu ra. Công nghệ pin. Ví dụ: Li-ion

BatteryStatusReport

Dữ liệu trạng thái của pin.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_BATTERY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm thu thập mẫu trên thiết bị

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
serialNumber

string

Chỉ có đầu ra. Số sê-ri của pin.
sample[]

object (BatterySampleReport)

Chỉ có đầu ra. Dữ liệu lấy mẫu cho pin được sắp xếp theo thứ tự giảm dần của reportTime.
batteryHealth

enum (BatteryHealth)

Chỉ có đầu ra. Tình trạng pin.
fullChargeCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng khi sạc đầy (mA-giờ).
cycleCount

integer

Chỉ có đầu ra. Số chu kỳ.

BatterySampleReport

Lấy mẫu dữ liệu cho pin.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm thu thập mẫu trên thiết bị

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

Chỉ có đầu ra. Điện áp pin (millivolt).
remainingCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng pin còn lại (mA-giờ).
temperature

integer

Chỉ có đầu ra. Nhiệt độ theo độ C.
dischargeRate

integer

Chỉ có đầu ra. Tốc độ xả pin được đo bằng mW. Dấu dương nếu pin đang xả, dấu âm nếu pin đang sạc.
chargeRate

integer

Chỉ có đầu ra. Phần trăm pin.
current

string (int64 format)

Chỉ có đầu ra. Dòng pin (mA).
status

string

Chỉ có đầu ra. Trạng thái pin được đọc từ sysfs. Ví dụ: Xả

BatteryHealth

Thể hiện tình trạng pin hiện tại.

  • Trạng thái này không phải là chỉ báo hoặc dấu hiệu cho thấy pin bị lỗi. Giá trị này được tính bằng cách chia dung lượng pin đầy hiện tại cho dung lượng thiết kế.
  • Nhà sản xuất có toàn quyền xác định tính toàn vẹn của pin và chính sách bảo hành.
Enum
BATTERY_HEALTH_UNSPECIFIED Không xác định được tình trạng sức khoẻ.
BATTERY_HEALTH_NORMAL Pin ở trạng thái tốt, dung lượng khi sạc đầy / dung lượng thiết kế > 80%
BATTERY_REPLACE_SOON Pin ở trạng thái không tốt và bạn nên sớm thay pin, dung lượng pin đầy / dung lượng thiết kế 75% – 80%
BATTERY_REPLACE_NOW Pin không còn tốt và bạn nên thay pin, dung lượng pin khi sạc đầy / dung lượng thiết kế < 75%

StorageInfo

Dữ liệu trạng thái cho bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceStorageStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_STORAGE_INFO
Biểu diễn dưới dạng JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Trường
volume[]

object (DiskVolume)

Thông tin về các phương tiện lưu trữ
availableDiskBytes

string (int64 format)

Dung lượng còn trống để lưu trữ dữ liệu người dùng trong thiết bị tính bằng byte.
totalDiskBytes

string (int64 format)

Tổng dung lượng lưu trữ dữ liệu người dùng trong thiết bị tính bằng byte.

DiskVolume

Thông tin về các phương tiện lưu trữ

Biểu diễn dưới dạng JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Trường
volumeId

string

Mã ổ đĩa.
storageFreeBytes

string (int64 format)

Dung lượng lưu trữ trống tính bằng byte.
storageTotalBytes

string (int64 format)

Tổng dung lượng bộ nhớ tính bằng byte.

StorageStatusReport

Dữ liệu trạng thái cho bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceStorageStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_STORAGE_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm thu thập mẫu trên thiết bị

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

Chỉ có đầu ra. Báo cáo trên ổ đĩa.

DiskInfo

Trạng thái của một thiết bị lưu trữ.

Biểu diễn dưới dạng 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
}
Trường
serialNumber

string

Chỉ có đầu ra. Số sê-ri của ổ đĩa.
manufacturer

string

Chỉ có đầu ra. Nhà sản xuất ổ đĩa.
model

string

Chỉ có đầu ra. Mẫu ổ đĩa.
sizeBytes

string (int64 format)

Chỉ có đầu ra. Dung lượng ổ đĩa.
type

string

Chỉ có đầu ra. Loại ổ đĩa: eMMC / NVMe / ATA / SCSI.
health

string

Chỉ có đầu ra. Tình trạng ổ đĩa.
volumeIds[]

string

Chỉ có đầu ra. Dung lượng ổ đĩa.
bytesReadThisSession

string (int64 format)

Chỉ có đầu ra. Số byte đã đọc kể từ lần khởi động gần đây nhất.
bytesWrittenThisSession

string (int64 format)

Chỉ có đầu ra. Số byte được ghi kể từ lần khởi động gần đây nhất.
readTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian đọc từ ổ đĩa kể từ lần khởi động gần đây nhất.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
writeTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian ghi vào ổ đĩa kể từ lần khởi động gần đây nhất.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
ioTimeThisSession

string (Duration format)

Chỉ có đầu ra. Đếm thời gian ổ đĩa và hàng đợi đang bận. Vì vậy, không giống như các trường ở trên, các yêu cầu song song không được tính nhiều lần.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
discardTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian huỷ bỏ kể từ lần khởi động gần đây nhất. Việc loại bỏ là ghi để xoá các khối không còn được sử dụng. Được hỗ trợ trên các hạt nhân 4.18 trở lên.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

ThunderboltInfo

Thông tin về bus Thunderbolt.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceSecurityStatus
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi khởi động thiết bị
    • Có kiểm soát theo chính sách: Không
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_BUS_DEVICE_INFO
Biểu diễn dưới dạng JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Trường
securityLevel

enum (ThunderboltSecurityLevel)

Mức bảo mật của bus Thunderbolt.

ThunderboltSecurityLevel

Mức bảo mật của bus Thunderbolt.

Enum
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Bạn chưa đặt cấp độ bảo mật Thunderbolt.
THUNDERBOLT_SECURITY_NONE_LEVEL Tất cả thiết bị đều được kết nối tự động bằng phần mềm. Không cần người dùng phê duyệt.
THUNDERBOLT_SECURITY_USER_LEVEL Người dùng được hỏi xem có cho phép kết nối thiết bị hay không.
THUNDERBOLT_SECURITY_SECURE_LEVEL Người dùng được hỏi xem có cho phép kết nối thiết bị hay không. Ngoài ra, thiết bị sẽ được gửi một thử thách khớp với thử thách dự kiến dựa trên khoá ngẫu nhiên được ghi vào thuộc tính sysfs khoá
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Firmware sẽ tự động tạo đường hầm cho Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Phần mềm cơ sở sẽ tự động tạo đường hầm cho bộ điều khiển USB và Cổng hiển thị trong một đế cắm. Tất cả các đường liên kết PCIe ở hạ nguồn của đế cắm đều bị xoá.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Tính năng tạo đường hầm PCIE bị tắt.

BootPerformanceReport

Báo cáo hiệu suất khởi động của thiết bị.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceBootMode
  • Tần suất thu thập dữ liệu: Trong mỗi sự kiện khởi động
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_OS_REPORT
Biểu diễn dưới dạng JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Trường
bootUpDuration

string (Duration format)

Tổng thời gian khởi động.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
bootUpTime

string (Timestamp format)

Dấu thời gian khi nguồn điện bật.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

Tổng thời gian từ khi bắt đầu tắt cho đến khi tắt nguồn.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
shutdownTime

string (Timestamp format)

Dấu thời gian khi tắt máy.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

Lý do tắt máy.
reportTime

string (Timestamp format)

Dấu thời gian khi thu thập báo cáo.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

ShutdownReason

Lý do tắt máy.

Enum
SHUTDOWN_REASON_UNSPECIFIED Chưa xác định được lý do tắt máy.
USER_REQUEST Do người dùng thực hiện.
SYSTEM_UPDATE Đã bắt đầu cập nhật hệ thống.
LOW_BATTERY Tắt do pin yếu.
OTHER Tắt máy do các lý do khác.

HeartbeatStatusReport

Báo cáo trạng thái nhịp tim của một thiết bị.

  • Có sẵn cho Kiosk
  • Trường này cung cấp trạng thái trực tuyến/ngoại tuyến/không xác định của một thiết bị và sẽ chỉ được đưa vào nếu trạng thái đã thay đổi (ví dụ: Trực tuyến -> Ngoại tuyến)
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: HeartbeatEnabled Thông tin khác
  • Tần suất nhịp tim: 2 phút
    • Lưu ý: Nếu một thiết bị không có mạng, có thể mất đến 12 phút để cập nhật trạng thái trực tuyến của thiết bị
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không áp dụng
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "state": enum (State)
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian của thời điểm phát hiện trạng thái thay đổi

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
state

enum (State)

Trạng thái thiết bị đã thay đổi thành

Tiểu bang

Trạng thái thiết bị

Enum
STATE_UNSPECIFIED Trạng thái không được chỉ định
UNKNOWN Thiết bị không đủ điều kiện để theo dõi nhịp tim
ONLINE Thiết bị có kết nối mạng
OFFLINE Thiết bị hiện không có kết nối mạng
DEVICE_OUTDATED Thiết bị đã lỗi thời

KioskAppStatusReport

Báo cáo trạng thái ứng dụng Kiosk của một thiết bị.

  • Có sẵn cho Kiosk
  • Trường này cung cấp mã ứng dụng và số phiên bản đang chạy trên thiết bị kiosk, cũng như dấu thời gian của lần cập nhật báo cáo gần đây nhất
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceSessionStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Có kiểm soát theo chính sách: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị có mạng: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_APPS_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm thu thập báo cáo

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
appId

string

Mã ứng dụng của ứng dụng kiosk, ví dụ: "mdmkkicfmmkgmpkmkdikhlbggogpicma"
appVersion

string

Số phiên bản ứng dụng của ứng dụng kiosk, ví dụ: "1.10.118"

RuntimeCountersReport

Bộ đếm thời gian chạy được truy xuất từ CPU. Hiện tại, Intel vPro PSR trên thế hệ 14 trở lên chỉ hỗ trợ tính năng đo từ xa của bộ đếm thời gian chạy.

Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian khi thu thập báo cáo.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Tổng thời gian chạy trong vòng đời. Hiện tại, thời gian chạy S0 luôn được cung cấp từ Intel vPro PSR.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
enterSleepCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái ngủ. Hiện được lấy qua PSR, tính từ S0->S3.
enterHibernationCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái ngủ đông. Hiện được lấy qua PSR, tính từ S0->S4.
enterPoweroffCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái tắt. Hiện được lấy qua PSR, tính từ S0->S5.

Phương thức

get

 Lấy thiết bị đo từ xa.

list

 Liệt kê tất cả thiết bị đo từ xa.