REST Resource: customers.telemetry.devices

Recurso: TelemetryDevice

Dados de telemetria coletados de um dispositivo gerenciado.

  • Permissão granular necessária: TELEMETRY_API_DEVICE
Representação 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

Apenas saída. Nome do recurso do dispositivo.
customer

string

Apenas saída. Cliente do Google Workspace cuja empresa registrou o dispositivo.
orgUnitId

string

Apenas saída. ID da unidade organizacional do dispositivo.
deviceId

string

Apenas saída. O ID exclusivo da API Directory do dispositivo. Esse valor é o mesmo que o ID da API Directory do Admin Console na guia "Dispositivos ChromeOS".
serialNumber

string

Apenas saída. Número de série do dispositivo. Esse valor é o mesmo que o número de série do Admin Console na guia "Dispositivos ChromeOS".
cpuInfo[]

object (CpuInfo)

Apenas saída. Informações sobre as especificações da CPU do dispositivo.
cpuStatusReport[]

object (CpuStatusReport)

Apenas saída. Relatórios de status da CPU coletados periodicamente e classificados em ordem decrescente de reportTime.
memoryInfo

object (MemoryInfo)

Apenas saída. Informações sobre as especificações de memória do dispositivo.
memoryStatusReport[]

object (MemoryStatusReport)

Apenas saída. Relatórios de status da memória coletados periodicamente e classificados em ordem decrescente por reportTime.
networkInfo

object (NetworkInfo)

Apenas saída. Informações sobre dispositivos de rede.
networkStatusReport[]

object (NetworkStatusReport)

Apenas saída. Especificações de rede coletadas periodicamente.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Apenas saída. Diagnósticos de rede coletados periodicamente.
osUpdateStatus[]

object (OsUpdateStatus)

Apenas saída. Contém informações relevantes sobre o status da atualização do ChromeOS.
graphicsInfo

object (GraphicsInfo)

Apenas saída. Contém informações sobre periféricos gráficos para o dispositivo.
graphicsStatusReport[]

object (GraphicsStatusReport)

Apenas saída. Relatórios gráficos coletados periodicamente.
batteryInfo[]

object (BatteryInfo)

Apenas saída. Informações sobre as especificações da bateria do dispositivo.
batteryStatusReport[]

object (BatteryStatusReport)

Apenas saída. Relatórios de bateria coletados periodicamente.
storageInfo

object (StorageInfo)

Apenas saída. Informações sobre as especificações de armazenamento do dispositivo.
storageStatusReport[]

object (StorageStatusReport)

Apenas saída. Relatórios de armazenamento coletados periodicamente.
thunderboltInfo[]

object (ThunderboltInfo)

Apenas saída. Informações sobre o barramento Thunderbolt.
audioStatusReport[]

object (AudioStatusReport)

Apenas saída. Relatórios de áudio coletados periodicamente e classificados em ordem decrescente de reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

Apenas saída. Relatórios de desempenho de inicialização do dispositivo.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Apenas saída. Relatório de status de pulsação com carimbos de data/hora classificados periodicamente em ordem decrescente de reportTime.
kioskAppStatusReport[]

object (KioskAppStatusReport)

Apenas saída. Relatório de status do aplicativo de quiosque para o dispositivo
networkBandwidthReport[]

object (NetworkBandwidthReport)

Apenas saída. Relatórios de largura de banda da rede coletados periodicamente e classificados em ordem decrescente de reportTime.
peripheralsReport[]

object (PeripheralsReport)

Apenas saída. Relatórios de periféricos coletados periodicamente e classificados em ordem decrescente de reportTime.
appReport[]

object (AppReport)

Apenas saída. Relatórios de apps coletados periodicamente e classificados em ordem decrescente de reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

Apenas saída. Os relatórios de contadores de tempo de execução coletavam o tempo de execução do dispositivo ao longo da vida útil, bem como as contagens de transições S0->S3, S0->S4 e S0->S5, ou seja, entrada em estados de suspensão, hibernação e desligamento.

CpuInfo

Especificações da CPU do dispositivo

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política ReportDeviceCpuInfo.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_CPU_INFO
Representação JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Campos
model

string

Apenas saída. O nome do modelo da CPU. Exemplo: CPU Intel(R) Core(TM) i5-8250U a 1,60 GHz
architecture

