REST Resource: customers.telemetry.devices

Risorsa: TelemetryDevice

Dati di telemetria raccolti da un dispositivo gestito.

  • Autorizzazione granulare richiesta: TELEMETRY_API_DEVICE
Rappresentazione 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)
    }
  ]
}
Campi
name

string

Solo output. Nome risorsa del dispositivo.

customer

string

Solo output. Il cliente di Google Workspace della quale l'azienda ha registrato il dispositivo.

orgUnitId

string

Solo output. ID unità organizzativa del dispositivo.

deviceId

string

Solo output. L'ID univoco dell'API Directory del dispositivo. Questo valore è uguale all'ID API Directory della Console di amministrazione nella scheda Dispositivi ChromeOS

serialNumber

string

Solo output. Numero di serie del dispositivo: Questo valore corrisponde al numero di serie della Console di amministrazione nella scheda Dispositivi ChromeOS.

cpuInfo[]

object (CpuInfo)

Solo output. Informazioni sulle specifiche della CPU del dispositivo.

cpuStatusReport[]

object (CpuStatusReport)

Solo output. Report sullo stato della CPU raccolti periodicamente, ordinati in ordine decrescente di reportTime.

memoryInfo

object (MemoryInfo)

Solo output. Informazioni sulle specifiche della memoria del dispositivo.

memoryStatusReport[]

object (MemoryStatusReport)

Solo output. Report sullo stato della memoria raccolti periodicamente, ordinati in modo decrescente di reportTime.

networkInfo

object (NetworkInfo)

Solo output. Informazioni sui dispositivi di rete.

networkStatusReport[]

object (NetworkStatusReport)

Solo output. Specifiche di rete raccolte periodicamente.

networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Solo output. Diagnostica di rete raccolta periodicamente.

osUpdateStatus[]

object (OsUpdateStatus)

Solo output. Contiene informazioni pertinenti sullo stato di aggiornamento di ChromeOS.

graphicsInfo

object (GraphicsInfo)

Solo output. Contiene informazioni sulle periferiche grafiche per il dispositivo.

graphicsStatusReport[]

object (GraphicsStatusReport)

Solo output. Report sui grafici raccolti periodicamente.

batteryInfo[]

object (BatteryInfo)

Solo output. Informazioni sulle specifiche della batteria del dispositivo.

batteryStatusReport[]

object (BatteryStatusReport)

Solo output. Report sulla batteria raccolti periodicamente.

storageInfo

object (StorageInfo)

Solo output. Informazioni sulle specifiche di archiviazione del dispositivo.

storageStatusReport[]

object (StorageStatusReport)

Solo output. Report sullo spazio di archiviazione raccolti periodicamente.

thunderboltInfo[]

object (ThunderboltInfo)

Solo output. Informazioni sul bus Thunderbolt.

audioStatusReport[]

object (AudioStatusReport)

Solo output. Report audio raccolti periodicamente e in ordine decrescente di reportTime.

bootPerformanceReport[]

object (BootPerformanceReport)

Solo output. I report sulle prestazioni di avvio del dispositivo.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

Solo output. Report sullo stato dell'heartbeat contenente i timestamp periodicamente ordinati in ordine decrescente di reportTime

kioskAppStatusReport[]

object (KioskAppStatusReport)

Solo output. Report sullo stato dell'app kiosk del dispositivo kiosk

networkBandwidthReport[]

object (NetworkBandwidthReport)

Solo output. Report sulla larghezza di banda della rete raccolti periodicamente e ordinati in ordine decrescente di reportTime.

peripheralsReport[]

object (PeripheralsReport)

Solo output. Report sulle periferiche raccolti periodicamente e ordinati in ordine decrescente di reportTime.

appReport[]

object (AppReport)

Solo output. Report sulle app raccolti periodicamente in ordine decrescente di reportTime.

runtimeCountersReport[]

object (RuntimeCountersReport)

Solo output. I contatori del runtime segnalano il tempo di esecuzione della durata del dispositivo e i conteggi delle transizioni S0->S3, S0->S4 e S0->S5, il che significa che entrano in stato di sospensione, ibernazione e spegnimento.

CpuInfo

