REST Resource: customers.telemetry.devices

Risorsa: TelemetryDevice

Dati di telemetria raccolti da un dispositivo gestito.

  • È necessaria l'autorizzazione granulare 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 della risorsa del dispositivo.
customer

string

Solo output. Cliente Google Workspace la cui azienda ha registrato il dispositivo.
orgUnitId

string

Solo output. ID unità organizzativa del dispositivo.
deviceId

string

Solo output. L'ID API Directory univoco del dispositivo. Questo valore corrisponde 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 e 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 e ordinati in ordine decrescente per 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. Dati diagnostici di rete raccolti periodicamente.
osUpdateStatus[]

object (OsUpdateStatus)

Solo output. Contiene informazioni pertinenti sullo stato dell'aggiornamento di ChromeOS.
graphicsInfo

object (GraphicsInfo)

Solo output. Contiene informazioni sulle periferiche grafiche per il dispositivo.
graphicsStatusReport[]

object (GraphicsStatusReport)

Solo output. Report 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 ordinati in ordine decrescente di reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

Solo output. Report sul rendimento all'avvio del dispositivo.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Solo output. Report sullo stato del battito cardiaco contenente timestamp ordinati periodicamente in ordine decrescente di reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

Solo output. Report sullo stato dell'app kiosk per il dispositivo kiosk
networkBandwidthReport[]

object (NetworkBandwidthReport)

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

object (PeripheralsReport)

Solo output. Report sulle periferiche raccolti periodicamente ordinati in ordine decrescente di reportTime.
appReport[]

object (AppReport)

Solo output. Report sulle app raccolti periodicamente ordinati in ordine decrescente di reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

Solo output. I report dei contatori del tempo di esecuzione hanno raccolto il tempo di esecuzione totale del dispositivo, nonché i conteggi delle transizioni S0->S3, S0->S4 e S0->S5, ovvero l'ingresso negli stati di sospensione, ibernazione e spegnimento

CpuInfo

Specifiche della CPU per il dispositivo

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare 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 della CPU. Esempio: CPU Intel(R) Core(TM) i5-8250U a 1,60 GHz
architecture

enum (Architecture)

Solo output. Tipo di architettura della CPU.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
maxClockSpeed

integer

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

boolean

Solo output. Indica se Key Locker è supportato.
keylockerConfigured

boolean

Solo output. Indica se Key Locker è configurato.TRUE = abilitato; FALSE = disabilitato. Viene segnalato solo se keylockerSupported = TRUE.

Architettura

Tipo di architettura della CPU.

Enum
ARCHITECTURE_UNSPECIFIED Architettura sconosciuta.
X64 Architettura x64

CpuStatusReport

Fornisce informazioni sullo stato della CPU.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • 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 è stato eseguito il campionamento di questo report.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Solo output. Frequenza con cui viene campionato il report.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
cpuUtilizationPct

integer

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

object (CpuTemperatureInfo)

Solo output. Informazioni sui campioni della temperatura della CPU per core della CPU in gradi Celsius

CpuTemperatureInfo

Temperatura della CPU di un dispositivo. Campionato per core della CPU in gradi Celsius.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
Rappresentazione JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
Campi
temperatureCelsius

integer

Solo output. Temperatura della CPU in gradi Celsius.
label

string

Solo output. Etichetta della CPU. Esempio: Core 0

MemoryInfo

Informazioni sulla memoria di un dispositivo.

  • Questo campo contiene sia informazioni sulla telemetria sia sul dispositivo:
    • totalRamBytes - Informazioni sul dispositivo
    • availableRamBytes - Informazioni sulla telemetria
    • totalMemoryEncryption - Informazioni sul 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 di generazione dei report sui dati predefinita:
    • totalRamBytes - 3 ore
    • availableRamBytes - 3 ore
    • totalMemoryEncryption - all'avvio del dispositivo
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: solo per totalMemoryEncryption
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare: 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 per il dispositivo.