enum (Architecture)

Apenas saída. Tipo de arquitetura da CPU.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política ReportDeviceCpuInfo.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
maxClockSpeed

integer

Apenas saída. A velocidade máxima do clock da CPU em kHz.
keylockerSupported

boolean

Apenas saída. Se o Key Locker é compatível.
keylockerConfigured

boolean

Apenas saída. Se o Key Locker está configurado.TRUE = ativado; FALSE = desativado. Só será informado se keylockerSupported = TRUE.

Arquitetura

Tipo de arquitetura da CPU.

Tipos enumerados
ARCHITECTURE_UNSPECIFIED Arquitetura desconhecida.
X64 Arquitetura x64

CpuStatusReport

Fornece informações sobre o status da CPU.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceCpuInfo.
  • Frequência de coleta de dados: a cada 10 minutos
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_CPU_REPORT
Representação JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que este relatório foi coletado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Apenas saída. Frequência com que o relatório é amostrado.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
cpuUtilizationPct

integer

Apenas saída. Exemplo de uso da CPU (0 a 100%).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Apenas saída. Informações de amostra de temperatura da CPU por núcleo em graus Celsius

CpuTemperatureInfo

Temperatura da CPU de um dispositivo. Amostrada por núcleo de CPU em graus Celsius.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceCpuInfo.
  • Frequência de coleta de dados: a cada 10 minutos
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
Representação JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
Campos
temperatureCelsius

integer

Apenas saída. Temperatura da CPU em graus Celsius.
label

string

Apenas saída. Marcador da CPU. Exemplo: Core 0

MemoryInfo

Informações de memória de um dispositivo.

  • Esse campo tem informações de telemetria e do dispositivo:
    • totalRamBytes - Informações do dispositivo
    • availableRamBytes: informações de telemetria
    • totalMemoryEncryption - Informações do dispositivo
  • Os dados desse campo são controlados pela política ReportDeviceMemoryInfo.
  • Frequência da coleta de dados:
    • totalRamBytes: somente no upload
    • availableRamBytes: a cada 10 minutos
    • totalMemoryEncryption: na inicialização do dispositivo
  • Frequência padrão de relatórios de dados:
    • totalRamBytes: 3 horas
    • availableRamBytes: 3 horas
    • totalMemoryEncryption: na inicialização do dispositivo
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line. Isso só vale para o totalMemoryEncryption.
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_MEMORY_INFO
Representação JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Campos
totalRamBytes

string (int64 format)

Apenas saída. Total da RAM em bytes.
availableRamBytes

string (int64 format)

Apenas saída. Quantidade de RAM disponível em bytes.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Apenas saída. Informações sobre a criptografia de memória total do dispositivo.

TotalMemoryEncryptionInfo

Informações de criptografia de memória de um dispositivo.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política ReportDeviceMemoryInfo.
  • Frequência de coleta de dados: na inicialização do dispositivo
  • Frequência padrão de relatórios de dados: na inicialização do dispositivo
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado apenas para usuários afiliados: N/A
Representação JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Campos
encryptionState

enum (MemoryEncryptionState)

O estado da criptografia de memória no dispositivo.
maxKeys

string (int64 format)

O número máximo de chaves que podem ser usadas para criptografia.
keyLength

string (int64 format)

O comprimento das chaves de criptografia.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Algoritmo de criptografia de memória.

MemoryEncryptionState

O estado da criptografia de memória no dispositivo.

Tipos enumerados
MEMORY_ENCRYPTION_STATE_UNSPECIFIED O estado da criptografia de memória não está definido.
MEMORY_ENCRYPTION_STATE_UNKNOWN O estado da criptografia de memória é desconhecido.
MEMORY_ENCRYPTION_STATE_DISABLED A criptografia de memória no dispositivo está desativada.
MEMORY_ENCRYPTION_STATE_TME A criptografia de memória no dispositivo usa a criptografia total de memória.
MEMORY_ENCRYPTION_STATE_MKTME A criptografia de memória no dispositivo usa a criptografia de memória total com várias chaves.

MemoryEncryptionAlgorithm

O algoritmo de criptografia usado no dispositivo.

