REST Resource: customers.telemetry.devices

Zasób: TelemetryDevice

Dane telemetryczne zbierane z zarządzanego urządzenia.

  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_DEVICE
Zapis 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)
    }
  ]
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu urządzenia.

customer

string

Tylko dane wyjściowe. Klient Google Workspace, którego firma zarejestrowała urządzenie.

orgUnitId

string

Tylko dane wyjściowe. Identyfikator jednostki organizacyjnej urządzenia.

deviceId

string

Tylko dane wyjściowe. Unikalny identyfikator interfejsu Directory API urządzenia. Ta wartość jest taka sama jak identyfikator interfejsu Directory API w konsoli administracyjnej na karcie Urządzenia z ChromeOS.

serialNumber

string

Tylko dane wyjściowe. Numer seryjny urządzenia. Ta wartość jest taka sama jak numer seryjny w konsoli administracyjnej na karcie Urządzenia z ChromeOS.

cpuInfo[]

object (CpuInfo)

Tylko dane wyjściowe. Informacje o specyfikacji procesora urządzenia.

cpuStatusReport[]

object (CpuStatusReport)

Tylko dane wyjściowe. Okresowo zbierane raporty o stanie procesora posortowane malejąco według wartości reportTime.

memoryInfo

object (MemoryInfo)

Tylko dane wyjściowe. Informacje o specyfikacji pamięci urządzenia.

memoryStatusReport[]

object (MemoryStatusReport)

Tylko dane wyjściowe. Raporty o stanie pamięci zbierane okresowo i sortowane malejąco według kolumny reportTime.

networkInfo

object (NetworkInfo)

Tylko dane wyjściowe. Informacje o urządzeniach sieciowych.

networkStatusReport[]

object (NetworkStatusReport)

Tylko dane wyjściowe. Specyfikacje sieci zbierane okresowo.

networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Tylko dane wyjściowe. Dane diagnostyczne sieci są zbierane okresowo.

osUpdateStatus[]

object (OsUpdateStatus)

Tylko dane wyjściowe. Zawiera istotne informacje dotyczące stanu aktualizacji ChromeOS.

graphicsInfo

object (GraphicsInfo)

Tylko dane wyjściowe. Zawiera informacje o urządzeniach peryferyjnych graficznych dla urządzenia.

graphicsStatusReport[]

object (GraphicsStatusReport)

Tylko dane wyjściowe. Raporty dotyczące grafiki są zbierane okresowo.

batteryInfo[]

object (BatteryInfo)

Tylko dane wyjściowe. Informacje o specyfikacji baterii urządzenia.

batteryStatusReport[]

object (BatteryStatusReport)

Tylko dane wyjściowe. Raporty o stanie baterii są zbierane okresowo.

storageInfo

object (StorageInfo)

Tylko dane wyjściowe. Informacje o specyfikacji pamięci urządzenia.

storageStatusReport[]

object (StorageStatusReport)

Tylko dane wyjściowe. Raporty dotyczące miejsca na dane są zbierane okresowo.

thunderboltInfo[]

object (ThunderboltInfo)

Tylko dane wyjściowe. Informacje o magistrali Thunderbolt.

audioStatusReport[]

object (AudioStatusReport)

Tylko dane wyjściowe. Okresowo zbierane raporty audio posortowane malejąco według reportTime.

bootPerformanceReport[]

object (BootPerformanceReport)

Tylko dane wyjściowe. Raporty o wydajności uruchamiania urządzenia.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

Tylko dane wyjściowe. Raport o stanie sygnału zwrotnego zawierający sygnatury czasowe okresowo sortowane w porządku malejącym według reportTime

kioskAppStatusReport[]

object (KioskAppStatusReport)

Tylko dane wyjściowe. Raport o stanie aplikacji kiosku na urządzeniu kiosku

networkBandwidthReport[]

object (NetworkBandwidthReport)

Tylko dane wyjściowe. Okresowo zbierane raporty o przepustowości sieci posortowane malejąco według wartości reportTime.

peripheralsReport[]

object (PeripheralsReport)

Tylko dane wyjściowe. Raporty dotyczące urządzeń peryferyjnych zbierane okresowo i posortowane malejąco według reportTime.

appReport[]

object (AppReport)

Tylko dane wyjściowe. Okresowo zbierane raporty o aplikacjach posortowane malejąco według reportTime.