TotalMemoryEncryptionInfo

Informazioni sulla crittografia della memoria di un dispositivo.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Segnalato solo per gli utenti affiliati: N/A
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 crittografico 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 di 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 multi-chiave.

MemoryEncryptionAlgorithm

L'algoritmo di crittografia utilizzato sul dispositivo.

Enum
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED L'algoritmo crittografico della memoria non è impostato.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN L'algoritmo crittografico della memoria in uso è sconosciuto.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 L'algoritmo crittografico della memoria utilizza l'algoritmo crittografico AES_XTS con una cifratura a blocchi di 128 bit.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 L'algoritmo crittografico della memoria utilizza l'algoritmo crittografico 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 che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • 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 è stato eseguito il campionamento di questo report.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Solo output. Frequenza con cui viene campionato il report.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
systemRamFreeBytes

string (int64 format)

Solo output. Quantità di RAM libera in byte (non attendibile a causa del garbage collection).
pageFaults

integer

Solo output. Numero di errori di pagina durante questa raccolta

NetworkInfo

Informazioni sul dispositivo di rete.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare 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 cambiano 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Segnalato solo per gli utenti affiliati: N/A
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 che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Registrato solo per gli 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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Solo output. Frequenza con cui viene campionato il report.

Una durata in secondi con un massimo di nove cifre frazionarie, che 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 attivata
guid

string

Solo output. GUID della connessione di rete.
connectionState

enum (NetworkConnectionState)

Solo output. Stato attuale della connessione di rete.
connectionType

enum (NetworkType)

Solo output. Tipo di connessione di rete.

NetworkType

Tipi di connessione di rete.

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

NetworkDiagnosticsReport

Risultati dei test di 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 relativo alla data e all'ora di raccolta dei dati diagnostici.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

Solo output. Dati del test di latenza HTTPS.

OsUpdateStatus

Contiene informazioni sullo stato attuale dell'aggiornamento del sistema operativo.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio ReportDeviceOsUpdateStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • 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 scaricata e applicata. Viene impostato solo quando lo stato di aggiornamento è OS_IMAGE_DOWNLOAD_IN_PROGRESS o OS_UPDATE_NEED_REBOOT. Tieni presente che potrebbe trattarsi di un valore fittizio "0.0.0.0" per lo stato OS_UPDATE_NEED_REBOOT per alcuni casi limite, ad esempio se il motore di aggiornamento viene riavviato senza un 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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo controllo dell'aggiornamento.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo riavvio.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

UpdateState

Stato dell'aggiornamento del sistema operativo

Enum
UPDATE_STATE_UNSPECIFIED Stato non specificato.
OS_IMAGE_DOWNLOAD_NOT_STARTED Il sistema operativo non ha avviato il download.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Il sistema operativo ha avviato il download sul dispositivo.
OS_UPDATE_NEED_REBOOT Il dispositivo deve essere riavviato per completare il caricamento.

GraphicsInfo

Informazioni sul sottosistema grafico.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano nel tempo.
  • I dati per questo campo sono controllati tramite il criterio ReportDeviceGraphicsStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare 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. Indica se la schermata e-Privacy è supportata o meno.
displayDevices[]

object (DisplayDevice)

Solo output. Informazioni sui display del dispositivo.
touchScreenInfo

object (TouchScreenInfo)

Solo output. Informazioni 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 dell'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. Mostra il nome del dispositivo.
displayWidthMm

integer

Solo output. Larghezza del display in millimetri.
displayHeightMm

integer

Solo output. Altezza del display in millimetri.
internal

boolean

Solo output. Indica 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 del touchpad utilizzata dallo stack di input.
devices[]

object (TouchScreenDevice)

Solo output. Elenco dei dispositivi touchscreen interni.

TouchScreenDevice

Informazioni su un dispositivo touch screen interno.

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

string

Solo output. Nome visualizzato del dispositivo touch screen.
touchPointCount