Tipos enumerados
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED O algoritmo de criptografia de memória não está definido.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN O algoritmo de criptografia de memória em uso é desconhecido.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 O algoritmo de criptografia de memória usa o algoritmo de criptografia AES_XTS com uma cifra de bloco de 128 bits.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 O algoritmo de criptografia de memória usa o algoritmo de criptografia AES_XTS com uma cifra de bloco de 256 bits.

MemoryStatusReport

Contém exemplos de relatórios de status da memória.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceMemoryInfo.
  • Frequência de coleta de dados: somente no upload, SystemRamFreeByes é coletado a cada 10 minutos
  • Frequência padrão de relatórios de dados: a cada 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_MEMORY_REPORT
Representação JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Campos
reportTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que este relatório foi coletado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Apenas saída. Frequência com que o relatório é amostrado.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
systemRamFreeBytes

string (int64 format)

Apenas saída. Quantidade de RAM livre em bytes (não confiável devido à coleta de lixo).
pageFaults

integer

Apenas saída. Número de falhas de página durante esta coleta

NetworkInfo

Informações do dispositivo de rede.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política: ReportNetworkDeviceConfiguration
  • Frequência de coleta de dados: na inicialização do dispositivo
  • Frequência padrão de relatórios de dados: na inicialização do dispositivo
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_NETWORK_INFO
Representação JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Campos
networkDevices[]

object (NetworkDevice)

Apenas saída. Lista de dispositivos de rede.

NetworkDevice

Detalhes sobre o dispositivo de rede.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política: ReportNetworkDeviceConfiguration
  • Frequência de coleta de dados: na inicialização do dispositivo
  • Frequência padrão de relatórios de dados: na inicialização do dispositivo
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado apenas para usuários afiliados: N/A
Representação JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Campos
type

enum (NetworkDeviceType)

Apenas saída. Tipo de dispositivo de rede.
macAddress

string

Apenas saída. Endereço MAC (se aplicável) do dispositivo de rede correspondente.
meid

string

Apenas saída. MEID (se aplicável) do dispositivo de rede correspondente.
imei

string

Apenas saída. IMEI (se aplicável) do dispositivo de rede correspondente.
iccid

string

Apenas saída. O ID do cartão de circuito integrado associado ao chip do dispositivo.
mdn

string

Apenas saída. O número de diretório de dispositivo móvel associado ao chip do dispositivo.

NetworkDeviceType

Tipos de dispositivos de rede.

Tipos enumerados
NETWORK_DEVICE_TYPE_UNSPECIFIED O tipo de dispositivo de rede não foi especificado.
CELLULAR_DEVICE Aparelho celular.
ETHERNET_DEVICE Dispositivo Ethernet.
WIFI_DEVICE Dispositivo Wi-Fi.

NetworkStatusReport

Estado das redes visíveis/configuradas.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportNetworkStatus.
  • Frequência da coleta de dados: 60 minutos
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado somente para usuários afiliados: sim
  • Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação 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)

Apenas saída. Hora em que o estado da rede foi informado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Apenas saída. Frequência com que o relatório é amostrado.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
signalStrengthDbm

integer

Apenas saída. Intensidade do sinal de redes sem fio medida em decibéis.
lanIpAddress

string

Apenas saída. Endereço IP da LAN.
gatewayIpAddress

string

Apenas saída. Endereço IP do gateway.
transmissionBitRateMbps

string (int64 format)

Apenas saída. Taxa de bits de transmissão medida em megabits por segundo.
receivingBitRateMbps

string (int64 format)

Apenas saída. Taxa de bits de recebimento medida em megabits por segundo.
transmissionPowerDbm

integer

Apenas saída. Potência de transmissão medida em decibéis.
encryptionOn

boolean

Apenas saída. Se a chave de criptografia do Wi-Fi está desativada.
wifiPowerManagementEnabled

boolean

Apenas saída. Gerenciamento de energia do Wi-Fi ativado
guid

string

Apenas saída. Identificador globalmente exclusivo da conexão de rede.
connectionState

enum (NetworkConnectionState)

Apenas saída. Estado atual da conexão de rede.
connectionType

enum (NetworkType)

Apenas saída. Tipo de conexão de rede.
ipv6Address[]

string