runtimeCountersReport[]

object (RuntimeCountersReport)

Tylko dane wyjściowe. Raporty z liczników czasu działania zawierają informacje o czasie działania urządzenia przez cały okres jego użytkowania, a także liczbę przejść ze stanu S0 do S3, S0 do S4 i S0 do S5, czyli przejść do stanu uśpienia, hibernacji i wyłączenia.

CpuInfo

Specyfikacja procesora urządzenia

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceCpuInfo.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_CPU_INFO
Zapis JSON
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Pola
model

string

Tylko dane wyjściowe. Nazwa modelu procesora. Przykład: Intel(R) Core(TM) i5-8250U CPU @ 1,60 GHz

architecture

enum (Architecture)

Tylko dane wyjściowe. Typ architektury procesora.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceCpuInfo.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
maxClockSpeed

integer

Tylko dane wyjściowe. Maksymalne taktowanie procesora w kHz.

keylockerSupported

boolean

Tylko dane wyjściowe. Określa, czy magazyn kluczy jest obsługiwany.

keylockerConfigured

boolean

Tylko dane wyjściowe. Informacja, czy magazyn kluczy jest skonfigurowany.TRUE = włączone, FALSE = wyłączone. Raportowane tylko wtedy, gdy keylockerSupported = TRUE.

Architektura

Typ architektury procesora.

Wartości w polu enum
ARCHITECTURE_UNSPECIFIED Architektura nieznana.
X64 architektura x64,

CpuStatusReport

Zawiera informacje o stanie procesora.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceCpuInfo.
  • Częstotliwość zbierania danych: co 10 minut
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_CPU_REPORT
Zapis JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa w milisekundach reprezentująca czas, w którym ten raport został próbkowany.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Tylko dane wyjściowe. Częstotliwość próbkowania raportu.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

cpuUtilizationPct

integer

Tylko dane wyjściowe. Próbka wykorzystania procesora (0–100%).

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Tylko dane wyjściowe. Informacje o próbkach temperatury procesora dla każdego rdzenia procesora w stopniach Celsjusza

CpuTemperatureInfo

temperatura procesora urządzenia. Próbkowanie odbywa się dla każdego rdzenia procesora w stopniach Celsjusza.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceCpuInfo.
  • Częstotliwość zbierania danych: co 10 minut
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
Zapis JSON
{
  "temperatureCelsius": integer,
  "label": string
}
Pola
temperatureCelsius

integer

Tylko dane wyjściowe. Temperatura procesora w stopniach Celsjusza.

label

string

Tylko dane wyjściowe. Etykieta procesora. Przykład: Core 0

MemoryInfo

Informacje o pamięci urządzenia.

  • To pole zawiera zarówno dane telemetryczne, jak i informacje o urządzeniu:
    • totalRamBytes – Informacje o urządzeniu
    • availableRamBytes – Informacje telemetryczne
    • totalMemoryEncryption – Informacje o urządzeniu
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceMemoryInfo.
  • Częstotliwość zbierania danych:
    • totalRamBytes – tylko podczas przesyłania
    • availableRamBytes – co 10 minut
    • totalMemoryEncryption – podczas uruchamiania urządzenia.
  • Domyślna częstotliwość raportowania danych:
    • totalRamBytes – 3 godziny
    • availableRamBytes – 3 godziny
    • totalMemoryEncryption – podczas uruchamiania urządzenia.
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną zgłoszone, gdy urządzenie będzie ponownie online: tylko w przypadku totalMemoryEncryption.
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_MEMORY_INFO
Zapis JSON
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Pola
totalRamBytes

string (int64 format)

Tylko dane wyjściowe. Łączna ilość pamięci RAM w bajtach.

availableRamBytes

string (int64 format)

Tylko dane wyjściowe. Ilość dostępnej pamięci RAM w bajtach.

totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Tylko dane wyjściowe. Informacje o szyfrowaniu całej pamięci na urządzeniu.

TotalMemoryEncryptionInfo

Informacje o szyfrowaniu pamięci urządzenia.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceMemoryInfo.
  • Częstotliwość zbierania danych: przy uruchamianiu urządzenia
  • Domyślna częstotliwość raportowania danych: przy uruchamianiu urządzenia
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
Zapis JSON
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Pola
encryptionState

enum (MemoryEncryptionState)

Stan szyfrowania pamięci na urządzeniu.