Specifiche della CPU del dispositivo

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_CPU_INFO
Rappresentazione JSON
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Campi
model

string

Solo output. Il nome del modello CPU. Esempio: CPU Intel(R) Core(TM) i5-8250U a 1,60 GHz

architecture

enum (Architecture)

Solo output. Tipo di architettura per la CPU.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
maxClockSpeed

integer

Solo output. La velocità di clock massima della CPU in kHz.

keylockerSupported

boolean

Solo output. Se il keylocker è supportato.

keylockerConfigured

boolean

Solo output. Indica se è configurato il keylocker.TRUE = attivato; FALSE = disabilitato. Segnalato solo se keylockerSupported = TRUE.

Architettura

Tipo di architettura per la CPU.

Enum
ARCHITECTURE_UNSPECIFIED Architettura sconosciuta.
X64 architettura x64

CpuStatusReport

Fornisce informazioni sullo stato della CPU.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: ogni 10 minuti
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_CPU_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

Solo output. Il timestamp in millisecondi che rappresenta il momento in cui questo report è stato campionato.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

sampleFrequency

string (Duration format)

Solo output. Frequenza di campionamento del report.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

cpuUtilizationPct

integer

Solo output. Esempio di utilizzo della CPU (0-100%).

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Solo output. Informazioni sul campione di temperatura della CPU per core CPU in Celsius

CpuTemperatureInfo

Temperatura della CPU di un dispositivo. Campionamento per core CPU in Celsius.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: ogni 10 minuti
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "temperatureCelsius": integer,
  "label": string
}
Campi
temperatureCelsius

integer

Solo output. Temperatura della CPU in Celsius.

label

string

Solo output. Etichetta CPU. Esempio: Core 0

MemoryInfo

Informazioni di memoria di un dispositivo.

  • Questo campo contiene sia dati di telemetria che informazioni sul dispositivo:
    • totalRamBytes - Informazioni del dispositivo
    • availableRamBytes - Informazioni di telemetria
    • totalMemoryEncryption - Informazioni del dispositivo
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceMemoryInfo
  • Frequenza di raccolta dei dati:
    • totalRamBytes - Solo al momento del caricamento
    • availableRamBytes - Ogni 10 minuti
    • totalMemoryEncryption - all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati:
    • totalRamBytes-3 ore
    • availableRamBytes-3 ore
    • totalMemoryEncryption - all'avvio del dispositivo
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (solo per totalMemoryEncryption)
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_MEMORY_INFO
Rappresentazione JSON
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Campi
totalRamBytes

string (int64 format)

Solo output. RAM totale in byte.

availableRamBytes

string (int64 format)

Solo output. Quantità di RAM disponibile in byte.

totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Solo output. Informazioni sulla crittografia della memoria totale del dispositivo.

TotalMemoryEncryptionInfo

Informazioni sulla crittografia della memoria di un dispositivo.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceMemoryInfo
  • Frequenza di raccolta dei dati: all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati: all'avvio del dispositivo
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Campi
encryptionState

enum (MemoryEncryptionState)

Lo stato della crittografia della memoria sul dispositivo.

maxKeys

string (int64 format)

Il numero massimo di chiavi che possono essere utilizzate per la crittografia.

keyLength

string (int64 format)

La lunghezza delle chiavi di crittografia.

encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Algoritmo di crittografia della memoria.

MemoryEncryptionState

Lo stato della crittografia della memoria sul dispositivo.

Enum
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Lo stato di crittografia della memoria non è impostato.
MEMORY_ENCRYPTION_STATE_UNKNOWN Lo stato della crittografia della memoria è sconosciuto.
MEMORY_ENCRYPTION_STATE_DISABLED La crittografia della memoria sul dispositivo è disattivata.
MEMORY_ENCRYPTION_STATE_TME La crittografia della memoria sul dispositivo utilizza la crittografia della memoria totale.
MEMORY_ENCRYPTION_STATE_MKTME La crittografia della memoria sul dispositivo utilizza la crittografia della memoria totale con più chiavi.

MemoryEncryptionAlgorithm

L'algoritmo di crittografia in uso sul dispositivo.