Apenas saída. Endereços IPv6 atribuídos a esta rede, se houver. Cada endereço é uma string na representação de texto IPv6 padrão (por exemplo, "2001:db8::1").
gatewayIpv6Address

string

Apenas saída. O IPv6 do gateway para essa interface, se detectado
metered

boolean

Apenas saída. Se a rede foi detectada como tarifada.

NetworkType

Tipos de conexão de rede.

Tipos enumerados
NETWORK_TYPE_UNSPECIFIED O tipo de conexão de rede não foi especificado
CELLULAR Conexão de rede celular.
ETHERNET Conexão de rede Ethernet.
TETHER Conexão de rede Tether.
VPN Conexão de rede VPN.
WIFI Conexão de rede Wi-Fi.

NetworkDiagnosticsReport

Resultados de testes de rede para determinar a integridade da conexão de rede do dispositivo, por exemplo, se a latência HTTPS está alta ou normal.

  • Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Campos
reportTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora em que os diagnósticos foram coletados.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

Apenas saída. Dados de teste de latência HTTPS.

OsUpdateStatus

Contém informações sobre o status atual da atualização do SO.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceOsUpdateStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_OS_REPORT
Representação JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Campos
updateState

enum (UpdateState)

Apenas saída. Estado atual da atualização do SO.
newPlatformVersion

string

Apenas saída. Nova versão da plataforma da imagem do SO sendo baixada e aplicada. Ele só é definido quando o status da atualização é OS_IMAGE_DOWNLOAD_IN_PROGRESS ou OS_UPDATE_NEED_REBOOT. Observe que isso pode ser um "0.0.0.0" fictício para o status OS_UPDATE_NEED_REBOOT em alguns casos extremos, por exemplo, quando o mecanismo de atualização é reiniciado sem uma reinicialização.
newRequestedPlatformVersion

string

Apenas saída. Nova versão da plataforma solicitada do aplicativo de quiosque atualizado pendente.
lastUpdateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última atualização bem-sucedida.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última verificação de atualização.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última reinicialização.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

UpdateState

Estado da atualização do SO

Tipos enumerados
UPDATE_STATE_UNSPECIFIED Estado não especificado.
OS_IMAGE_DOWNLOAD_NOT_STARTED O download do SO não foi iniciado.
OS_IMAGE_DOWNLOAD_IN_PROGRESS O SO começou o download no dispositivo.
OS_UPDATE_NEED_REBOOT O dispositivo precisa ser reiniciado para concluir o upload.

GraphicsInfo

Informações do subsistema de gráficos.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política: ReportDeviceGraphicsStatus
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_GRAPHICS_INFO
Representação JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Campos
adapterInfo

object (GraphicsAdapterInfo)

Apenas saída. Informações sobre o adaptador gráfico (GPU).
eprivacySupported

boolean

Apenas saída. Se a tela de privacidade eletrônica tem suporte ou não.
displayDevices[]

object (DisplayDevice)

Apenas saída. Informações sobre as telas do dispositivo.
touchScreenInfo

object (TouchScreenInfo)

Apenas saída. Informações sobre as telas sensíveis ao toque internas do dispositivo.

GraphicsAdapterInfo

Informações de um adaptador de gráficos (GPU).

Representação JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Campos
adapter

string

Apenas saída. Nome do adaptador. Exemplo: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

Apenas saída. Versão do driver da GPU.
deviceId

string (int64 format)

Apenas saída. Representa o ID do dispositivo da placa de vídeo.

DisplayDevice

Informações de um dispositivo de exibição.

Representação JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
displayName

string

Apenas saída. Mostrar o nome do dispositivo.
displayWidthMm

integer

Apenas saída. Largura da tela em milímetros.
displayHeightMm

integer

Apenas saída. Altura da tela em milímetros.
internal

boolean

Apenas saída. Indica se a tela é interna ou não.
manufacturerId

string

Apenas saída. ID do fabricante de três letras.
modelId

integer

Apenas saída. Código do produto do fabricante.
manufactureYear

integer

Apenas saída. Ano de fabricação.
serialNumber

integer

Apenas saída. Número de série.
edidVersion

string

Apenas saída. Versão do EDID.

TouchScreenInfo

Informações sobre a tela sensível ao toque do dispositivo.

Representação JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Campos
touchpadLibrary