integer

Solo output. Numero di punti di contatto supportati sul dispositivo.
stylusCapable

boolean

Solo output. Indica se il dispositivo touchscreen è compatibile con lo stilo.

GraphicsStatusReport

Informazioni sul sottosistema grafico.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare richiesta: TELEMETRY_API_GRAPHICS_REPORT
Rappresentazione JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

Solo output. Ora in cui sono stati registrati i dati grafici.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

Solo output. Informazioni sui display del dispositivo.

DisplayInfo

Informazioni per una visualizzazione.

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 della 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. Mostra il nome del dispositivo.

BatteryInfo

Informazioni sulla batteria.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano nel tempo.
  • I dati per questo campo sono controllati tramite il criterio ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare: 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 della batteria.
designCapacity

string (int64 format)

Solo output. Capacità di progetto (mAmpere-ore).
designMinVoltage

integer

Solo output. Tensione di uscita minima (mV) progettata
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 che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • 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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serialNumber

string

Solo output. Numero di serie della batteria.
sample[]

object (BatterySampleReport)

Solo output. Dati di campionamento della batteria ordinati 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 che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio ReportDevicePowerStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

Solo output. Tensione della 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 è un indicatore o l'indicazione di una batteria difettosa. Viene calcolato dividendo la capacità di ricarica completa attuale per la capacità di progetto.
  • Spetta al produttore definire l'integrità della batteria e le norme della garanzia.
Enum
BATTERY_HEALTH_UNSPECIFIED Integrità sconosciuta.
BATTERY_HEALTH_NORMAL La batteria è in buone condizioni, capacità di ricarica completa / capacità di progetto > 80%
BATTERY_REPLACE_SOON La batteria è moderatamente in cattivo stato e si consiglia di sostituirla al più presto. Capacità di ricarica completa / capacità di progettazione 75-80%
BATTERY_REPLACE_NOW La batteria non è in buone condizioni e si consiglia di sostituirla, capacità di ricarica completa / capacità di progettazione < 75%

StorageInfo

Dati sullo stato dello spazio di archiviazione.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio ReportDeviceStorageStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare 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 lo spazio di archiviazione dei dati utente nel dispositivo in byte.
totalDiskBytes

string (int64 format)

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

DiskVolume

Informazioni per i volumi dei dischi

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

string

ID volume del disco.
storageFreeBytes

string (int64 format)

Spazio di archiviazione libero in byte.
storageTotalBytes

string (int64 format)

Spazio di archiviazione totale in byte.

StorageStatusReport

Dati sullo stato dello spazio di archiviazione.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio ReportDeviceStorageStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • 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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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. Volumi dei 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 impiegato per la lettura dal disco dall'ultimo avvio.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
writeTimeThisSession

string (Duration format)

Solo output. Tempo impiegato per la scrittura sul disco dall'ultimo avvio.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
ioTimeThisSession

string (Duration format)

Solo output. Conta il tempo in cui il disco e la coda erano occupati, quindi, a differenza dei campi precedenti, le richieste parallele non vengono conteggiate più volte.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
discardTimeThisSession

string (Duration format)

Solo output. Tempo trascorso per lo smaltimento dall'ultimo avvio. L'eliminazione consiste nella scrittura in blocchi vuoti che non sono più in uso. Supportato sui kernel 4.18 e versioni successive.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

ThunderboltInfo

Informazioni sul bus Thunderbolt.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambiano 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
    • Controllo dei criteri: No
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Segnalato solo per gli utenti affiliati: N/A
  • È necessaria l'autorizzazione granulare 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 dal firmware. Non è necessaria l'approvazione dell'utente.
