REST Resource: customers.telemetry.devices

Recurso: TelemetryDevice

Son los datos de telemetría recopilados de un dispositivo administrado.

  • Se necesita permiso detallado: TELEMETRY_API_DEVICE
Representación 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)
    }
  ]
}
Campos
name

string

Solo salida. Es el nombre del recurso del dispositivo.

customer

string

Solo salida. Cliente de Google Workspace cuya empresa inscribió el dispositivo.

orgUnitId

string

Solo salida. Es el ID de la unidad organizativa del dispositivo.

deviceId

string

Solo salida. Es el ID único de la API de Directory del dispositivo. Este valor es el mismo que el ID de la API de Directory de la Consola del administrador en la pestaña Dispositivos ChromeOS.

serialNumber

string

Solo salida. Es el número de serie del dispositivo. Este valor es el mismo que el número de serie de la Consola del administrador en la pestaña Dispositivos ChromeOS.

cpuInfo[]

object (CpuInfo)

Solo salida. Es información sobre las especificaciones de la CPU del dispositivo.

cpuStatusReport[]

object (CpuStatusReport)

Solo salida. Informes de estado de la CPU recopilados periódicamente y ordenados de forma decreciente según el valor de reportTime.

memoryInfo

object (MemoryInfo)

Solo salida. Es información sobre las especificaciones de memoria del dispositivo.

memoryStatusReport[]

object (MemoryStatusReport)

Solo salida. Informes de estado de la memoria recopilados periódicamente y ordenados de forma descendente según reportTime.

networkInfo

object (NetworkInfo)

Solo salida. Información de dispositivos de red

networkStatusReport[]

object (NetworkStatusReport)

Solo salida. Las especificaciones de red se recopilan periódicamente.

networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Solo salida. Diagnósticos de red recopilados periódicamente

osUpdateStatus[]

object (OsUpdateStatus)

Solo salida. Contiene información relevante sobre el estado de la actualización de ChromeOS.

graphicsInfo

object (GraphicsInfo)

Solo salida. Contiene información sobre los periféricos gráficos del dispositivo.

graphicsStatusReport[]

object (GraphicsStatusReport)

Solo salida. Se recopilan informes de gráficos periódicamente.

batteryInfo[]

object (BatteryInfo)

Solo salida. Es información sobre las especificaciones de la batería del dispositivo.

batteryStatusReport[]

object (BatteryStatusReport)

Solo salida. Los informes de batería se recopilan periódicamente.

storageInfo

object (StorageInfo)

Solo salida. Es la información de las especificaciones de almacenamiento del dispositivo.

storageStatusReport[]

object (StorageStatusReport)

Solo salida. Informes de almacenamiento recopilados periódicamente

thunderboltInfo[]

object (ThunderboltInfo)

Solo salida. Es información sobre el bus Thunderbolt.

audioStatusReport[]

object (AudioStatusReport)

Solo salida. Informes de audio recopilados periódicamente y ordenados de forma decreciente según reportTime.

bootPerformanceReport[]

object (BootPerformanceReport)

Solo salida. Informes de rendimiento de inicio del dispositivo.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

Solo salida. Informe de estado de latido que contiene marcas de tiempo ordenadas periódicamente en orden decreciente de reportTime

kioskAppStatusReport[]

object (KioskAppStatusReport)

Solo salida. Informe de estado de la aplicación de kiosco para el dispositivo de kiosco

networkBandwidthReport[]

object (NetworkBandwidthReport)

Solo salida. Informes de ancho de banda de la red recopilados periódicamente y ordenados de forma descendente según reportTime.

peripheralsReport[]

object (PeripheralsReport)

Solo salida. Informes de periféricos recopilados periódicamente y ordenados de forma decreciente según el valor de reportTime.

appReport[]

object (AppReport)

Solo salida. Informes de la app recopilados periódicamente y ordenados de forma decreciente según el valor de reportTime.

runtimeCountersReport[]

object (RuntimeCountersReport)