string

Apenas saída. Nome da biblioteca do touchpad usado pela pilha de entrada.
devices[]

object (TouchScreenDevice)

Apenas saída. Lista dos dispositivos internos com tela touchscreen.

TouchScreenDevice

Informações de um dispositivo de tela sensível ao toque interno.

Representação JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Campos
displayName

string

Apenas saída. Nome de exibição do dispositivo com touch screen.
touchPointCount

integer

Apenas saída. Número de pontos de toque aceitos no dispositivo.
stylusCapable

boolean

Apenas saída. Se o dispositivo com touch screen é compatível com caneta stylus ou não.

GraphicsStatusReport

Informações do subsistema de gráficos.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política: ReportDeviceGraphicsInfo
  • Frequência da coleta de dados: 3 horas.
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_GRAPHICS_REPORT
Representação JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Apenas saída. O horário em que os dados gráficos foram informados.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

Apenas saída. Informações sobre as telas do dispositivo.

DisplayInfo

Informações para uma tela.

Representação JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
deviceId

string (int64 format)

Apenas saída. Representa o ID do dispositivo da placa de vídeo.
resolutionWidth

integer

Apenas saída. Largura da resolução em pixels.
resolutionHeight

integer

Apenas saída. Altura da resolução em pixels.
refreshRate

integer

Apenas saída. Taxa de atualização em Hz.
isInternal

boolean

Apenas saída. Indica se a tela é interna ou não.
displayName

string

Apenas saída. Mostrar o nome do dispositivo.
serialNumber

integer

Apenas saída. Número de série.
edidVersion

string

Apenas saída. Versão do EDID.

BatteryInfo

Informações sobre a bateria.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política ReportDevicePowerStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_BATTERY_INFO
Representação JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Campos
serialNumber

string

Apenas saída. Número de série da bateria.
manufacturer

string

Apenas saída. Fabricante da bateria.
designCapacity

string (int64 format)

Apenas saída. Capacidade de design (mA-h).
designMinVoltage

integer

Apenas saída. Tensão mínima de saída (mV) projetada
manufactureDate

object (Date)

Apenas saída. A data de fabricação da bateria.
technology

string

Apenas saída. Tecnologia da bateria. Exemplo: Li-ion

BatteryStatusReport

Dados de status da bateria.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDevicePowerStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_BATTERY_REPORT
Representação JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Campos
reportTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
serialNumber

string

Apenas saída. Número de série da bateria.
sample[]

object (BatterySampleReport)

Apenas saída. Dados de amostragem da bateria classificados em ordem decrescente de reportTime.
batteryHealth

enum (BatteryHealth)

Apenas saída. Integridade da bateria.
fullChargeCapacity

string (int64 format)

Apenas saída. Capacidade de carga total (mA-h).
cycleCount

integer

Apenas saída. Contagem de ciclos.

BatterySampleReport

Amostrando dados da bateria.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDevicePowerStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
Representação JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Campos
reportTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

Apenas saída. Tensão da bateria (milivolt).
remainingCapacity

string (int64 format)

Apenas saída. Capacidade restante da bateria (mA-h).
temperature

integer

Apenas saída. Temperatura em graus Celsius.
dischargeRate

integer

Apenas saída. A taxa de descarga da bateria medida em mW. Positivo se a bateria estiver sendo descarregada, negativo se estiver sendo carregada.
chargeRate

integer

Apenas saída. Porcentagem da carga da bateria.
current

string (int64 format)

Apenas saída. Corrente da bateria (mA).
status

string

Apenas saída. O status da bateria é lido do sysfs. Exemplo: descarregando

BatteryHealth

Representa a integridade atual da bateria.

  • Esse status não é um indicador ou a indicação de uma bateria com defeito. Ele é calculado dividindo a capacidade de carga total atual pela capacidade de projeto.
  • É responsabilidade do fabricante definir a integridade da bateria e a política de garantia.
Tipos enumerados
BATTERY_HEALTH_UNSPECIFIED Integridade desconhecida.
BATTERY_HEALTH_NORMAL A bateria está em boas condições, capacidade de carga total / capacidade de projeto > 80%
BATTERY_REPLACE_SOON A bateria está moderadamente danificada e precisa ser substituída em breve. Capacidade de carga total / capacidade de projeto de 75% a 80%
BATTERY_REPLACE_NOW A bateria não está em boas condições e precisa ser substituída. A capacidade total de carga / capacidade de projeto é inferior a 75%.

