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)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
Campi
name

string

Solo output. Nome della risorsa del dispositivo.

customer

string

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

orgUnitId

string

Solo output. ID unità organizzativa del dispositivo.

deviceId

string

Solo output. L'ID univoco dell'API Directory del dispositivo. Questo valore 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. I report sullo stato della CPU raccolti periodicamente sono ordinati in un ordine decrescente di reportTime.

memoryInfo

object (MemoryInfo)

Solo output. Informazioni relative alle specifiche della memoria del dispositivo.

memoryStatusReport[]

object (MemoryStatusReport)

Solo output. Report sullo stato della memoria raccolti periodicamente in ordine decrescente di reportTime.

networkInfo

object (NetworkInfo)

Solo output. Informazioni sui dispositivi di rete.

networkStatusReport[]

object (NetworkStatusReport)

Solo output. Specifiche di rete raccolte periodicamente.

networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Solo output. Diagnostica di rete raccolta periodicamente.

osUpdateStatus[]

object (OsUpdateStatus)

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

graphicsInfo

object (GraphicsInfo)

Solo output. Contiene informazioni relative alle periferiche grafiche del dispositivo.

graphicsStatusReport[]

object (GraphicsStatusReport)

Solo output. Report di grafica 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 pullman Thunderbolt.

audioStatusReport[]

object (AudioStatusReport)

Solo output. I report audio raccolti periodicamente sono ordinati in un ordine decrescente pari a reportTime.

bootPerformanceReport[]

object (BootPerformanceReport)

Solo output. Report sulle prestazioni di avvio del dispositivo.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

Solo output. Il report sullo stato dell'heartbeat contiene 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. I report sulla larghezza di banda della rete raccolti periodicamente sono ordinati in un ordine decrescente di reportTime.

peripheralsReport[]

object (PeripheralsReport)

Solo output. I report sulle periferiche raccolti periodicamente sono ordinati in un ordine decrescente pari a reportTime.

runtimeCountersReport[]

object (RuntimeCountersReport)

Solo output. I contatori di runtime riportano il tempo di esecuzione del dispositivo, nonché i conteggi delle transizioni S0->S3, S0->S4 e S0->S5, che indicano l’ingresso in stato di sospensione, ibernazione e spegnimento.

CpuInfo

Specifiche della CPU del dispositivo

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceCpuInfo
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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 di CPU. Esempio: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz

architecture

enum (Architecture)

Solo output. Tipo di architettura della 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 dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
maxClockSpeed

integer

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

keylockerSupported

boolean

Solo output. Indica se l'uso dell'archivio chiavi è supportato.

keylockerConfigured

boolean

Solo output. Indica se è configurato il blocco tastiera.TRUE = attivato; FALSE = disattivato. 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 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 dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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 il report è stato campionato.

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

sampleFrequency

string (Duration format)

Solo output. La 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 (da 0 a 100%).

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Solo output. Informazioni di esempio sulla temperatura CPU per core della CPU in Celsius

CpuTemperatureInfo

Temperatura della CPU di un dispositivo. Campionamento per core 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 dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "temperatureCelsius": integer,
  "label": string
}
Campi
temperatureCelsius

integer

Solo output. Temperatura CPU in Celsius.

label

string

Solo output. l'etichetta CPU. Esempio: Core 0

MemoryInfo

Informazioni sulla memoria di un dispositivo.

  • Questo campo contiene informazioni sulla telemetria e sul dispositivo:
    • totalRamBytes - Informazioni del dispositivo
    • availableRamBytes - Informazioni di telemetria
    • totalMemoryEncryption - Informazioni del dispositivo
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceMemoryInfo
  • Frequenza di raccolta dei dati:
    • totalRamBytes - Solo al momento del caricamento
    • availableRamBytes - Ogni 10 minuti
    • totalMemoryEncryption - all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati:
    • totalRamBytes - 3 ore
    • availableRamBytes - 3 ore
    • totalMemoryEncryption - all'avvio del dispositivo
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online (solo per totalMemoryEncryption).
  • Segnalato solo per utenti affiliati: N/D
  • 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 di 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 dei report sui dati: all'avvio del dispositivo
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Campi
encryptionState