maxKeys

string (int64 format)

Maksymalna liczba kluczy, których można używać do szyfrowania.

keyLength

string (int64 format)

Długość kluczy szyfrowania.

encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Algorytm szyfrowania pamięci.

MemoryEncryptionState

Stan szyfrowania pamięci na urządzeniu.

Wartości w polu enum
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Stan szyfrowania pamięci nie jest ustawiony.
MEMORY_ENCRYPTION_STATE_UNKNOWN Stan szyfrowania pamięci jest nieznany.
MEMORY_ENCRYPTION_STATE_DISABLED Szyfrowanie pamięci na urządzeniu jest wyłączone.
MEMORY_ENCRYPTION_STATE_TME Szyfrowanie pamięci na urządzeniu wykorzystuje szyfrowanie całej pamięci.
MEMORY_ENCRYPTION_STATE_MKTME Na urządzeniu używane jest szyfrowanie całej pamięci przy użyciu wielu kluczy.

MemoryEncryptionAlgorithm

Algorytm szyfrowania używany na urządzeniu.

Wartości w polu enum
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED Algorytm szyfrowania pamięci nie został ustawiony.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Używany algorytm szyfrowania pamięci jest nieznany.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 Algorytm szyfrowania pamięci używa algorytmu szyfrowania AES_XTS ze 128-bitowym szyfrem blokowym.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 Używany jest algorytm szyfrowania AES_XTS z 256-bitowym szyfrem blokowym.

MemoryStatusReport

Zawiera przykłady raportów o stanie pamięci.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceMemoryInfo.
  • Częstotliwość zbierania danych: tylko podczas przesyłania. Wartość SystemRamFreeByes jest zbierana co 10 minut.
  • Domyślna częstotliwość raportowania danych: co 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_MEMORY_REPORT
Zapis JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa w milisekundach reprezentująca czas, w którym ten raport został próbkowany.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Tylko dane wyjściowe. Częstotliwość próbkowania raportu.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

systemRamFreeBytes

string (int64 format)

Tylko dane wyjściowe. Ilość wolnej pamięci RAM w bajtach (niewiarygodna ze względu na odśmiecanie pamięci).

pageFaults

integer

Tylko dane wyjściowe. Liczba błędów strony podczas tego zbierania

NetworkInfo

Informacje o urządzeniu sieciowym.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportNetworkDeviceConfiguration.
  • Częstotliwość zbierania danych: przy uruchamianiu urządzenia
  • Domyślna częstotliwość raportowania danych: przy uruchamianiu urządzenia
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_NETWORK_INFO
Zapis JSON
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Pola
networkDevices[]

object (NetworkDevice)

Tylko dane wyjściowe. Lista urządzeń sieciowych.

NetworkDevice

Szczegółowe informacje o urządzeniu sieciowym.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportNetworkDeviceConfiguration.
  • Częstotliwość zbierania danych: przy uruchamianiu urządzenia
  • Domyślna częstotliwość raportowania danych: przy uruchamianiu urządzenia
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
Zapis JSON
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Pola
type

enum (NetworkDeviceType)

Tylko dane wyjściowe. Typ urządzenia sieciowego.

macAddress

string

Tylko dane wyjściowe. Adres MAC (jeśli dotyczy) odpowiedniego urządzenia sieciowego.

meid

string

Tylko dane wyjściowe. Identyfikator MEID (jeśli dotyczy) odpowiedniego urządzenia sieciowego.

imei

string

Tylko dane wyjściowe. Numer IMEI (jeśli dotyczy) odpowiedniego urządzenia sieciowego.

iccid

string

Tylko dane wyjściowe. Identyfikator karty z układem scalonym powiązanej z kartą SIM urządzenia.

mdn

string

Tylko dane wyjściowe. Numer katalogu mobilnego powiązany z kartą SIM urządzenia.

NetworkDeviceType

Typy urządzeń sieciowych.

Wartości w polu enum
NETWORK_DEVICE_TYPE_UNSPECIFIED Nieokreślony typ urządzenia sieciowego.
CELLULAR_DEVICE urządzenie komórkowe;
ETHERNET_DEVICE urządzenie Ethernet,
WIFI_DEVICE Urządzenie Wi-Fi.

NetworkStatusReport