StorageInfo

Dados de status para armazenamento.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceStorageStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_STORAGE_INFO
Representação JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Campos
volume[]

object (DiskVolume)

Informações sobre volumes de disco
availableDiskBytes

string (int64 format)

O espaço disponível para armazenamento de dados do usuário no dispositivo em bytes.
totalDiskBytes

string (int64 format)

O espaço total para armazenamento de dados do usuário no dispositivo, em bytes.

DiskVolume

Informações sobre volumes de disco

Representação JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Campos
volumeId

string

ID do volume do disco.
storageFreeBytes

string (int64 format)

Espaço de armazenamento livre em bytes.
storageTotalBytes

string (int64 format)

Espaço de armazenamento total em bytes.

StorageStatusReport

Dados de status para armazenamento.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceStorageStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_STORAGE_REPORT
Representação JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Campos
reportTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

Apenas saída. Relatórios no disco.

DiskInfo

Status do dispositivo de armazenamento único.

Representação 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

Apenas saída. Número de série do disco.
manufacturer

string

Apenas saída. Fabricante do disco.
model

string

Apenas saída. Modelo do disco.
sizeBytes

string (int64 format)

Apenas saída. Tamanho do disco
type

string

Apenas saída. Tipo de disco: eMMC / NVMe / ATA / SCSI.
health

string

Apenas saída. Integridade do disco.
volumeIds[]

string

Apenas saída. Volumes de disco.
bytesReadThisSession

string (int64 format)

Apenas saída. Número de bytes lidos desde a última inicialização.
bytesWrittenThisSession

string (int64 format)

Apenas saída. Número de bytes gravados desde a última inicialização.
readTimeThisSession

string (Duration format)

Apenas saída. Tempo gasto lendo do disco desde a última inicialização.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
writeTimeThisSession

string (Duration format)

Apenas saída. Tempo gasto gravando no disco desde a última inicialização.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
ioTimeThisSession

string (Duration format)

Apenas saída. Conta o tempo em que o disco e a fila estavam ocupados. Portanto, ao contrário dos campos acima, as solicitações paralelas não são contadas várias vezes.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
discardTimeThisSession

string (Duration format)

Apenas saída. Tempo gasto descartando desde a última inicialização. O descarte grava em blocos limpos que não estão mais em uso. Compatível com kernels 4.18 ou mais recentes.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

ThunderboltInfo

Informações sobre o ônibus Thunderbolt.

  • Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
  • Os dados desse campo são controlados pela política ReportDeviceSecurityStatus.
  • Frequência de coleta de dados: na inicialização do dispositivo
  • Frequência padrão de relatórios de dados: na inicialização do dispositivo
    • Controlado por política: não
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_BUS_DEVICE_INFO
Representação JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Campos
securityLevel

enum (ThunderboltSecurityLevel)

Nível de segurança do barramento Thunderbolt.

ThunderboltSecurityLevel

Nível de segurança do barramento Thunderbolt.

Tipos enumerados
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED O nível de segurança do Thunderbolt não está definido.
THUNDERBOLT_SECURITY_NONE_LEVEL Todos os dispositivos são conectados automaticamente pelo firmware. Não é necessária aprovação do usuário.
THUNDERBOLT_SECURITY_USER_LEVEL O usuário é questionado se o dispositivo pode ser conectado.
THUNDERBOLT_SECURITY_SECURE_LEVEL O usuário é questionado se o dispositivo pode ser conectado. Além disso, o dispositivo recebe um desafio que precisa corresponder ao esperado com base em uma chave aleatória gravada no atributo sysfs da chave.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL O firmware cria automaticamente túneis para Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL O firmware cria automaticamente túneis para o controlador USB e a porta de exibição em um dock. Todos os links PCIe downstream do dock são removidos.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL O encapsulamento de PCIE está desativado.

BootPerformanceReport

Relatório de desempenho de inicialização de um dispositivo.

  • Esse campo contém informações de telemetria e muda com o tempo à medida que o dispositivo é usado.
  • Os dados desse campo são controlados pela política ReportDeviceBootMode.
  • Frequência da coleta de dados: em todos os eventos de inicialização
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: sim
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_OS_REPORT
Representação JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Campos
bootUpDuration