Solo salida. Los informes de los contadores de tiempo de ejecución registran el tiempo de ejecución total del dispositivo, así como los recuentos de las transiciones de S0 a S3, de S0 a S4 y de S0 a S5, lo que significa que se ingresa en los estados de suspensión, hibernación y apagado.

CpuInfo

Especificaciones de la CPU del dispositivo

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDeviceCpuInfo.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_CPU_INFO
Representación JSON
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Campos
model

string

Solo salida. Es el nombre del modelo de la CPU. Ejemplo: CPU Intel(R) Core(TM) i5-8250U a 1.60 GHz

architecture

enum (Architecture)

Solo salida. Tipo de arquitectura de la CPU.

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDeviceCpuInfo.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
maxClockSpeed

integer

Solo salida. Velocidad máxima de reloj de la CPU en kHz.

keylockerSupported

boolean

Solo salida. Indica si se admite Key Locker.

keylockerConfigured

boolean

Solo salida. Indica si Key Locker está configurado.TRUE = Habilitado; FALSE = Inhabilitado. Solo se informa si keylockerSupported = TRUE.

Arquitectura

Tipo de arquitectura de la CPU.

Enums
ARCHITECTURE_UNSPECIFIED Arquitectura desconocida.
X64 Arquitectura x64

CpuStatusReport

Proporciona información sobre el estado de la CPU.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceCpuInfo.
  • Frecuencia de recopilación de datos: Cada 10 minutos
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_CPU_REPORT
Representación JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en milisegundos que representa el momento en el que se tomó la muestra de este informe.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Solo salida. Frecuencia con la que se muestrea el informe.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

cpuUtilizationPct

integer

Solo salida. Muestra del uso de CPU (de 0 a 100 por ciento).

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Solo salida. Información de la muestra de temperatura de la CPU por núcleo de CPU en grados Celsius

CpuTemperatureInfo

Es la temperatura de la CPU de un dispositivo. Se toman muestras por núcleo de CPU en grados Celsius.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceCpuInfo.
  • Frecuencia de recopilación de datos: Cada 10 minutos
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
Representación JSON
{
  "temperatureCelsius": integer,
  "label": string
}
Campos
temperatureCelsius

integer

Solo salida. Temperatura de la CPU en grados Celsius.

label

string

Solo salida. Es la etiqueta de la CPU. Ejemplo: Núcleo 0

MemoryInfo

Es la información de la memoria de un dispositivo.

  • Este campo contiene información del dispositivo y telemetría:
    • totalRamBytes: Información del dispositivo
    • availableRamBytes: Información de telemetría
    • totalMemoryEncryption: Información del dispositivo
  • Los datos de este campo se controlan a través de la política ReportDeviceMemoryInfo.
  • Frecuencia de recopilación de datos:
    • totalRamBytes: Solo en la carga
    • availableRamBytes: Cada 10 minutos
    • totalMemoryEncryption: Al inicio del dispositivo
  • Frecuencia predeterminada de informes de datos:
    • totalRamBytes - 3 horas
    • availableRamBytes - 3 horas
    • totalMemoryEncryption: Al inicio del dispositivo
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea (solo para totalMemoryEncryption).
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_MEMORY_INFO
Representación JSON
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Campos
totalRamBytes

string (int64 format)

Solo salida. Es la RAM total en bytes.

availableRamBytes

string (int64 format)

Solo salida. Cantidad de RAM disponible en bytes.

totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Solo salida. Es la información de encriptación de memoria total del dispositivo.

TotalMemoryEncryptionInfo

Es la información de encriptación de la memoria de un dispositivo.

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDeviceMemoryInfo.
  • Frecuencia de recopilación de datos: Al iniciar el dispositivo
  • Frecuencia predeterminada de informes de datos: Al iniciar el dispositivo
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: N/A
Representación JSON
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Campos
encryptionState

enum (MemoryEncryptionState)

El estado de la encriptación de la memoria en el dispositivo

maxKeys

string (int64 format)

Es la cantidad máxima de claves que se pueden usar para la encriptación.

keyLength

string (int64 format)

Es la longitud de las claves de encriptación.

encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Es el algoritmo de encriptación de memoria.

MemoryEncryptionState

El estado de la encriptación de la memoria en el dispositivo

Enums
MEMORY_ENCRYPTION_STATE_UNSPECIFIED No se estableció el estado de encriptación de la memoria.
MEMORY_ENCRYPTION_STATE_UNKNOWN Se desconoce el estado de encriptación de la memoria.
MEMORY_ENCRYPTION_STATE_DISABLED La encriptación de la memoria en el dispositivo está inhabilitada.
MEMORY_ENCRYPTION_STATE_TME La encriptación de la memoria en el dispositivo usa la encriptación de la memoria total.
MEMORY_ENCRYPTION_STATE_MKTME La encriptación de la memoria en el dispositivo usa la encriptación de memoria total de varias claves.

MemoryEncryptionAlgorithm

Es el algoritmo de encriptación que se usa en el dispositivo.

Enums
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED No se configuró el algoritmo de encriptación de memoria.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Se desconoce el algoritmo de encriptación de memoria que se usa.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 El algoritmo de encriptación de la memoria usa el algoritmo de encriptación AES_XTS con un cifrado de bloques de 128 bits.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 El algoritmo de encriptación de la memoria usa el algoritmo de encriptación AES_XTS con un cifrado de bloques de 256 bits.

MemoryStatusReport

Contiene muestras de informes de estado de la memoria.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceMemoryInfo.
  • Frecuencia de recopilación de datos: Solo en la carga. SystemRamFreeBytes se recopila cada 10 minutos.
  • Frecuencia predeterminada de informes de datos: Cada 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_MEMORY_REPORT
Representación JSON
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Campos
reportTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en milisegundos que representa el momento en el que se tomó la muestra de este informe.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Solo salida. Frecuencia con la que se muestrea el informe.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

systemRamFreeBytes

string (int64 format)

Solo salida. Cantidad de RAM libre en bytes (no es confiable debido a la recolección de elementos no utilizados).

pageFaults

integer

Solo salida. Cantidad de fallos de página durante esta recopilación

NetworkInfo

Información del dispositivo de red

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportNetworkDeviceConfiguration.
  • Frecuencia de recopilación de datos: Al iniciar el dispositivo
  • Frecuencia predeterminada de informes de datos: Al iniciar el dispositivo
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_NETWORK_INFO
Representación JSON
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Campos
networkDevices[]

object (NetworkDevice)

Solo salida. Es la lista de dispositivos de red.

NetworkDevice

Son los detalles sobre el dispositivo de red.

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportNetworkDeviceConfiguration.
  • Frecuencia de recopilación de datos: Al iniciar el dispositivo
  • Frecuencia predeterminada de informes de datos: Al iniciar el dispositivo
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: N/A
Representación JSON
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Campos
type

enum (NetworkDeviceType)

Solo salida. Es el tipo de dispositivo de red.

macAddress

string

Solo salida. Dirección MAC (si corresponde) del dispositivo de red correspondiente

meid

string

Solo salida. MEID (si corresponde) del dispositivo de red correspondiente

imei

string

Solo salida. IMEI (si corresponde) del dispositivo de red correspondiente

iccid

string

Solo salida. ID de la tarjeta de circuito integrado asociado con la tarjeta SIM del dispositivo

mdn

string

Solo salida. Es el número de directorio móvil asociado con la tarjeta SIM del dispositivo.

NetworkDeviceType

Son los tipos de dispositivos de red.

Enums
NETWORK_DEVICE_TYPE_UNSPECIFIED No se especificó el tipo de dispositivo de red.
CELLULAR_DEVICE Es un dispositivo celular.
ETHERNET_DEVICE Dispositivo Ethernet.
WIFI_DEVICE Dispositivo Wi-Fi.

NetworkStatusReport

Es el estado de las redes visibles o configuradas.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportNetworkStatus.
  • Frecuencia de recopilación de datos: 60 minutos
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: Sí
  • Se necesita el permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación 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
}
Campos
reportTime