Enum
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED L'algoritmo di crittografia della memoria non è impostato.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN L'algoritmo di crittografia della memoria utilizzato è sconosciuto.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 L'algoritmo di crittografia della memoria utilizza l'algoritmo di crittografia AES_XTS con una cifratura a blocchi di 128 bit.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 L'algoritmo di crittografia della memoria utilizza l'algoritmo di crittografia AES_XTS con una cifratura a blocchi di 256 bit.

MemoryStatusReport

Contiene esempi di report sullo stato della memoria.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceMemoryInfo
  • Frequenza di raccolta dei dati: solo al momento del caricamento, SystemRamFreeByes viene raccolto ogni 10 minuti
  • Frequenza predefinita dei report sui dati: ogni tre ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_MEMORY_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Campi
reportTime

string (Timestamp format)

Solo output. Il timestamp in millisecondi che rappresenta il momento in cui questo report è stato campionato.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

sampleFrequency

string (Duration format)

Solo output. Frequenza di campionamento del report.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

systemRamFreeBytes

string (int64 format)

Solo output. Quantità di RAM libera in byte (non affidabile a causa di Garbage Collection).

pageFaults

integer

Solo output. Numero di errori di pagina durante questa raccolta

NetworkInfo

Informazioni del dispositivo di rete.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportNetworkDeviceConfiguration
  • Frequenza di raccolta dei dati: all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati: all'avvio del dispositivo
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_INFO
Rappresentazione JSON
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Campi
networkDevices[]

object (NetworkDevice)

Solo output. Elenco dei dispositivi di rete.

NetworkDevice

Dettagli sul dispositivo di rete.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportNetworkDeviceConfiguration
  • Frequenza di raccolta dei dati: all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati: all'avvio del dispositivo
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Campi
type

enum (NetworkDeviceType)

Solo output. Tipo di dispositivo di rete.

macAddress

string

Solo output. Indirizzo MAC (se applicabile) del dispositivo di rete corrispondente.

meid

string

Solo output. MEID (se applicabile) del dispositivo di rete corrispondente.

imei

string

Solo output. IMEI (se applicabile) del dispositivo di rete corrispondente.

iccid

string

Solo output. L'ID della scheda del circuito integrato associato alla scheda SIM del dispositivo.

mdn

string

Solo output. Il numero della directory mobile associato alla scheda SIM del dispositivo.

NetworkDeviceType

Tipi di dispositivi di rete.

Enum
NETWORK_DEVICE_TYPE_UNSPECIFIED Tipo di dispositivo di rete non specificato.
CELLULAR_DEVICE Dispositivo cellulare.
ETHERNET_DEVICE dispositivo Ethernet.
WIFI_DEVICE Dispositivo Wifi.

NetworkStatusReport

Stato delle reti visibili/configurate.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportNetworkStatus
  • Frequenza di raccolta dei dati: 60 minuti
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: sì
  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_REPORT
Rappresentazione 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)
}
Campi
reportTime

string (Timestamp format)

Solo output. Ora in cui è stato segnalato lo stato della rete.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

sampleFrequency

string (Duration format)

Solo output. Frequenza di campionamento del report.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

signalStrengthDbm

integer

Solo output. Intensità del segnale per le reti wireless misurata in decibel.

lanIpAddress

string

Solo output. Indirizzo IP LAN.

gatewayIpAddress

string

Solo output. Indirizzo IP del gateway.

transmissionBitRateMbps

string (int64 format)

Solo output. Velocità in bit di trasmissione misurata in Megabit al secondo.

receivingBitRateMbps

string (int64 format)

Solo output. Velocità in bit di ricezione misurata in Megabit al secondo.

transmissionPowerDbm

integer

Solo output. Potenza di trasmissione misurata in decibel.

encryptionOn

boolean

Solo output. Indica se la chiave di crittografia Wi-Fi è disattivata.

wifiPowerManagementEnabled

boolean

Solo output. Gestione alimentazione Wi-Fi abilitata

guid

string

Solo output. Guida connessione di rete.

connectionState

enum (NetworkConnectionState)

Solo output. Stato attuale della connessione della rete.

connectionType

enum (NetworkType)

Solo output. Tipo di connessione di rete.

NetworkType