Stan widocznych/skonfigurowanych sieci.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportNetworkStatus.
  • Częstotliwość zbierania danych: 60 minut
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: tak
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_NETWORK_REPORT
Zapis 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),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym zgłoszono stan sieci.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Tylko dane wyjściowe. Częstotliwość próbkowania raportu.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

signalStrengthDbm

integer

Tylko dane wyjściowe. Siła sygnału w sieciach bezprzewodowych mierzona w decybelach.

lanIpAddress

string

Tylko dane wyjściowe. Adres IP w sieci LAN.

gatewayIpAddress

string

Tylko dane wyjściowe. Adres IP bramy.

transmissionBitRateMbps

string (int64 format)

Tylko dane wyjściowe. Szybkość transmisji bitów mierzona w megabitach na sekundę.

receivingBitRateMbps

string (int64 format)

Tylko dane wyjściowe. Szybkość odbierania bitów mierzona w megabitach na sekundę.

transmissionPowerDbm

integer

Tylko dane wyjściowe. Moc transmisji mierzona w decybelach.

encryptionOn

boolean

Tylko dane wyjściowe. Określa, czy klucz szyfrowania Wi-Fi jest wyłączony.

wifiPowerManagementEnabled

boolean

Tylko dane wyjściowe. Zarządzanie zasilaniem Wi-Fi jest włączone

guid

string

Tylko dane wyjściowe. Identyfikator GUID połączenia sieciowego.

connectionState

enum (NetworkConnectionState)

Tylko dane wyjściowe. Bieżący stan połączenia sieciowego.

connectionType

enum (NetworkType)

Tylko dane wyjściowe. Typ połączenia sieciowego.

ipv6Address[]

string

Tylko dane wyjściowe. Adresy IPv6 przypisane do tej sieci (jeśli takie istnieją). Każdy adres jest ciągiem znaków w standardowej tekstowej reprezentacji IPv6 (np. „2001:db8::1”).

gatewayIpv6Address

string

Tylko dane wyjściowe. Adres IPv6 bramy dla tego interfejsu, jeśli został wykryty.

metered

boolean

Tylko dane wyjściowe. Czy sieć została wykryta jako mierzona.

NetworkType

Typy połączeń sieciowych.

Wartości w polu enum
NETWORK_TYPE_UNSPECIFIED Nieokreślony typ połączenia sieciowego
CELLULAR Połączenie z siecią komórkową.
ETHERNET Połączenie sieciowe Ethernet.
TETHER Połączenie sieciowe w tetheringu.
VPN Połączenie z siecią VPN.
WIFI Połączenie z siecią Wi-Fi.

NetworkDiagnosticsReport

Wyniki testów sieciowych, które pozwalają określić stan połączenia sieciowego urządzenia, np. czy opóźnienie HTTPS jest wysokie czy normalne.

  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_NETWORK_REPORT
Zapis JSON
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa zebrania danych diagnostycznych.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

httpsLatencyData

object (HttpsLatencyRoutineData)

Tylko dane wyjściowe. Dane testu opóźnienia HTTPS.

OsUpdateStatus

Zawiera informacje o bieżącym stanie aktualizacji systemu operacyjnego.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceOsUpdateStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_OS_REPORT
Zapis JSON
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Pola
updateState

enum (UpdateState)

Tylko dane wyjściowe. Bieżący stan aktualizacji systemu operacyjnego.

newPlatformVersion

string

Tylko dane wyjściowe. Pobierana i stosowana jest nowa wersja platformy obrazu systemu operacyjnego. Jest ustawiany tylko wtedy, gdy stan aktualizacji to OS_IMAGE_DOWNLOAD_IN_PROGRESS lub OS_UPDATE_NEED_REBOOT. W niektórych przypadkach może to być fikcyjny adres „0.0.0.0” w przypadku stanu OS_UPDATE_NEED_REBOOT, np. gdy silnik aktualizacji zostanie ponownie uruchomiony bez ponownego uruchomienia urządzenia.

newRequestedPlatformVersion

string

Tylko dane wyjściowe. Nowa wersja platformy wymagana przez oczekującą aktualizację aplikacji kiosku.

lastUpdateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej pomyślnej aktualizacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastUpdateCheckTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego sprawdzenia aktualizacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastRebootTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego ponownego uruchomienia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

UpdateState

Stan aktualizacji systemu operacyjnego