string (Timestamp format)

Solo salida. Fecha y hora en que se informó el estado de la red.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

sampleFrequency

string (Duration format)

Solo salida. Frecuencia con la que se muestrea el informe.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

signalStrengthDbm

integer

Solo salida. La intensidad de la señal de las redes inalámbricas medida en decibelios

lanIpAddress

string

Solo salida. Dirección IP de LAN

gatewayIpAddress

string

Solo salida. Es la dirección IP de la puerta de enlace.

transmissionBitRateMbps

string (int64 format)

Solo salida. Tasa de bits de transmisión medida en megabits por segundo

receivingBitRateMbps

string (int64 format)

Solo salida. Tasa de bits de recepción medida en megabits por segundo.

transmissionPowerDbm

integer

Solo salida. Potencia de transmisión medida en decibelios

encryptionOn

boolean

Solo salida. Indica si la clave de encriptación de Wi-Fi está desactivada.

wifiPowerManagementEnabled

boolean

Solo salida. Se habilitó la administración de energía de Wi-Fi

guid

string

Solo salida. Es el GUID de la conexión de red.

connectionState

enum (NetworkConnectionState)

Solo salida. Es el estado de conexión actual de la red.

connectionType

enum (NetworkType)

Solo salida. Tipo de conexión de red.

ipv6Address[]

string

Solo salida. Son las direcciones IPv6 asignadas a esta red, si las hay. Cada dirección es una cadena en la representación de texto estándar de IPv6 (p.ej., "2001:db8::1").

gatewayIpv6Address

string

Solo salida. Es la IPv6 de la puerta de enlace para esta interfaz, si se detecta.

metered

boolean

Solo salida. Indica si se detectó que la red es de uso medido.

NetworkType

Tipos de conexión de red

Enums
NETWORK_TYPE_UNSPECIFIED Tipo de conexión de red no especificado
CELLULAR Conexión de red móvil
ETHERNET Conexión de red Ethernet
TETHER Conexión de red mediante dispositivo móvil
VPN Conexión de red de VPN
WIFI Conexión de red Wi-Fi

NetworkDiagnosticsReport

Resultados de las pruebas de red para determinar el estado de la conexión de red del dispositivo, por ejemplo, si la latencia de HTTPS es alta o normal

  • Se necesita el permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Campos
reportTime

string (Timestamp format)

Solo salida. Es la marca de tiempo del momento en que se recopiló el diagnóstico.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

httpsLatencyData

object (HttpsLatencyRoutineData)

Solo salida. Son datos de prueba de latencia de HTTPS.

OsUpdateStatus

Contiene información sobre el estado actual de la actualización del SO.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceOsUpdateStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_OS_REPORT
Representación JSON
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Campos
updateState

enum (UpdateState)

Solo salida. Es el estado actual de la actualización del SO.

newPlatformVersion

string

Solo salida. Se está descargando y aplicando la nueva versión de la plataforma de la imagen del SO. Solo se establece cuando el estado de actualización es OS_IMAGE_DOWNLOAD_IN_PROGRESS o OS_UPDATE_NEED_REBOOT. Ten en cuenta que podría ser un "0.0.0.0" ficticio para el estado OS_UPDATE_NEED_REBOOT en algunos casos extremos, p.ej., cuando se reinicia el motor de actualización sin reiniciar el dispositivo.

newRequestedPlatformVersion

string

Solo salida. Es la nueva versión de la plataforma solicitada de la aplicación de kiosco actualizada pendiente.

lastUpdateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización correcta.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastUpdateCheckTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última verificación de actualización.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastRebootTime

string (Timestamp format)

Solo salida. Marca de tiempo del último reinicio.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

UpdateState

Estado de la actualización del SO

Enums
UPDATE_STATE_UNSPECIFIED No se especificó el estado.
OS_IMAGE_DOWNLOAD_NOT_STARTED El SO no comenzó la descarga.
OS_IMAGE_DOWNLOAD_IN_PROGRESS El SO comenzó la descarga en el dispositivo.
OS_UPDATE_NEED_REBOOT El dispositivo debe reiniciarse para finalizar la carga.