Tipi di connessioni di rete.

Enum
NETWORK_TYPE_UNSPECIFIED Tipo di connessione di rete non specificato
CELLULAR Connessione di rete mobile.
ETHERNET Connessione di rete Ethernet.
TETHER Esegui il tethering della connessione di rete.
VPN Connessione di rete VPN.
WIFI Connessione di rete Wi-Fi.

NetworkDiagnosticsReport

Risultati dei test della rete per determinare l'integrità della connessione di rete del dispositivo, ad esempio se la latenza HTTPS è elevata o normale.

  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Campi
reportTime

string (Timestamp format)

Solo output. Timestamp della raccolta della diagnostica.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

httpsLatencyData

object (HttpsLatencyRoutineData)

Solo output. Dati di test sulla latenza HTTPS.

OsUpdateStatus

Contiene informazioni relative allo stato attuale dell'aggiornamento del sistema operativo.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceOsUpdateStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_OS_REPORT
Rappresentazione JSON
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Campi
updateState

enum (UpdateState)

Solo output. Stato attuale dell'aggiornamento del sistema operativo.

newPlatformVersion

string

Solo output. Nuova versione della piattaforma dell'immagine del sistema operativo che viene scaricata e applicata. È impostato solo se lo stato dell'aggiornamento è OS_IMAGE_DOWNLOAD_IN_PROGRESS o OS_UPDATE_NEED_REBOOT. Tieni presente che potrebbe essere un "0.0.0.0" fittizio per lo stato OS_UPDATE_NEED_REBOOT per alcuni casi limite, ad esempio e il motore di aggiornamento viene riavviato senza riavvio.

newRequestedPlatformVersion

string

Solo output. Nuova versione della piattaforma richiesta dall'app kiosk aggiornata in attesa.

lastUpdateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento riuscito.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastUpdateCheckTime

string (Timestamp format)

Solo output. Timestamp del controllo dell'ultimo aggiornamento.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastRebootTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo riavvio.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

UpdateState

Stato dell'aggiornamento del sistema operativo

Enum
UPDATE_STATE_UNSPECIFIED Stato non specificato.
OS_IMAGE_DOWNLOAD_NOT_STARTED Il download del sistema operativo non è stato avviato.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Download del sistema operativo sul dispositivo avviato.
OS_UPDATE_NEED_REBOOT È necessario riavviare il dispositivo per completare il caricamento.

GraphicsInfo

Informazioni sul sottosistema grafico.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceGraphicsStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_GRAPHICS_INFO
Rappresentazione JSON
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Campi
adapterInfo

object (GraphicsAdapterInfo)

Solo output. Informazioni sulla scheda grafica (GPU).

eprivacySupported

boolean

Solo output. La schermata e-Privacy è supportata o meno.

displayDevices[]

object (DisplayDevice)

Solo output. Informazioni sui display del dispositivo.

touchScreenInfo

object (TouchScreenInfo)

Solo output. Informazioni sul touchscreen o sui touchscreen interni del dispositivo.

GraphicsAdapterInfo

Informazioni su una scheda grafica (GPU).

Rappresentazione JSON
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Campi
adapter

string

Solo output. Nome adattatore. Esempio: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).

driverVersion

string

Solo output. Versione del driver GPU.

deviceId

string (int64 format)

Solo output. Rappresenta l'ID del dispositivo della scheda grafica.

DisplayDevice

Informazioni su un dispositivo di visualizzazione.

Rappresentazione JSON
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
Campi
displayName

string

Solo output. Nome del dispositivo visualizzato.

displayWidthMm

integer

Solo output. Larghezza di visualizzazione in millimetri.

displayHeightMm

integer

Solo output. Altezza del display in millimetri.

internal

boolean

Solo output. Se il display è interno o meno.

manufacturerId

string

Solo output. ID produttore di tre lettere.

modelId

integer

Solo output. Codice prodotto del produttore.

manufactureYear

integer

Solo output. Anno di produzione.

TouchScreenInfo

Informazioni sul touchscreen del dispositivo.

Rappresentazione JSON
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Campi
touchpadLibrary

string

Solo output. Nome della libreria touchpad utilizzato dallo stack di input.