Wartości w polu enum
UPDATE_STATE_UNSPECIFIED Stan nieokreślony.
OS_IMAGE_DOWNLOAD_NOT_STARTED System operacyjny nie rozpoczął pobierania.
OS_IMAGE_DOWNLOAD_IN_PROGRESS System operacyjny rozpoczął pobieranie na urządzenie.
OS_UPDATE_NEED_REBOOT Urządzenie musi zostać ponownie uruchomione, aby dokończyć przesyłanie.

GraphicsInfo

Informacje o podsystemie graficznym.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceGraphicsStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_GRAPHICS_INFO
Zapis JSON
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Pola
adapterInfo

object (GraphicsAdapterInfo)

Tylko dane wyjściowe. Informacje o karcie graficznej (GPU).

eprivacySupported

boolean

Tylko dane wyjściowe. Określa, czy ekran e-prywatności jest obsługiwany.

displayDevices[]

object (DisplayDevice)

Tylko dane wyjściowe. Informacje o wyświetlaczach urządzenia.

touchScreenInfo

object (TouchScreenInfo)

Tylko dane wyjściowe. Informacje o wewnętrznych ekranach dotykowych urządzenia.

GraphicsAdapterInfo

Informacje o karcie graficznej (GPU).

Zapis JSON
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Pola
adapter

string

Tylko dane wyjściowe. Nazwa adaptera. Przykład: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).

driverVersion

string

Tylko dane wyjściowe. Wersja sterownika GPU.

deviceId

string (int64 format)

Tylko dane wyjściowe. Reprezentuje identyfikator karty graficznej.

DisplayDevice

Informacje o urządzeniu wyświetlającym.

Zapis JSON
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa urządzenia.

displayWidthMm

integer

Tylko dane wyjściowe. Szerokość wyświetlacza w milimetrach.

displayHeightMm

integer

Tylko dane wyjściowe. Wysokość wyświetlacza w milimetrach.

internal

boolean

Tylko dane wyjściowe. Określa, czy wyświetlacz jest wewnętrzny.

manufacturerId

string

Tylko dane wyjściowe. Trzyliterowy identyfikator producenta.

modelId

integer

Tylko dane wyjściowe. Kod produktu producenta.

manufactureYear

integer

Tylko dane wyjściowe. Rok produkcji.

serialNumber

integer

Tylko dane wyjściowe. Numer seryjny.

edidVersion

string

Tylko dane wyjściowe. wersję EDID;

TouchScreenInfo

Informacje na ekranie dotykowym urządzenia.

Zapis JSON
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Pola
touchpadLibrary

string

Tylko dane wyjściowe. Nazwa biblioteki touchpada używana przez stos wejścia.

devices[]

object (TouchScreenDevice)

Tylko dane wyjściowe. Lista urządzeń z wewnętrznym ekranem dotykowym.

TouchScreenDevice

Informacje o wewnętrznym urządzeniu z ekranem dotykowym.

Zapis JSON
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Pola
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa urządzenia z ekranem dotykowym.

touchPointCount

integer

Tylko dane wyjściowe. Liczba punktów dotyku obsługiwanych na urządzeniu.

stylusCapable

boolean

Tylko dane wyjściowe. Czy urządzenie z ekranem dotykowym obsługuje rysik.

GraphicsStatusReport

Informacje o podsystemie graficznym.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceGraphicsInfo.
  • Częstotliwość zbierania danych: 3 godziny.
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_GRAPHICS_REPORT
Zapis JSON
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Godzina zaraportowania danych grafiki.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

displays[]

object (DisplayInfo)

Tylko dane wyjściowe. Informacje o wyświetlaczach urządzenia.

DisplayInfo

Informacje o wyświetlaczu.

Zapis JSON
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
Pola
deviceId

string (int64 format)

Tylko dane wyjściowe. Reprezentuje identyfikator karty graficznej.

resolutionWidth

integer

Tylko dane wyjściowe. Szerokość rozdzielczości w pikselach.

resolutionHeight

integer

Tylko dane wyjściowe. Wysokość rozdzielczości w pikselach.

refreshRate

integer

Tylko dane wyjściowe. Częstotliwość odświeżania w Hz.

isInternal

boolean

Tylko dane wyjściowe. Wskazuje, czy wyświetlacz jest wewnętrzny.

displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa urządzenia.

serialNumber

integer

Tylko dane wyjściowe. Numer seryjny.

edidVersion

string

Tylko dane wyjściowe. wersję EDID;