THUNDERBOLT_SECURITY_USER_LEVEL All'utente viene chiesto se è consentito connettere il dispositivo.
THUNDERBOLT_SECURITY_SECURE_LEVEL All'utente viene chiesto se è consentito connettere il dispositivo. Inoltre, al dispositivo viene inviata una verifica che deve corrispondere a quella prevista in base a una chiave casuale scritta nell'attributo sysfs della chiave
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Il firmware crea automaticamente i tunnel per Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Il firmware crea automaticamente i tunnel per il controller USB e la porta Display in una base. Tutti i link PCIe a valle della base vengono rimossi.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Il tunneling PCIe è disattivato.

BootPerformanceReport

Report sul rendimento all'avvio di un dispositivo.

  • Questo campo contiene informazioni di telemetria che cambieranno nel tempo man mano che il dispositivo viene utilizzato.
  • 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
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: Sì
  • Segnalato solo per gli utenti affiliati: N/A
  • 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.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
bootUpTime

string (Timestamp format)

Il timestamp dell'accensione dell'alimentazione.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

Tempo totale dall'inizio dell'arresto fino allo spegnimento.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
shutdownTime

string (Timestamp format)

Il timestamp dell'arresto.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

Il motivo dell'arresto.
reportTime

string (Timestamp format)

Timestamp della raccolta del report.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ShutdownReason

Il motivo dell'arresto.

Enum
SHUTDOWN_REASON_UNSPECIFIED Il motivo dell'arresto non è specificato.
USER_REQUEST Avviata dall'utente.
SYSTEM_UPDATE Aggiornamento di sistema avviato.
LOW_BATTERY Arresto per batteria scarica.
OTHER Arresto per altri motivi.

HeartbeatStatusReport

Report sullo stato dell'heartbeat di un dispositivo.

  • Disponibile per i chioschi
  • Questo campo fornisce lo stato online/offline/sconosciuto di un dispositivo e verrà incluso solo se lo stato è cambiato (ad es.Online -> Offline).
  • I dati per questo campo sono controllati tramite criteri: HeartbeatEnabled Ulteriori informazioni
  • Frequenza heartbeat: 2 min
    • Nota: se un dispositivo passa alla modalità offline, potrebbe essere necessario attendere fino a 12 minuti prima che lo stato online venga aggiornato
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: N/A
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare richiesta: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Rappresentazione JSON 
{
  "reportTime": string,
  "state": enum (State)
}
Campi
reportTime

string (Timestamp format)

Timestamp relativo al momento in cui è stata rilevata la modifica dello stato

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Stato a cui è passato il dispositivo

Stato

Lo stato del dispositivo

Enum
STATE_UNSPECIFIED Stato non specificato
UNKNOWN Il dispositivo non è idoneo al monitoraggio del battito cardiaco
ONLINE Il dispositivo è online
OFFLINE Il dispositivo è offline
DEVICE_OUTDATED Il dispositivo è obsoleto

KioskAppStatusReport

Report sullo stato dell'app Kiosk di un dispositivo.

  • Disponibile per i chioschi
  • 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 caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllato da norme: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno registrati alla successiva connessione online del dispositivo: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare richiesta: TELEMETRY_API_APPS_REPORT
Rappresentazione JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Campi
reportTime

string (Timestamp format)

Timestamp della raccolta del report

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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. Al momento la telemetria dei contatori del tempo di esecuzione è supportata solo da Intel vPro PSR su Gen 14 e versioni successive.

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

string (Timestamp format)

Timestamp della raccolta del report.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Tempo di esecuzione totale del lifetime. Attualmente, il runtime è sempre S0 da Intel vPro PSR.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
enterSleepCount

string (int64 format)

Numero di volte in cui il dispositivo è passato allo stato di sospensione. Attualmente ottenuto tramite il PSR, conteggio da S0 a S3.
enterHibernationCount

string (int64 format)

Numero di volte in cui il dispositivo è passato allo stato di ibernazione. Attualmente ottenuto tramite il PSR, conteggio da S0 a S4.
enterPoweroffCount

string (int64 format)

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

Metodi

get

 Recupera il dispositivo di telemetria.

list

 Elenca tutti i dispositivi di telemetria.