devices[]

object (TouchScreenDevice)

Solo output. Elenco dei dispositivi touchscreen interni.

TouchScreenDevice

Informazioni di un dispositivo touchscreen interno.

Rappresentazione JSON
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Campi
displayName

string

Solo output. Nome visualizzato del dispositivo touchscreen.

touchPointCount

integer

Solo output. Numero di touchpoint supportati sul dispositivo.

stylusCapable

boolean

Solo output. Il dispositivo touchscreen supporta o meno lo stilo.

GraphicsStatusReport

Informazioni sul sottosistema grafico.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceGraphicsInfo
  • Frequenza di raccolta dei dati: 3 ore.
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare necessaria: TELEMETRY_API_GRAPHICS_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

Solo output. L'ora in cui sono stati registrati i dati grafici.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

displays[]

object (DisplayInfo)

Solo output. Informazioni sulle visualizzazioni del dispositivo.

DisplayInfo

Informazioni per un display.

Rappresentazione JSON
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
Campi
deviceId

string (int64 format)

Solo output. Rappresenta l'ID del dispositivo della scheda grafica.

resolutionWidth

integer

Solo output. Larghezza della risoluzione in pixel.

resolutionHeight

integer

Solo output. Altezza risoluzione in pixel.

refreshRate

integer

Solo output. Frequenza di aggiornamento in Hz.

isInternal

boolean

Solo output. Indica se il display è interno o meno.

displayName

string

Solo output. Nome del dispositivo visualizzato.

BatteryInfo

Informazioni sulla batteria.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_BATTERY_INFO
Rappresentazione JSON
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Campi
serialNumber

string

Solo output. Numero di serie della batteria.

manufacturer

string

Solo output. Produttore di batterie

designCapacity

string (int64 format)

Solo output. Capacità di progettazione (mAmpere-ore).

designMinVoltage

integer

Solo output. Tensione di uscita minima progettata (mV)

manufactureDate

object (Date)

Solo output. La data di produzione della batteria.

technology

string

Solo output. Tecnologia della batteria. Esempio: Ioni di litio

BatteryStatusReport

Dati sullo stato della batteria.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_BATTERY_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Campi
reportTime

string (Timestamp format)

Solo output. Timestamp della raccolta del campione sul dispositivo

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

serialNumber

string

Solo output. Numero di serie della batteria.

sample[]

object (BatterySampleReport)

Solo output. Dati di campionamento relativi alla batteria in ordine decrescente di reportTime.

batteryHealth

enum (BatteryHealth)

Solo output. Integrità della batteria.

fullChargeCapacity

string (int64 format)

Solo output. Capacità di ricarica completa (mAmpere-ore).

cycleCount

integer

Solo output. Conteggio dei cicli.

BatterySampleReport

Dati di campionamento per la batteria.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Campi
reportTime

string (Timestamp format)

Solo output. Timestamp della raccolta del campione sul dispositivo

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

voltage

string (int64 format)

Solo output. Tensione batteria (millivolt).

remainingCapacity

string (int64 format)

Solo output. Capacità rimanente della batteria (mAmpere-ore).

temperature

integer

Solo output. Temperatura in gradi Celsius.

dischargeRate

integer

Solo output. La velocità di esaurimento della batteria misurata in mW. Positivo se la batteria si sta scaricando, negativo se è in carica.

chargeRate

integer

Solo output. Percentuale di carica della batteria.

current

string (int64 format)

Solo output. Corrente della batteria (mA).

status

string

Solo output. Stato della batteria letto da sysfs. Esempio: in esaurimento

BatteryHealth

Rappresenta l'integrità attuale della batteria.

  • Questo stato non indica un indicatore o l'indicazione di una batteria difettosa. Viene calcolata dividendo l'attuale capacità di carica completa per la capacità di progetto.
  • Spetta al produttore definire l'integrità della batteria e la politica di garanzia.
Enum
BATTERY_HEALTH_UNSPECIFIED Stato di salute sconosciuto.
BATTERY_HEALTH_NORMAL La batteria è integro, capacità di ricarica completa / capacità di progettazione > L'80%
BATTERY_REPLACE_SOON La batteria è moderatamente intatta e si consiglia di sostituirla a breve; capacità di ricarica completa / capacità di progettazione 75% - 80%
BATTERY_REPLACE_NOW La batteria non è integro e si consiglia di sostituirla; capacità di ricarica completa / capacità di progettazione < Il 75%

