REST Resource: customers.telemetry.devices

Risorsa: TelemetryDevice

Dati di telemetria raccolti da un dispositivo gestito.

  • Autorizzazione granulare necessaria: 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. L'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 è uguale al numero di serie della Console di amministrazione nella scheda Dispositivi ChromeOS.

cpuInfo[]

object (CpuInfo)

Solo output. Informazioni sulle specifiche della CPU per il 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 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. Diagnostica di rete raccolta 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 dell'avvio del dispositivo.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

Solo output. Report sullo stato dei battiti 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 e ordinati in ordine decrescente di reportTime.

appReport[]

object (AppReport)

Solo output. Report delle app raccolti periodicamente e ordinati in ordine decrescente di reportTime.

runtimeCountersReport[]

object (RuntimeCountersReport)

Solo output. I report sui contatori del tempo di esecuzione mostrano il tempo di esecuzione del dispositivo raccolto durante il suo ciclo di vita, nonché i conteggi delle transizioni da S0 a S3, da S0 a S4 e da S0 a 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 cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 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 caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: 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. Se Key Locker è supportato.

keylockerConfigured

boolean

Solo output. Indica se Key Locker è configurato.TRUE = Enabled; FALSE = disabled. 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 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 l'ora in cui è stato campionato questo report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 sul campione di temperatura della CPU per core della CPU in gradi Celsius

CpuTemperatureInfo

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

  • Questo campo contiene informazioni di telemetria e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: 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 CPU. Esempio: Core 0

MemoryInfo

Informazioni sulla memoria di un dispositivo.

  • Questo campo contiene informazioni sulla telemetria e sul dispositivo:
    • totalRamBytes - Informazioni sul dispositivo
    • availableRamBytes - Telemetry information
    • totalMemoryEncryption - Informazioni sul dispositivo
  • I dati per questo campo sono controllati tramite il criterio ReportDeviceMemoryInfo.
  • Frequenza di raccolta dei dati:
    • totalRamBytes - Solo al caricamento
    • availableRamBytes - Ogni 10 minuti
    • totalMemoryEncryption - all'avvio del dispositivo
  • Frequenza predefinita di generazione dei report sui dati:
    • totalRamBytes - 3 ore
    • availableRamBytes - 3 ore
    • totalMemoryEncryption - all'avvio del dispositivo
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: solo per totalMemoryEncryption
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 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 di generazione dei report sui dati: all'avvio del dispositivo
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: 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 di 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 di 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 campioni di report sullo stato della memoria.

  • Questo campo contiene informazioni di telemetria e cambierà 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 caricamento, SystemRamFreeByes viene raccolto ogni 10 minuti
  • Frequenza predefinita dei report sui dati: ogni 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 l'ora in cui è stato campionato questo report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 affidabile a causa della 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 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 di generazione dei report sui dati: all'avvio del dispositivo
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: sì
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 di generazione dei report sui dati: all'avvio del dispositivo
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: 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 e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: sì
  • Segnalato solo per gli utenti affiliati: Sì
  • Autorizzazione granulare necessaria: 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),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
Campi
reportTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 connessione di rete.

connectionState

enum (NetworkConnectionState)

Solo output. Stato attuale della connessione di rete.

connectionType

enum (NetworkType)

Solo output. Tipo di connessione di rete.

ipv6Address[]

string

Solo output. Eventuali indirizzi IPv6 assegnati a questa rete. Ogni indirizzo è una stringa nella rappresentazione di testo IPv6 standard (ad es. "2001:db8::1").

gatewayIpv6Address

string

Solo output. L'IPv6 del gateway per questa interfaccia, se rilevato

metered

boolean

Solo output. Se la rete è stata rilevata come a consumo.

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 necessaria: 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 di test della latenza HTTPS.

OsUpdateStatus

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

  • Questo campo contiene informazioni di telemetria e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 in fase di download e applicazione. Viene impostato solo quando lo stato dell'aggiornamento è OS_IMAGE_DOWNLOAD_IN_PROGRESS o OS_UPDATE_NEED_REBOOT. Tieni presente che potrebbe trattarsi di un indirizzo "0.0.0.0" fittizio per lo stato OS_UPDATE_NEED_REBOOT in alcuni casi limite, ad esempio 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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 degli aggiornamenti.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 cambieranno nel tempo.
  • I dati per questo campo vengono controllati tramite il criterio: ReportDeviceGraphicsStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 sul touch screen o sui touch screen 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 di un dispositivo di visualizzazione.

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

string

Solo output. Visualizza 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. 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.

serialNumber

integer

Solo output. Numero di serie.

edidVersion

string

Solo output. Versione EDID.

TouchScreenInfo

Informazioni sul touch screen del dispositivo.

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