BatteryInfo

Informacje o baterii.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDevicePowerStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_BATTERY_INFO
Zapis JSON
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Pola
serialNumber

string

Tylko dane wyjściowe. Numer seryjny baterii.

manufacturer

string

Tylko dane wyjściowe. Producent baterii.

designCapacity

string (int64 format)

Tylko dane wyjściowe. Znamionowa pojemność (mAh).

designMinVoltage

integer

Tylko dane wyjściowe. Znamionowe minimalne napięcie wyjściowe (mV)

manufactureDate

object (Date)

Tylko dane wyjściowe. Data produkcji baterii.

technology

string

Tylko dane wyjściowe. Technologia baterii. Przykład: Li-ion

BatteryStatusReport

Dane o stanie baterii.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDevicePowerStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_BATTERY_REPORT
Zapis JSON
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa pobrania próbki na urządzeniu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

serialNumber

string

Tylko dane wyjściowe. Numer seryjny baterii.

sample[]

object (BatterySampleReport)

Tylko dane wyjściowe. Dane próbkowania baterii posortowane w kolejności malejącej według wartości reportTime.

batteryHealth

enum (BatteryHealth)

Tylko dane wyjściowe. stan baterii,

fullChargeCapacity

string (int64 format)

Tylko dane wyjściowe. Pełna pojemność baterii (mAh).

cycleCount

integer

Tylko dane wyjściowe. Liczba cykli.

BatterySampleReport

Dane próbkowania dotyczące baterii.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDevicePowerStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
Zapis JSON
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa pobrania próbki na urządzeniu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

voltage

string (int64 format)

Tylko dane wyjściowe. Napięcie baterii (mV).

remainingCapacity

string (int64 format)

Tylko dane wyjściowe. Pozostała pojemność baterii (mAh).

temperature

integer

Tylko dane wyjściowe. Temperatura w stopniach Celsjusza.

dischargeRate

integer

Tylko dane wyjściowe. Szybkość rozładowania baterii mierzona w mW. Dodatnia, jeśli bateria się rozładowuje, i ujemna, gdy się ładuje.

chargeRate

integer

Tylko dane wyjściowe. Procent naładowania baterii.

current

string (int64 format)

Tylko dane wyjściowe. Prąd baterii (mA).

status

string

Tylko dane wyjściowe. Stan baterii odczytany z sysfs. Przykład: Rozładowywanie

BatteryHealth

Określa aktualny stan baterii.

  • Ten stan nie jest wskaźnikiem ani oznaką wadliwej baterii. Oblicza się go, dzieląc bieżącą pojemność przy pełnym naładowaniu przez pojemność nominalną.
  • To producent określa integralność baterii i zasady gwarancji.
Wartości w polu enum
BATTERY_HEALTH_UNSPECIFIED Stan nieznany.
BATTERY_HEALTH_NORMAL Bateria jest w dobrym stanie, pełne naładowanie / pojemność nominalna > 80%
BATTERY_REPLACE_SOON Bateria jest w średnim stanie i zalecamy jej wymianę w najbliższym czasie. Pełna pojemność ładowania / pojemność nominalna: 75–80%
BATTERY_REPLACE_NOW Bateria jest w złym stanie i zalecamy jej wymianę. Pełna pojemność ładowania / pojemność nominalna < 75%

StorageInfo

Dane o stanie pamięci masowej.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceStorageStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_STORAGE_INFO
Zapis JSON
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Pola
volume[]

object (DiskVolume)

Informacje o woluminach dysków

availableDiskBytes

string (int64 format)

Dostępne miejsce na dane użytkownika na urządzeniu (w bajtach).

totalDiskBytes

string (int64 format)

Łączna ilość miejsca na dane użytkownika na urządzeniu w bajtach.

DiskVolume

Informacje o woluminach dysków

Zapis JSON
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Pola
volumeId

string

Identyfikator woluminu dysku.

storageFreeBytes

string (int64 format)

Wolne miejsce na dane w bajtach.

storageTotalBytes

string (int64 format)

Łączna ilość miejsca na dane w bajtach.

StorageStatusReport

Dane o stanie pamięci masowej.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceStorageStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_STORAGE_REPORT
Zapis JSON
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Pola
reportTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa pobrania próbki na urządzeniu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

disk[]

object (DiskInfo)

Tylko dane wyjściowe. Raporty na dysku.