GraphicsInfo

Es la información del subsistema de gráficos.

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDeviceGraphicsStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_GRAPHICS_INFO
Representación JSON
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Campos
adapterInfo

object (GraphicsAdapterInfo)

Solo salida. Es la información sobre el adaptador de gráficos (GPU).

eprivacySupported

boolean

Solo salida. Indica si la pantalla de privacidad electrónica es compatible o no.

displayDevices[]

object (DisplayDevice)

Solo salida. Es información sobre las pantallas del dispositivo.

touchScreenInfo

object (TouchScreenInfo)

Solo salida. Es información sobre las pantallas táctiles internas del dispositivo.

GraphicsAdapterInfo

Es la información de un adaptador de gráficos (GPU).

Representación JSON
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Campos
adapter

string

Solo salida. Nombre del adaptador. Ejemplo: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).

driverVersion

string

Solo salida. Es la versión del controlador de GPU.

deviceId

string (int64 format)

Solo salida. Representa el ID del dispositivo de la tarjeta gráfica.

DisplayDevice

Es la información de un dispositivo de pantalla.

Representación JSON
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
displayName

string

Solo salida. Muestra el nombre del dispositivo.

displayWidthMm

integer

Solo salida. Ancho de la pantalla en milímetros.

displayHeightMm

integer

Solo salida. Altura de la pantalla en milímetros.

internal

boolean

Solo salida. Indica si la pantalla es interna o no.

manufacturerId

string

Solo salida. Es el ID del fabricante de tres letras.

modelId

integer

Solo salida. Es el código de producto del fabricante.

manufactureYear

integer

Solo salida. Año de fabricación

serialNumber

integer

Solo salida. Número de serie

edidVersion

string

Solo salida. Versión de EDID.

TouchScreenInfo

Es información sobre la pantalla táctil del dispositivo.

Representación JSON
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Campos
touchpadLibrary

string

Solo salida. Nombre de la biblioteca del panel táctil que usa la pila de entrada.

devices[]

object (TouchScreenDevice)

Solo salida. Es la lista de dispositivos internos con pantalla táctil.

TouchScreenDevice

Es la información de un dispositivo interno con pantalla táctil.

Representación JSON
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Campos
displayName

string

Solo salida. Es el nombre visible del dispositivo con pantalla táctil.

touchPointCount

integer

Solo salida. Cantidad de puntos táctiles admitidos en el dispositivo.

stylusCapable

boolean

Solo salida. Indica si el dispositivo con pantalla táctil es compatible con lápices ópticos.

GraphicsStatusReport

Es la información del subsistema de gráficos.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceGraphicsInfo.
  • Frecuencia de recopilación de datos: 3 horas.
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_GRAPHICS_REPORT
Representación JSON
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Solo salida. Fecha y hora en que se informaron los datos de gráficos.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

displays[]

object (DisplayInfo)

Solo salida. Es información sobre las pantallas del dispositivo.

DisplayInfo

Es información para una pantalla.

Representación JSON
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
deviceId

string (int64 format)

Solo salida. Representa el ID del dispositivo de la tarjeta gráfica.

resolutionWidth

integer

Solo salida. Ancho de resolución en píxeles.

resolutionHeight

integer

Solo salida. Altura de la resolución en píxeles.

refreshRate

integer

Solo salida. Es la frecuencia de actualización en Hz.

isInternal

boolean

Solo salida. Indica si la pantalla es interna o no.

displayName

string

Solo salida. Muestra el nombre del dispositivo.

serialNumber

integer

Solo salida. Número de serie

edidVersion

string

Solo salida. Versión de EDID.

BatteryInfo

Es información sobre la batería.

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDevicePowerStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_BATTERY_INFO
Representación JSON
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Campos
serialNumber

string

Solo salida. Número de serie de la batería

manufacturer

string

Solo salida. Fabricante de la batería.

designCapacity

string (int64 format)

Solo salida. Capacidad de diseño (mAh)

designMinVoltage