enum (MemoryEncryptionState)

Lo stato della crittografia della memoria del dispositivo.

maxKeys

string (int64 format)

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

keyLength

string (int64 format)

La lunghezza delle chiavi di crittografia.

encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Algoritmo di crittografia della memoria.

MemoryEncryptionState

Lo stato della crittografia della memoria del 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 del dispositivo utilizza la crittografia della memoria totale.
MEMORY_ENCRYPTION_STATE_MKTME La crittografia della memoria del dispositivo utilizza la crittografia della memoria totale con più chiavi.

MemoryEncryptionAlgorithm

L'algoritmo di crittografia utilizzato sul dispositivo.

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

MemoryStatusReport

Contiene esempi 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 dati: solo al momento del caricamento, SystemRamFreeByes viene raccolto ogni 10 minuti
  • Frequenza predefinita dei report sui dati: ogni 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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 il report è stato campionato.

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

sampleFrequency

string (Duration format)

Solo output. La 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 del dispositivo di rete.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati di 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
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per utenti affiliati: N/D
  • 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 di 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
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Campi
type

enum (NetworkDeviceType)

Solo output. Tipo di dispositivo di rete.

macAddress

string

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

meid

string

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

imei

string

Solo output. Codice 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 di questo campo sono controllati tramite il criterio: ReportNetworkStatus
  • Frequenza di raccolta dati: 60 minuti
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per 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)
}
Campi
reportTime

string (Timestamp format)

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

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

sampleFrequency

string (Duration format)

Solo output. La 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 dell'alimentazione del Wi-Fi attivata

guid

string

Solo output. Guida connessione di rete

connectionState

enum (NetworkConnectionState)

Solo output. Stato attuale della connessione della rete.

connectionType

enum (NetworkType)

Solo output. Tipo di connessione di rete.

NetworkType

Tipi di 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 Esegui il tethering della connessione di rete.
VPN Connessione di rete VPN.
WIFI Connessione alla 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 della raccolta della diagnostica.

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

httpsLatencyData

object (HttpsLatencyRoutineData)

Solo output. Dati di test sulla latenza HTTPS.

OsUpdateStatus

Contiene informazioni relative allo stato attuale di 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 dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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 da scaricare e applicare. Viene impostato solo se lo stato dell'aggiornamento è OS_IMAGE_DOWNLOAD_IN_PROGRESS o OS_UPDATE_NEED_REBOOT. Tieni presente che potrebbe essere un valore fittizio "0.0.0.0" per lo stato OS_UPDATE_NEED_REBOOT per 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.

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

lastUpdateCheckTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo controllo degli aggiornamenti.

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

lastRebootTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo riavvio.

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

UpdateState

Stato dell'aggiornamento del sistema operativo

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

GraphicsInfo

Informazioni sul sottosistema grafico.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceGraphicsStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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. 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 relative a una scheda grafica (GPU).

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

string

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

driverVersion

string

Solo output. Versione del driver GPU.

deviceId

string (int64 format)

Solo output. Rappresenta l'ID 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
}
Campi
displayName

string

Solo output. Nome del dispositivo visualizzato.

displayWidthMm

integer

Solo output. Larghezza del display in millimetri.

displayHeightMm

integer

Solo output. Mostra l'altezza in millimetri.

internal

boolean

Solo output. Display interno o no.

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 di touchpad utilizzato dallo stack di input.

devices[]

object (TouchScreenDevice)

Solo output. Elenco dei dispositivi touchscreen interni.

TouchScreenDevice

Informazioni di un dispositivo touchscreen interno.

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

string

Solo output. Nome visualizzato del dispositivo touchscreen.

touchPointCount

integer

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

stylusCapable

boolean

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

GraphicsStatusReport

Informazioni sul sottosistema grafico.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceGraphicsInfo
  • Frequenza di raccolta dati: 3 ore.
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare necessaria: TELEMETRY_API_GRAPHICS_REPORT
Rappresentazione JSON
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campi
reportTime

string (Timestamp format)

Solo output. Data/ora in cui sono stati registrati i dati grafici.

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