string

Solo output. Il nome della libreria del touchpad utilizzato dallo stack di input.

devices[]

object (TouchScreenDevice)

Solo output. Elenco dei dispositivi con touch screen integrato.

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. Se il dispositivo touch screen è compatibile con lo stilo o meno.

GraphicsStatusReport

Informazioni sul sottosistema grafico.

  • Questo campo contiene informazioni di telemetria e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: TELEMETRY_API_GRAPHICS_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 un display.

Rappresentazione JSON
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": 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. Visualizza il nome del dispositivo.

serialNumber

integer

Solo output. Numero di serie.

edidVersion

string

Solo output. Versione EDID.

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 la policy ReportDevicePowerStatus.
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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: Li-ion

BatteryStatusReport

Dati sullo stato della batteria.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite la policy ReportDevicePowerStatus.
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 per la 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 e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite la policy ReportDevicePowerStatus.
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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. 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 lo stato attuale della batteria.

  • Questo stato non è un indicatore 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 la policy di garanzia.
Enum
BATTERY_HEALTH_UNSPECIFIED Integrità sconosciuta.
BATTERY_HEALTH_NORMAL La batteria è in buono stato, capacità di ricarica completa / capacità di progetto > 80%
BATTERY_REPLACE_SOON La batteria è moderatamente danneggiata e si consiglia di sostituirla al più presto. Capacità di carica completa / capacità di progettazione 75% - 80%
BATTERY_REPLACE_NOW La batteria non è in buono stato e si consiglia di sostituirla. Capacità di carica completa / capacità di progettazione < 75%

StorageInfo

Dati di stato per l'archiviazione.

  • Questo campo contiene informazioni di telemetria e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: TELEMETRY_API_STORAGE_INFO
Rappresentazione JSON
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Campi
volume[]

object (DiskVolume)

Informazioni sui volumi disco

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 in byte.

DiskVolume

Informazioni sui volumi disco

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

string

ID volume disco.

storageFreeBytes

string (int64 format)

Spazio di archiviazione senza costi 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 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 sul 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. Dimensione disco.

type

string

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

health

string

Solo output. Integrità del disco.

volumeIds[]

string

Solo output. Volumi del disco.

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 trascorso a leggere 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 trascorso a scrivere 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 a eliminare elementi dall'ultimo avvio. L'eliminazione comporta la scrittura per cancellare i blocchi non più in uso. Supportato sui kernel 4.18+.

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 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 di generazione dei report sui dati: all'avvio del dispositivo
    • Controllato dai criteri: no
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: sì
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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 tunnel per il controller USB e la porta DisplayPort in una base di ricarica. Tutti i collegamenti PCIe a valle della base di ricarica vengono rimossi.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Il tunneling PCIe è disattivato.

BootPerformanceReport

Report sulle prestazioni di avvio di un dispositivo.

  • Questo campo contiene informazioni di telemetria e cambierà 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 di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: sì
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: 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)

Timestamp dell'ultima volta che si è riaccesa la corrente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 di raccolta del report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 Avviato dall'utente.
SYSTEM_UPDATE Aggiornamento di sistema avviato.
LOW_BATTERY Arresto per batteria scarica.
OTHER Arresto per altri motivi.

HeartbeatStatusReport

Report sullo stato di 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 il criterio: HeartbeatEnabled Ulteriori informazioni
  • Frequenza battito cardiaco: 2 minuti
    • 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 segnalati la volta successiva che il dispositivo sarà online: N/A
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "state": enum (State)
}
Campi
reportTime

string (Timestamp format)

Timestamp del rilevamento della modifica dello stato

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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)

Indica il nuovo stato del 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 e il timestamp dell'ultimo aggiornamento del report
  • I dati per questo campo vengono controllati tramite il criterio: ReportDeviceSessionStatus
  • Frequenza di raccolta dei dati: solo al caricamento
  • Frequenza predefinita di generazione dei report sui dati: 3 ore
    • Controllato dai criteri: Sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno segnalati quando il dispositivo tornerà online: No
  • Segnalato solo per gli utenti affiliati: N/A
  • Autorizzazione granulare necessaria: TELEMETRY_API_APPS_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Campi
reportTime

string (Timestamp format)

Timestamp relativo alla data e all'ora di raccolta del report

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 runtime è 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 di raccolta del report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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)

Durata totale di esecuzione. Attualmente sempre runtime 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)

Il numero di volte in cui il dispositivo è entrato in stato di sospensione. Attualmente ottenuto tramite il PSR, conteggio da S0 a S3.

enterHibernationCount

string (int64 format)

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

enterPoweroffCount

string (int64 format)

Il numero di volte in cui il dispositivo è entrato nello 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.