integer

Solo salida. Voltaje de salida mínimo (mV) diseñado

manufactureDate

object (Date)

Solo salida. Fecha de fabricación de la batería

technology

string

Solo salida. Tecnología de la batería. Ejemplo: Li-ion

BatteryStatusReport

Son los datos de estado de la batería.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDevicePowerStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_BATTERY_REPORT
Representación JSON
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Campos
reportTime

string (Timestamp format)

Solo salida. Marca de tiempo en la que se recopiló la muestra en el dispositivo

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

serialNumber

string

Solo salida. Número de serie de la batería

sample[]

object (BatterySampleReport)

Solo salida. Son los datos de muestreo de la batería ordenados de forma descendente según el valor de reportTime.

batteryHealth

enum (BatteryHealth)

Solo salida. Estado de la batería

fullChargeCapacity

string (int64 format)

Solo salida. Capacidad de carga completa (mAh)

cycleCount

integer

Solo salida. Es el recuento de ciclos.

BatterySampleReport

Son datos de muestreo de la batería.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDevicePowerStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
Representación JSON
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Campos
reportTime

string (Timestamp format)

Solo salida. Marca de tiempo en la que se recopiló la muestra en el dispositivo

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

voltage

string (int64 format)

Solo salida. Voltaje de la batería (en milivoltios).

remainingCapacity

string (int64 format)

Solo salida. Capacidad restante de la batería (mAh)

temperature

integer

Solo salida. Temperatura en grados Celsius

dischargeRate

integer

Solo salida. Es la tasa de descarga de la batería medida en mW. Es positivo si la batería se está descargando y negativo si se está cargando.

chargeRate

integer

Solo salida. Porcentaje de carga de la batería.

current

string (int64 format)

Solo salida. Corriente de la batería (mA).

status

string

Solo salida. Estado de la batería leído desde sysfs. Ejemplo: Descarga

BatteryHealth

Representa el estado actual de la batería.

  • Este estado no es un indicador ni una señal de que la batería esté defectuosa. Se calcula dividiendo la capacidad de carga completa actual por la capacidad de diseño.
  • El fabricante es quien define la integridad de la batería y la política de garantía.
Enums
BATTERY_HEALTH_UNSPECIFIED Se desconoce el estado.
BATTERY_HEALTH_NORMAL La batería está en buen estado, la capacidad de carga completa / capacidad de diseño es superior al 80%.
BATTERY_REPLACE_SOON La batería está moderadamente en mal estado y se sugiere reemplazarla pronto. La capacidad de carga completa y la capacidad de diseño son del 75% al 80%.
BATTERY_REPLACE_NOW La batería no está en buen estado y se recomienda reemplazarla. La capacidad de carga completa o la capacidad de diseño es inferior al 75%.

StorageInfo

Son los datos de estado del almacenamiento.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceStorageStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_STORAGE_INFO
Representación JSON
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Campos
volume[]

object (DiskVolume)

Información de volúmenes de disco

availableDiskBytes

string (int64 format)

Es el espacio disponible para el almacenamiento de datos del usuario en el dispositivo, expresado en bytes.

totalDiskBytes

string (int64 format)

Es el espacio total para el almacenamiento de datos del usuario en el dispositivo, expresado en bytes.

DiskVolume

Información de volúmenes de disco

Representación JSON
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Campos
volumeId

string

Es el ID del volumen del disco.

storageFreeBytes

string (int64 format)

Espacio de almacenamiento disponible en bytes.

storageTotalBytes

string (int64 format)

Es el espacio de almacenamiento total en bytes.

StorageStatusReport

Son los datos de estado del almacenamiento.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceStorageStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Permiso detallado necesario: TELEMETRY_API_STORAGE_REPORT
Representación JSON
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Solo salida. Marca de tiempo en la que se recopiló la muestra en el dispositivo

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

disk[]

object (DiskInfo)

Solo salida. Informes en el disco.

DiskInfo

Es el estado del dispositivo de almacenamiento único.

Representación 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
}
Campos
serialNumber