DiskInfo

Stan pojedynczego urządzenia pamięci masowej.

Zapis 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
}
Pola
serialNumber

string

Tylko dane wyjściowe. Numer seryjny dysku.

manufacturer

string

Tylko dane wyjściowe. Producent dysku.

model

string

Tylko dane wyjściowe. Model dysku.

sizeBytes

string (int64 format)

Tylko dane wyjściowe. Rozmiar dysku.

type

string

Tylko dane wyjściowe. Typ dysku: eMMC / NVMe / ATA / SCSI.

health

string

Tylko dane wyjściowe. Stan dysku.

volumeIds[]

string

Tylko dane wyjściowe. woluminy dysków,

bytesReadThisSession

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów odczytanych od ostatniego uruchomienia.

bytesWrittenThisSession

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów zapisanych od ostatniego uruchomienia.

readTimeThisSession

string (Duration format)

Tylko dane wyjściowe. Czas odczytu z dysku od ostatniego uruchomienia.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

writeTimeThisSession

string (Duration format)

Tylko dane wyjściowe. Czas spędzony na zapisywaniu danych na dysku od ostatniego uruchomienia.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

ioTimeThisSession

string (Duration format)

Tylko dane wyjściowe. Określa czas, w którym dysk i kolejka były zajęte, więc w przeciwieństwie do powyższych pól równoległe żądania nie są liczone wielokrotnie.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

discardTimeThisSession

string (Duration format)

Tylko dane wyjściowe. Czas spędzony na odrzucaniu od ostatniego uruchomienia. Odrzucanie polega na zapisywaniu danych w wyczyszczonych blokach, które nie są już używane. Obsługiwane w przypadku jąder w wersji 4.18 i nowszych.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

ThunderboltInfo

Informacje o magistrali Thunderbolt.

  • To pole zawiera informacje o urządzeniu, które są statyczne i nie zmieniają się z czasem.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceSecurityStatus.
  • Częstotliwość zbierania danych: przy uruchamianiu urządzenia
  • Domyślna częstotliwość raportowania danych: przy uruchamianiu urządzenia
    • Zasady: nie
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_BUS_DEVICE_INFO
Zapis JSON
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Pola
securityLevel

enum (ThunderboltSecurityLevel)

Poziom zabezpieczeń magistrali Thunderbolt.

ThunderboltSecurityLevel

Poziom zabezpieczeń magistrali Thunderbolt.

Wartości w polu enum
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Nie ustawiono poziomu bezpieczeństwa Thunderbolt.
THUNDERBOLT_SECURITY_NONE_LEVEL Wszystkie urządzenia są automatycznie łączone przez oprogramowanie sprzętowe. Nie jest wymagane zatwierdzenie przez użytkownika.
THUNDERBOLT_SECURITY_USER_LEVEL Użytkownik jest pytany, czy urządzenie może się połączyć.
THUNDERBOLT_SECURITY_SECURE_LEVEL Użytkownik jest pytany, czy urządzenie może się połączyć. Dodatkowo na urządzenie wysyłany jest test, który powinien być zgodny z oczekiwanym testem na podstawie losowego klucza zapisanego w atrybucie sysfs klucza.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Oprogramowanie sprzętowe automatycznie tworzy tunele dla Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Oprogramowanie sprzętowe automatycznie tworzy tunele dla kontrolera USB i DisplayPort w stacji dokującej. Wszystkie połączenia PCIe poniżej stacji dokującej zostaną usunięte.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Tunelowanie PCIE jest wyłączone.

BootPerformanceReport

Raport o wydajności uruchamiania urządzenia.

  • To pole zawiera informacje telemetryczne, które będą się zmieniać w miarę korzystania z urządzenia.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceBootMode.
  • Częstotliwość zbierania danych: przy każdym zdarzeniu uruchomienia
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną przesłane, gdy urządzenie będzie ponownie online: tak
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_OS_REPORT
Zapis JSON
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Pola
bootUpDuration

string (Duration format)

Łączny czas uruchamiania.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

bootUpTime

string (Timestamp format)

Sygnatura czasowa określająca, kiedy urządzenie zostało włączone.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

shutdownDuration

string (Duration format)

Łączny czas od rozpoczęcia wyłączania do wyłączenia.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

shutdownTime

string (Timestamp format)

Sygnatura czasowa wyłączenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

shutdownReason