StorageInfo

Dati di stato per l'archiviazione.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceStorageStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_STORAGE_INFO
Rappresentazione JSON
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Campi
volume[]

object (DiskVolume)

Informazioni per i volumi dei dischi

availableDiskBytes

string (int64 format)

Lo spazio disponibile per l'archiviazione dei dati utente nel dispositivo in byte.

totalDiskBytes

string (int64 format)

Lo spazio totale per l'archiviazione dei dati utente nel dispositivo, espresso in byte.

DiskVolume

Informazioni per i volumi dei dischi

Rappresentazione JSON
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Campi
volumeId

string

ID volume disco.

storageFreeBytes

string (int64 format)

Spazio di archiviazione libero in byte.

storageTotalBytes

string (int64 format)

Spazio di archiviazione totale in byte.

StorageStatusReport

Dati di stato per l'archiviazione.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceStorageStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_STORAGE_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

Solo output. Timestamp della raccolta del campione sul dispositivo

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

disk[]

object (DiskInfo)

Solo output. Report su disco.

DiskInfo

Stato del singolo dispositivo di archiviazione.

Rappresentazione 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
}
Campi
serialNumber

string

Solo output. Numero di serie del disco.

manufacturer

string

Solo output. Produttore del disco.

model

string

Solo output. Modello del disco.

sizeBytes

string (int64 format)

Solo output. Dimensioni del disco.

type

string

Solo output. Tipo di disco: eMMC / NVMe / ATA / SCSI.

health

string

Solo output. Integrità del disco.

volumeIds[]

string

Solo output. e i volumi di dischi.

bytesReadThisSession

string (int64 format)

Solo output. Numero di byte letti dall'ultimo avvio.

bytesWrittenThisSession

string (int64 format)

Solo output. Numero di byte scritti dall'ultimo avvio.

readTimeThisSession

string (Duration format)

Solo output. Tempo di lettura dal disco dall'ultimo avvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

writeTimeThisSession

string (Duration format)

Solo output. Tempo di scrittura su disco dall'ultimo avvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

ioTimeThisSession

string (Duration format)

Solo output. Conta il tempo di occupato del disco e della coda, quindi a differenza dei campi precedenti, le richieste parallele non vengono conteggiate più volte.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

discardTimeThisSession

string (Duration format)

Solo output. Tempo di eliminazione dall'ultimo avvio. L'eliminazione significa cancellare blocchi che non sono più in uso. È supportata sui kernel 4.18 e successivi.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

ThunderboltInfo

Informazioni sul bus Thunderbolt.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceSecurityStatus
  • Frequenza di raccolta dei dati: all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati: all'avvio del dispositivo
    • Criteri controllati: no
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_BUS_DEVICE_INFO
Rappresentazione JSON
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Campi
securityLevel

enum (ThunderboltSecurityLevel)

Livello di sicurezza del bus Thunderbolt.

ThunderboltSecurityLevel

Livello di sicurezza del bus Thunderbolt.

Enum
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Il livello di sicurezza Thunderbolt non è impostato.
THUNDERBOLT_SECURITY_NONE_LEVEL Tutti i dispositivi vengono connessi automaticamente tramite il firmware. Non è necessaria l'approvazione dell'utente.
THUNDERBOLT_SECURITY_USER_LEVEL All'utente viene chiesto se il dispositivo può essere connesso.
THUNDERBOLT_SECURITY_SECURE_LEVEL All'utente viene chiesto se il dispositivo può essere connesso. Inoltre, al dispositivo viene inviata una richiesta di verifica che dovrebbe corrispondere a quella prevista in base a una chiave casuale scritta nell'attributo chiave sysfs.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Il firmware crea automaticamente tunnel per Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Il firmware crea automaticamente tunnel per il controller USB e la Display Port in un dock. Tutti i collegamenti PCIe a valle della base vengono rimossi.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Il tunneling PCIE è disattivato.

BootPerformanceReport