string (Duration format)

Tempo total de inicialização.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
bootUpTime

string (Timestamp format)

O carimbo de data/hora de quando a energia foi ligada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

Tempo total desde o início do desligamento até o desligamento.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
shutdownTime

string (Timestamp format)

O carimbo de data/hora do desligamento.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

O motivo do desligamento.
reportTime

string (Timestamp format)

Carimbo de data/hora em que o relatório foi coletado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ShutdownReason

O motivo do desligamento.

Tipos enumerados
SHUTDOWN_REASON_UNSPECIFIED O motivo do desligamento não foi especificado.
USER_REQUEST Iniciado pelo usuário.
SYSTEM_UPDATE Atualização do sistema iniciada.
LOW_BATTERY Desligamento devido à bateria fraca.
OTHER Desligamento por outros motivos.

HeartbeatStatusReport

Relatório de status de sinal de funcionamento de um dispositivo.

  • Disponível para quiosques
  • Esse campo fornece o status on-line/off-line/desconhecido de um dispositivo e só será incluído se o status tiver mudado (por exemplo, de on-line para off-line).
  • Os dados desse campo são controlados pela política: HeartbeatEnabled Mais informações
  • Frequência de pulsação: 2 minutos
    • Observação: quando um dispositivo fica off-line, pode levar até 12 minutos para que o status on-line dele seja atualizado.
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: N/A
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Representação JSON 
{
  "reportTime": string,
  "state": enum (State)
}
Campos
reportTime

string (Timestamp format)

Carimbo de data/hora de quando a mudança de status foi detectada

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Estado para o qual o dispositivo mudou

Estado

O estado do dispositivo

Tipos enumerados
STATE_UNSPECIFIED Estado não especificado
UNKNOWN O dispositivo não está qualificado para o monitoramento de sinal de funcionamento
ONLINE O dispositivo está on-line
OFFLINE O dispositivo está off-line
DEVICE_OUTDATED O dispositivo está desatualizado

KioskAppStatusReport

Relatório de status do aplicativo de quiosque de um dispositivo.

  • Disponível para quiosques
  • Esse campo fornece o ID do app e o número da versão em execução em um dispositivo de quiosque, além do carimbo de data/hora da última atualização do relatório.
  • Os dados desse campo são controlados pela política ReportDeviceSessionStatus.
  • Frequência de coleta de dados: somente no upload
  • Frequência padrão de relatórios de dados: 3 horas
    • Controlado por política: sim
  • Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados na próxima vez que o dispositivo ficar on-line: Não
  • Informado apenas para usuários afiliados: N/A
  • Permissão granular necessária: TELEMETRY_API_APPS_REPORT
Representação JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Campos
reportTime

string (Timestamp format)

Carimbo de data/hora de quando o relatório foi coletado

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
appId

string

ID do aplicativo de quiosque, por exemplo, "mdmkkicfmmkgmpkmkdikhlbggogpicma"
appVersion

string

Número da versão do aplicativo de quiosque, por exemplo, "1.10.118"

RuntimeCountersReport

Contadores de tempo de execução recuperados da CPU. No momento, a telemetria dos contadores de tempo de execução só é compatível com o Intel vPro PSR na 14ª geração ou mais recente.

Representação JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Campos
reportTime

string (Timestamp format)

Carimbo de data/hora em que o relatório foi coletado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Tempo de execução total no ciclo de vida. Atualmente, sempre o tempo de execução S0 do Intel vPro PSR.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
enterSleepCount

string (int64 format)

Número de vezes que o dispositivo entrou no estado de espera. Atualmente obtido via PSR, contagem de S0->S3.
enterHibernationCount

string (int64 format)

Número de vezes que o dispositivo entrou em estado de hibernação. Atualmente obtido via PSR, contagem de S0 -> S4.
enterPoweroffCount

string (int64 format)

Número de vezes que o dispositivo entrou no estado desligado. Atualmente obtido via PSR, contagem de S0->S5.

Métodos

get

 Recebe o dispositivo de telemetria.

list

 Liste todos os dispositivos de telemetria.