string

Solo salida. Número de serie del disco.

manufacturer

string

Solo salida. Es el fabricante del disco.

model

string

Solo salida. Es el modelo del disco.

sizeBytes

string (int64 format)

Solo salida. Tamaño del disco.

type

string

Solo salida. Tipo de disco: eMMC, NVMe, ATA o SCSI.

health

string

Solo salida. Estado del disco

volumeIds[]

string

Solo salida. Volúmenes de disco

bytesReadThisSession

string (int64 format)

Solo salida. Cantidad de bytes leídos desde el último inicio.

bytesWrittenThisSession

string (int64 format)

Solo salida. Cantidad de bytes escritos desde el último inicio.

readTimeThisSession

string (Duration format)

Solo salida. Tiempo dedicado a la lectura del disco desde el último inicio.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

writeTimeThisSession

string (Duration format)

Solo salida. Tiempo dedicado a escribir en el disco desde el último arranque.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

ioTimeThisSession

string (Duration format)

Solo salida. Cuenta el tiempo que el disco y la cola estuvieron ocupados, por lo que, a diferencia de los campos anteriores, las solicitudes paralelas no se cuentan varias veces.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

discardTimeThisSession

string (Duration format)

Solo salida. Tiempo que se dedicó a descartar desde el último inicio. Descartar significa escribir en bloques claros que ya no están en uso. Compatible con kernels 4.18 y versiones posteriores.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

ThunderboltInfo

Información del autobús Thunderbolt

  • Este campo proporciona información del dispositivo, que es estática y no cambiará con el tiempo.
  • Los datos de este campo se controlan a través de la política ReportDeviceSecurityStatus.
  • Frecuencia de recopilación de datos: Al iniciar el dispositivo
  • Frecuencia predeterminada de informes de datos: Al iniciar el dispositivo
    • Controlada por políticas: No
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_BUS_DEVICE_INFO
Representación JSON
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Campos
securityLevel

enum (ThunderboltSecurityLevel)

Nivel de seguridad del bus Thunderbolt.

ThunderboltSecurityLevel

Nivel de seguridad del bus Thunderbolt.

Enums
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED No se configuró el nivel de seguridad de Thunderbolt.
THUNDERBOLT_SECURITY_NONE_LEVEL El firmware conecta automáticamente todos los dispositivos. No se necesita la aprobación del usuario.
THUNDERBOLT_SECURITY_USER_LEVEL Se le pregunta al usuario si se permite conectar el dispositivo.
THUNDERBOLT_SECURITY_SECURE_LEVEL Se le pregunta al usuario si se permite conectar el dispositivo. Además, se le envía al dispositivo un desafío que debe coincidir con el esperado en función de una clave aleatoria escrita en el atributo sysfs de la clave.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL El firmware crea automáticamente túneles para Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL El firmware crea automáticamente túneles para el controlador USB y el puerto de pantalla en una estación de carga. Se quitan todas las conexiones PCIe que se encuentran después de la estación de carga.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL La tunelización de PCIe está inhabilitada.

BootPerformanceReport

Es un informe del rendimiento de inicio de un dispositivo.

  • Este campo contiene información de telemetría y cambiará con el tiempo a medida que se utilice el dispositivo.
  • Los datos de este campo se controlan a través de la política ReportDeviceBootMode.
  • Frecuencia de recopilación de datos: En cada evento de inicio
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: Sí
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_OS_REPORT
Representación JSON
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Campos
bootUpDuration

string (Duration format)

Tiempo total de inicio

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

bootUpTime

string (Timestamp format)

Es la marca de tiempo de cuando se encendió la alimentación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

shutdownDuration

string (Duration format)

Tiempo total desde el inicio del apagado hasta que se apaga.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

shutdownTime

string (Timestamp format)

Es la marca de tiempo del momento en que se apagó.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

shutdownReason

enum (ShutdownReason)

Es el motivo del apagado.

reportTime

string (Timestamp format)

Es la marca de tiempo en la que se recopiló el informe.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ShutdownReason

Es el motivo del apagado.