Report sul rendimento di avvio di un dispositivo.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo in base all'utilizzo del dispositivo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceBootMode
  • Frequenza di raccolta dei dati: a ogni evento di avvio
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono memorizzati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (Sì)
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_OS_REPORT
Rappresentazione JSON
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Campi
bootUpDuration

string (Duration format)

Tempo totale di avvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

bootUpTime

string (Timestamp format)

Timestamp dell'alimentazione.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

shutdownDuration

string (Duration format)

Tempo totale dall'inizio dello spegnimento.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

shutdownTime

string (Timestamp format)

Timestamp dell'arresto.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

shutdownReason

enum (ShutdownReason)

Il motivo dell'arresto.

reportTime

string (Timestamp format)

Timestamp della raccolta del report.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

ShutdownReason

Il motivo dell'arresto.

Enum
SHUTDOWN_REASON_UNSPECIFIED Il motivo dell'arresto non è specificato.
USER_REQUEST Avviato dall'utente.
SYSTEM_UPDATE Aggiornamento di sistema avviato.
LOW_BATTERY Arresto dovuto alla batteria in esaurimento.
OTHER Arresto dovuto per altri motivi.

HeartbeatStatusReport

Report sullo stato dell'heartbeat di un dispositivo.

  • Disponibile per i kiosk
  • Questo campo fornisce lo stato online/offline/sconosciuto di un dispositivo e viene incluso solo se lo stato è cambiato (ad es. Online -> Offline)
  • I dati per questo campo sono controllati tramite il criterio: HeartbeatEnabled Maggiori informazioni
  • Frequenza battito cardiaco: 2 min
    • Nota: se un dispositivo passa alla modalità offline, l'aggiornamento del suo stato online può richiedere fino a 12 minuti.
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online (N/D)
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare richiesta: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "state": enum (State)
}
Campi
reportTime

string (Timestamp format)

Timestamp del rilevamento del cambiamento dello stato

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Stato in cui il dispositivo è cambiato

Stato

Lo stato del dispositivo

Enum
STATE_UNSPECIFIED Stato non specificato
UNKNOWN Il dispositivo non è idoneo per il monitoraggio del battito cardiaco
ONLINE Il dispositivo è online
OFFLINE Il dispositivo è offline

KioskAppStatusReport

Report sullo stato delle app kiosk di un dispositivo.

  • Disponibile per i kiosk
  • Questo campo fornisce l'ID e il numero di versione dell'app in esecuzione su un dispositivo kiosk, nonché il timestamp dell'ultimo aggiornamento del report
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceSessionStatus
  • Frequenza di raccolta dei dati: solo al momento del caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Policy Controlled: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare necessaria: TELEMETRY_API_APPS_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Campi
reportTime

string (Timestamp format)

Timestamp della raccolta della segnalazione

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

appId

string

ID dell'app kiosk, ad esempio "mdmkkicfmmkgmpkmkdikhlbggogpicma"

appVersion

string

Numero di versione dell'app kiosk, ad esempio "1.10.118"

RuntimeCountersReport

Contatori di runtime recuperati dalla CPU. Attualmente la telemetria dei contatori del tempo di esecuzione è supportata solo da Intel vPro PSR sulla generazione 14 e successive.

Rappresentazione JSON
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Campi
reportTime

string (Timestamp format)

Timestamp della raccolta del report.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

uptimeRuntimeDuration

string (Duration format)

Runtime totale. Attualmente il runtime S0 è attualmente sempre S0 da Intel vPro PSR.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

enterSleepCount

string (int64 format)

Numero di volte in cui il dispositivo è entrato in stato di sospensione. Attualmente ottenuto tramite PSR, conta da S0->S3.

enterHibernationCount

string (int64 format)

Numero di volte in cui il dispositivo è entrato in stato di ibernazione. Attualmente ottenuto tramite PSR, conta da S0->S4.

enterPoweroffCount

string (int64 format)

Numero di volte in cui il dispositivo è entrato in stato di spegnimento. Attualmente ottenuto tramite PSR, conta da S0->S5.

Metodi

get

Recupera dispositivo di telemetria.

list

Elenca tutti i dispositivi di telemetria.