displays[]

object (DisplayInfo)

Solo output. Informazioni sui display del dispositivo.

DisplayInfo

Informazioni per un display.

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

string (int64 format)

Solo output. Rappresenta l'ID 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. Nome del dispositivo visualizzato.

BatteryInfo

Informazioni sulla batteria.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati di questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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 progettazione (mAmpere/ore).

designMinVoltage

integer

Solo output. Tensione di uscita minima progettata (mV)

manufactureDate

object (Date)

Solo output. La data di produzione della batteria.

technology

string

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

BatteryStatusReport

Dati sullo stato della batteria.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati di questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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

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

serialNumber

string

Solo output. Numero di serie della batteria.

sample[]

object (BatterySampleReport)

Solo output. I dati di campionamento per la batteria sono ordinati in ordine decrescente pari a 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 di questo campo sono controllati tramite il criterio: ReportDevicePowerStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
Rappresentazione JSON
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Campi
reportTime

string (Timestamp format)

Solo output. Timestamp della raccolta del campione sul dispositivo

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

voltage

string (int64 format)

Solo output. Tensione batteria (millivolt).

remainingCapacity

string (int64 format)

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

temperature

integer

Solo output. Temperatura in gradi Celsius.

dischargeRate

integer

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

chargeRate

integer

Solo output. Percentuale di carica della batteria.

current

string (int64 format)

Solo output. Corrente batteria (mA).

status

string

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

BatteryHealth

Rappresenta l'attuale stato di integrità della batteria.

  • Questo stato non indica un indicatore né la presenza di una batteria difettosa. Si calcola dividendo l'attuale capacità di ricarica completa per la capacità di progetto.
  • Spetta al produttore definire l'integrità della batteria e la politica di garanzia.
Enum
BATTERY_HEALTH_UNSPECIFIED Salute sconosciuta.
BATTERY_HEALTH_NORMAL La batteria è integro; capacità di ricarica completa / capacità di progettazione > 80%
BATTERY_REPLACE_SOON La batteria è moderatamente insalubre e si consiglia di sostituirla al più presto; capacità di ricarica completa / capacità di progettazione 75% - 80%
BATTERY_REPLACE_NOW La batteria non è integro e si consiglia di sostituirla; capacità di ricarica completa / capacità di progettazione < 75%

StorageInfo

Dati sullo stato dell'archiviazione.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati di questo campo sono controllati tramite il criterio: ReportDeviceStorageStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • Autorizzazione granulare necessaria: TELEMETRY_API_STORAGE_INFO
Rappresentazione JSON
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Campi
volume[]

object (DiskVolume)

Informazioni sui volumi di disco

availableDiskBytes

string (int64 format)

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

totalDiskBytes

string (int64 format)

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

DiskVolume

Informazioni sui volumi di disco

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

string

ID volume disco.

storageFreeBytes

string (int64 format)

Spazio di archiviazione libero in byte.

storageTotalBytes

string (int64 format)

Spazio di archiviazione totale in byte.

StorageStatusReport

Dati sullo stato dell'archiviazione.

  • Questo campo contiene informazioni di telemetria e cambierà nel tempo man mano che il dispositivo viene utilizzato.
  • I dati di questo campo sono controllati tramite il criterio: ReportDeviceStorageStatus
  • Frequenza di raccolta dati: solo al caricamento
  • Frequenza predefinita dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. No
  • Segnalato solo per utenti affiliati: N/D
  • 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

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

disk[]

object (DiskInfo)

Solo output. Report su disco.

DiskInfo

Stato del singolo dispositivo di archiviazione.

Rappresentazione JSON
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
Campi
serialNumber

string

Solo output. Numero di serie del disco.

manufacturer

string

Solo output. Produttore del disco.

model

string

Solo output. Modello di disco.

sizeBytes

string (int64 format)