Enums
SHUTDOWN_REASON_UNSPECIFIED No se especificó el motivo del apagado.
USER_REQUEST Iniciado por el usuario.
SYSTEM_UPDATE Se inició la actualización del sistema.
LOW_BATTERY Se apagó debido a batería baja.
OTHER Se apagó por otros motivos.

HeartbeatStatusReport

Es el informe de estado de la señal de monitoreo de funcionamiento de un dispositivo.

  • Disponible para kioscos
  • Este campo proporciona el estado en línea, sin conexión o desconocido de un dispositivo y solo se incluirá si el estado cambió (p. ej., En línea -> Sin conexión).
  • Los datos de este campo se controlan a través de la política HeartbeatEnabled. Más información
  • Frecuencia de latidos: 2 minutos
    • Nota: Si un dispositivo se queda sin conexión, el estado en línea del dispositivo puede demorar hasta 12 minutos en actualizarse.
  • Caché: Si el dispositivo no tiene conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: N/A
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Representación JSON
{
  "reportTime": string,
  "state": enum (State)
}
Campos
reportTime

string (Timestamp format)

Marca de tiempo del momento en que se detectó el cambio de estado

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

state

enum (State)

Estado al que cambió el dispositivo

Estado

El estado del dispositivo

Enums
STATE_UNSPECIFIED No se especificó el estado
UNKNOWN El dispositivo no es apto para la supervisión de señal de monitoreo de funcionamiento
ONLINE El dispositivo está en línea
OFFLINE Dispositivo sin conexión
DEVICE_OUTDATED El dispositivo está desactualizado

KioskAppStatusReport

Es el informe de estado de la aplicación de kiosco de un dispositivo.

  • Disponible para kioscos
  • Este campo proporciona el ID y el número de versión de la app que se ejecuta en un dispositivo de kiosco, así como la marca de tiempo de la última actualización del informe.
  • Los datos de este campo se controlan a través de la política ReportDeviceSessionStatus.
  • Frecuencia de recopilación de datos: Solo en la carga
  • Frecuencia predeterminada de informes de datos: 3 horas
    • Controlada por políticas: Sí
  • Caché: Si el dispositivo está sin conexión, los datos recopilados se almacenan de forma local y se informarán cuando el dispositivo vuelva a estar en línea: No
  • Solo se informa para los usuarios afiliados: N/A
  • Se necesita permiso detallado: TELEMETRY_API_APPS_REPORT
Representación JSON
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Campos
reportTime

string (Timestamp format)

Marca de tiempo de la recopilación del informe

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

appId

string

ID de la aplicación de kiosco, por ejemplo, "mdmkkicfmmkgmpkmkdikhlbggogpicma"

appVersion

string

Número de versión de la aplicación de kiosco, por ejemplo, "1.10.118"

RuntimeCountersReport

Contadores de tiempo de ejecución recuperados de la CPU. Actualmente, la telemetría de los contadores de tiempo de ejecución solo es compatible con Intel vPro PSR en Gen 14 y versiones posteriores.

Representación JSON
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Campos
reportTime

string (Timestamp format)

Es la marca de tiempo en la que se recopiló el informe.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

uptimeRuntimeDuration

string (Duration format)

Es el tiempo de ejecución total a lo largo del ciclo de vida. Actualmente, siempre es el tiempo de ejecución S0 de Intel vPro PSR.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

enterSleepCount

string (int64 format)

Cantidad de veces que el dispositivo entró en estado de suspensión. Actualmente, se obtiene a través del PSR, recuento de S0 a S3.

enterHibernationCount

string (int64 format)

Cantidad de veces que el dispositivo entró en estado de hibernación. Actualmente, se obtiene a través del PSR, recuento de S0 a S4.

enterPoweroffCount

string (int64 format)

Cantidad de veces que el dispositivo entró en el estado de apagado. Actualmente, se obtiene a través del PSR y se cuenta desde S0 hasta S5.

Métodos

get

Obtiene el dispositivo de telemetría.

list

Enumera todos los dispositivos de telemetría.