enum (ShutdownReason)

Przyczyna wyłączenia.

reportTime

string (Timestamp format)

Sygnatura czasowa zebrania raportu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

ShutdownReason

Przyczyna wyłączenia.

Wartości w polu enum
SHUTDOWN_REASON_UNSPECIFIED Nie podano powodu wyłączenia.
USER_REQUEST Zainicjowane przez użytkownika.
SYSTEM_UPDATE Zainicjowano aktualizację systemu.
LOW_BATTERY Wyłączenie z powodu niskiego poziomu naładowania baterii.
OTHER Wyłączenie z innych powodów.

HeartbeatStatusReport

Raport o stanie pakietu podtrzymującego aktywności urządzenia.

  • Dostępne w przypadku kiosków
  • To pole zawiera stan urządzenia (online, offline lub nieznany) i jest uwzględniane tylko wtedy, gdy stan uległ zmianie (np.online –> offline).
  • Dane w tym polu są kontrolowane przez zasadę HeartbeatEnabled. Więcej informacji
  • Częstotliwość pakietów podtrzymujących: 2 minuty
    • Uwaga: jeśli urządzenie przejdzie w tryb offline, może minąć do 12 minut, zanim zaktualizuje się jego stan połączenia.
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i zostaną zgłoszone, gdy urządzenie będzie ponownie online: nie dotyczy
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Zapis JSON
{
  "reportTime": string,
  "state": enum (State)
}
Pola
reportTime

string (Timestamp format)

sygnatura czasowa wykrycia zmiany stanu;

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

state

enum (State)

Stan urządzenia po zmianie

Stan

Stan urządzenia

Wartości w polu enum
STATE_UNSPECIFIED Nie określono stanu
UNKNOWN Urządzenie nie kwalifikuje się do monitorowania tętna
ONLINE Urządzenie jest online
OFFLINE Urządzenie jest offline
DEVICE_OUTDATED Urządzenie jest nieaktualne

KioskAppStatusReport

Raport o stanie aplikacji kiosku na urządzeniu.

  • Dostępne w przypadku kiosków
  • To pole zawiera identyfikator i numer wersji aplikacji działającej na urządzeniu kioskowym oraz sygnaturę czasową ostatniej aktualizacji raportu.
  • Dane w tym polu są kontrolowane przez zasadę ReportDeviceSessionStatus.
  • Częstotliwość zbierania danych: tylko podczas przesyłania
  • Domyślna częstotliwość raportowania danych: 3 godziny
    • Kontrolowane przez zasady: tak
  • Pamięć podręczna: jeśli urządzenie jest offline, zebrane dane są przechowywane lokalnie i będą raportowane, gdy urządzenie będzie ponownie online: Nie
  • Zgłaszane tylko w przypadku powiązanych użytkowników: N/A
  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_APPS_REPORT
Zapis JSON
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Pola
reportTime

string (Timestamp format)

sygnatura czasowa zebrania raportu;

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

appId

string

Identyfikator aplikacji kiosku, np. „mdmkkicfmmkgmpkmkdikhlbggogpicma”.

appVersion

string

Numer wersji aplikacji kiosku, np. „1.10.118”.

RuntimeCountersReport

Liczniki czasu działania pobrane z procesora. Obecnie dane telemetryczne z liczników czasu działania są obsługiwane tylko przez platformy Intel vPro PSR 14. generacji lub nowsze.

Zapis JSON
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Pola
reportTime

string (Timestamp format)

Sygnatura czasowa zebrania raportu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

uptimeRuntimeDuration

string (Duration format)

Całkowity czas działania od początku istnienia usługi. Obecnie zawsze czas działania S0 z platformy Intel vPro PSR.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

enterSleepCount

string (int64 format)

Liczba przejść urządzenia w stan uśpienia. Obecnie uzyskiwane za pomocą PSR, zliczane od S0 do S3.

enterHibernationCount

string (int64 format)

Liczba przejść urządzenia w stan hibernacji. Obecnie uzyskiwane za pomocą PSR, zliczane od S0 do S4.

enterPoweroffCount

string (int64 format)

Liczba przypadków przejścia urządzenia w stan wyłączenia. Obecnie uzyskiwane za pomocą PSR, zliczane od S0 do S5.

Metody

get

Pobieranie urządzenia telemetrycznego.

list

Wyświetl listę wszystkich urządzeń telemetrycznych.