Solo output. Dimensioni 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 nella 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 di scrittura su 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 sono stati occupati. Di conseguenza, 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 l'eliminazione dall'ultimo avvio. Eliminare significa scrivere per cancellare i blocchi 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 sull'autobus Thunderbolt.

  • Questo campo fornisce informazioni sul dispositivo, che sono statiche e non cambieranno nel tempo.
  • I dati per questo campo sono controllati tramite il criterio: ReportDeviceSecurityStatus
  • Frequenza di raccolta dei dati: all'avvio del dispositivo
  • Frequenza predefinita dei report sui dati: all'avvio del dispositivo
    • Controllo tramite criteri: no
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per utenti affiliati: N/D
  • 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 di Thunderbolt non è impostato.
THUNDERBOLT_SECURITY_NONE_LEVEL Tutti i dispositivi vengono connessi automaticamente tramite il firmware. Non è necessaria l'approvazione dell'utente.
THUNDERBOLT_SECURITY_USER_LEVEL All'utente viene chiesto se è 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 dovrebbe corrispondere a quella prevista sulla base di una chiave casuale scritta nell'attributo chiave sysfs
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Il firmware crea automaticamente tunnel per Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Il firmware crea automaticamente dei tunnel per il controller USB e la Display Port in un dock. Tutti i collegamenti PCIe a valle del dock vengono rimossi.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Il tunneling PCIE è disabilitato.

BootPerformanceReport

Report sulle prestazioni in fase 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 dei report sui dati: 3 ore
    • Controllo tramite criteri: sì
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online. Sì
  • Segnalato solo per utenti affiliati: N/D
  • 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 per l'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 di accensione della corrente.

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

shutdownDuration

string (Duration format)

Tempo totale dall'inizio dello spegnimento.

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

shutdownTime

string (Timestamp format)

Il timestamp della chiusura.

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

shutdownReason

enum (ShutdownReason)

Il motivo dell'arresto.

reportTime

string (Timestamp format)

Timestamp della raccolta del report.

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

ShutdownReason

Il motivo dell'arresto.

Enum
SHUTDOWN_REASON_UNSPECIFIED Il motivo dello spegnimento non è specificato.
USER_REQUEST Avviata dall'utente.
SYSTEM_UPDATE Aggiornamento di sistema avviato.
LOW_BATTERY Arresto per batteria in esaurimento.
OTHER Arresto per altri motivi.

HeartbeatStatusReport

Report sullo stato dell'heartbeat di un dispositivo.

  • Disponibile per i kiosk
  • Questo campo fornisce lo stato online/offline/sconosciuto di un dispositivo e viene incluso solo se lo stato è cambiato (ad es. Online -> Offline)
  • I dati di questo campo vengono controllati tramite il criterio: HeartbeatEnabled Maggiori informazioni
  • Frequenza battito cardiaco: 2 min
    • Nota: se un dispositivo diventa offline, l'aggiornamento dello stato online può richiedere fino a 12 minuti.
  • Cache: se il dispositivo è offline, i dati raccolti vengono archiviati localmente e verranno inclusi nei report quando il dispositivo sarà di nuovo online (N/D).
  • Segnalato solo per utenti affiliati: N/D
  • 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

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

state

enum (State)

Stato modificato in

Stato

Lo stato del dispositivo

Enum
STATE_UNSPECIFIED Stato non specificato
UNKNOWN Il dispositivo non è idoneo per il monitoraggio dell'heartbeat
ONLINE Il dispositivo è online
OFFLINE Il dispositivo è offline

KioskAppStatusReport

Report sullo stato dell'app kiosk di un dispositivo.

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

string (Timestamp format)

Timestamp della raccolta del report

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

appId

string

ID app dell'app kiosk, ad esempio "mdmkkicfmmkgmpkmkdikhlbggogpicma"

appVersion

string

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

RuntimeCountersReport

Contatori di runtime recuperati dalla CPU. Attualmente la telemetria dei contatori di 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 della raccolta del report.

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

uptimeRuntimeDuration

string (Duration format)

Tempo di esecuzione totale. 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)

Numero di volte in cui il dispositivo entra in stato di sospensione. Attualmente ottenuto tramite la PSR, conteggio da S0->S3.

enterHibernationCount

string (int64 format)

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

enterPoweroffCount

string (int64 format)

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

Metodi

get

Ottieni dispositivo di telemetria.

list

Elenca tutti i dispositivi di telemetria.