- Recurso: TelemetryDevice
- CpuInfo
- Arquitetura
- CpuStatusReport
- CpuTemperatureInfo
- MemoryInfo
- TotalMemoryEncryptionInfo
- MemoryEncryptionState
- MemoryEncryptionAlgorithm
- MemoryStatusReport
- NetworkInfo
- NetworkDevice
- NetworkDeviceType
- NetworkStatusReport
- NetworkType
- NetworkDiagnosticsReport
- OsUpdateStatus
- UpdateState
- GraphicsInfo
- GraphicsAdapterInfo
- DisplayDevice
- TouchScreenInfo
- TouchScreenDevice
- GraphicsStatusReport
- DisplayInfo
- BatteryInfo
- BatteryStatusReport
- BatterySampleReport
- BatteryHealth
- StorageInfo
- DiskVolume
- StorageStatusReport
- DiskInfo
- ThunderboltInfo
- ThunderboltSecurityLevel
- BootPerformanceReport
- ShutdownReason
- HeartbeatStatusReport
- Estado
- KioskAppStatusReport
- RuntimeCountersReport
- Métodos
Recurso: TelemetryDevice
Dados de telemetria coletados em 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 ( |
Campos | |
---|---|
name |
Apenas saída. Nome do recurso do dispositivo. |
customer |
Apenas saída. Cliente do Google Workspace que registrou o dispositivo na empresa. |
orgUnitId |
Apenas saída. ID da unidade organizacional do dispositivo. |
deviceId |
Apenas saída. O ID exclusivo da API Directory do dispositivo. Esse valor é o mesmo do ID da API Directory do Admin Console na guia "Dispositivos ChromeOS". |
serialNumber |
Apenas saída. Número de série do dispositivo. Esse valor é igual ao número de série do Admin Console na guia "Dispositivos ChromeOS". |
cpuInfo[] |
Apenas saída. Informações sobre as especificações de CPU do dispositivo. |
cpuStatusReport[] |
Apenas saída. Relatórios de status da CPU coletados periodicamente e classificados em ordem decrescente de |
memoryInfo |
Apenas saída. Informações sobre as especificações de memória do dispositivo. |
memoryStatusReport[] |
Apenas saída. Relatórios de status de memória coletados periodicamente, classificados em ordem decrescente por |
networkInfo |
Apenas saída. Informações sobre os dispositivos de rede. |
networkStatusReport[] |
Apenas saída. Especificações de rede coletadas periodicamente. |
networkDiagnosticsReport[] |
Apenas saída. Diagnósticos de rede coletados periodicamente. |
osUpdateStatus[] |
Apenas saída. Contém informações relevantes sobre o status da atualização do ChromeOS. |
graphicsInfo |
Apenas saída. Contém informações sobre periféricos gráficos para o dispositivo. |
graphicsStatusReport[] |
Apenas saída. Relatórios gráficos coletados periodicamente. |
batteryInfo[] |
Apenas saída. Informações sobre as especificações da bateria do dispositivo. |
batteryStatusReport[] |
Apenas saída. Relatórios de bateria coletados periodicamente. |
storageInfo |
Apenas saída. Informações sobre as especificações de armazenamento do dispositivo. |
storageStatusReport[] |
Apenas saída. Relatórios de armazenamento coletados periodicamente. |
thunderboltInfo[] |
Apenas saída. Informações sobre o barramento Thunderbolt. |
audioStatusReport[] |
Apenas saída. Relatórios de áudio coletados periodicamente e classificados em ordem decrescente de |
bootPerformanceReport[] |
Apenas saída. Relatórios de desempenho de inicialização do dispositivo. |
heartbeatStatusReport[] |
Apenas saída. Relatório de status de batimento cardíaco com carimbos de data/hora classificados periodicamente em ordem decrescente de |
kioskAppStatusReport[] |
Apenas saída. Relatório de status do app quiosque para o dispositivo de quiosque |
networkBandwidthReport[] |
Apenas saída. Relatórios de largura de banda da rede coletados periodicamente e classificados em ordem decrescente de |
peripheralsReport[] |
Apenas saída. Relatórios de periféricos coletados periodicamente, classificados em ordem decrescente de |
appReport[] |
Apenas saída. Relatórios de app coletados periodicamente e classificados em ordem decrescente de |
runtimeCountersReport[] |
Apenas saída. Os contadores de tempo de execução coletam o tempo de execução do dispositivo e as contagens de transições S0->S3, S0->S4 e S0->S5, ou seja, a entrada nos 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
model |
Apenas saída. O nome do modelo da CPU. Exemplo: CPU Intel(R) Core(TM) i5-8250U a 1,60 GHz |
architecture |
Apenas saída. Tipo de arquitetura da CPU.
|
maxClockSpeed |
Apenas saída. A velocidade máxima do clock da CPU em kHz. |
keylockerSupported |
Apenas saída. Se o Key Locker é compatível. |
keylockerConfigured |
Apenas saída. Se o Key Locker está configurado. |
Arquitetura
Tipo de arquitetura da CPU.
Enums | |
---|---|
ARCHITECTURE_UNSPECIFIED |
Arquitetura desconhecida. |
X64 |
Arquitetura x64 |
CpuStatusReport
Fornece informações sobre o status da CPU.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
reportTime |
Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que esse relatório foi amostrado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
sampleFrequency |
Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " |
cpuUtilizationPct |
Apenas saída. Exemplo de utilização da CPU (0 a 100%). |
cpuTemperatureInfo[] |
Apenas saída. Informações de amostra da temperatura da CPU por núcleo em graus Celsius |
CpuTemperatureInfo
Temperatura da CPU de um dispositivo. Amostras coletadas por núcleo da CPU em graus Celsius.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
Representação JSON |
---|
{ "temperatureCelsius": integer, "label": string } |
Campos | |
---|---|
temperatureCelsius |
Apenas saída. Temperatura da CPU em graus Celsius. |
label |
Apenas saída. Rótulo da CPU. Exemplo: núcleo 0 |
MemoryInfo
Informações de memória de um dispositivo.
- Esse campo tem informações de telemetria e do dispositivo:
totalRamBytes
: informações do dispositivoavailableRamBytes
: informações de telemetriatotalMemoryEncryption
: informações do dispositivo
- Os dados desse campo são controlados pela política: ReportDeviceMemoryInfo.
- Frequência da coleta de dados:
totalRamBytes
: somente no uploadavailableRamBytes
: a cada 10 minutostotalMemoryEncryption
: na inicialização do dispositivo
- Frequência padrão de relatórios de dados:
totalRamBytes
a 3 horasavailableRamBytes
a 3 horastotalMemoryEncryption
: na inicialização do dispositivo- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: somente para
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 ( |
Campos | |
---|---|
totalRamBytes |
Apenas saída. RAM total em bytes. |
availableRamBytes |
Apenas saída. Quantidade de RAM disponível em bytes. |
totalMemoryEncryption |
Apenas saída. Informações completas sobre a criptografia de memória 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
Representação JSON |
---|
{ "encryptionState": enum ( |
Campos | |
---|---|
encryptionState |
O estado da criptografia de memória no dispositivo. |
maxKeys |
O número máximo de chaves que podem ser usadas para criptografia. |
keyLength |
O comprimento das chaves de criptografia. |
encryptionAlgorithm |
Algoritmo de criptografia de memória. |
MemoryEncryptionState
O estado da criptografia de memória no dispositivo.
Enums | |
---|---|
MEMORY_ENCRYPTION_STATE_UNSPECIFIED |
O estado da criptografia de memória não foi 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 total de memória com várias chaves. |
MemoryEncryptionAlgorithm
O algoritmo de criptografia usado no dispositivo.
Enums | |
---|---|
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED |
O algoritmo de criptografia de memória não foi 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 da 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 da memória usa o algoritmo de criptografia AES_XTS com uma cifra de bloco de 256 bits. |
MemoryStatusReport
Contém amostras de relatórios de status da memória.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceMemoryInfo.
- Frequência de coleta de dados: somente no upload, o SystemRamFreeByes é coletado a cada 10 minutos
- Frequência padrão de relatórios de dados: a cada 3 horas
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 |
Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que esse relatório foi amostrado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
sampleFrequency |
Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " |
systemRamFreeBytes |
Apenas saída. Quantidade de RAM livre em bytes (não confiável devido à coleta de lixo). |
pageFaults |
Apenas saída. Número de falhas de página durante essa 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver 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 ( |
Campos | |
---|---|
networkDevices[] |
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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
Representação JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Apenas saída. Tipo de dispositivo de rede. |
macAddress |
Apenas saída. Endereço MAC (se aplicável) do dispositivo de rede correspondente. |
meid |
Apenas saída. MEID (se aplicável) do dispositivo de rede correspondente. |
imei |
Apenas saída. IMEI (se aplicável) do dispositivo de rede correspondente. |
iccid |
Apenas saída. O ID do cartão de circuito integrado associado ao chip do dispositivo. |
mdn |
Apenas saída. O número de diretório de dispositivo móvel associado ao chip do dispositivo. |
NetworkDeviceType
Tipos de dispositivos de rede.
Enums | |
---|---|
NETWORK_DEVICE_TYPE_UNSPECIFIED |
O tipo de dispositivo de rede não foi especificado. |
CELLULAR_DEVICE |
Dispositivo celular. |
ETHERNET_DEVICE |
Dispositivo Ethernet. |
WIFI_DEVICE |
Dispositivo Wi-Fi. |
NetworkStatusReport
Estado das redes visíveis/configuradas.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas 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 ( |
Campos | |
---|---|
reportTime |
Apenas saída. Hora em que o estado da rede foi informado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
sampleFrequency |
Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " |
signalStrengthDbm |
Apenas saída. Intensidade do sinal de redes sem fio medida em decibéis. |
lanIpAddress |
Apenas saída. Endereço IP da LAN. |
gatewayIpAddress |
Apenas saída. Endereço IP do gateway. |
transmissionBitRateMbps |
Apenas saída. Taxa de bits de transmissão medida em megabits por segundo. |
receivingBitRateMbps |
Apenas saída. Taxa de bits de recebimento medida em megabits por segundo. |
transmissionPowerDbm |
Apenas saída. Potência de transmissão medida em decibéis. |
encryptionOn |
Apenas saída. Indica se a chave de criptografia do Wi-Fi está desativada. |
wifiLinkQuality |
Apenas saída. Qualidade da conexão de Wi-Fi. O valor varia de [0, 70]. 0 indica ausência de sinal e 70 indica um sinal forte. |
wifiPowerManagementEnabled |
Apenas saída. Gerenciamento de energia do Wi-Fi ativado |
guid |
Apenas saída. GUID da conexão de rede. |
connectionState |
Apenas saída. Estado atual da conexão da rede. |
connectionType |
Apenas saída. Tipo de conexão de rede. |
NetworkType
Tipos de conexão de rede.
Enums | |
---|---|
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 é alta ou normal.
- Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação JSON |
---|
{
"reportTime": string,
"httpsLatencyData": {
object ( |
Campos | |
---|---|
reportTime |
Apenas saída. Carimbo de data/hora de quando os diagnósticos foram coletados. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
httpsLatencyData |
Apenas saída. Dados de teste de latência do HTTPS. |
OsUpdateStatus
Contém informações sobre o status atual da atualização do SO.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_OS_REPORT
Representação JSON |
---|
{
"updateState": enum ( |
Campos | |
---|---|
updateState |
Apenas saída. Estado atual da atualização do SO. |
newPlatformVersion |
Apenas saída. Nova versão da plataforma da imagem do SO sendo baixada e aplicada. Ele só é definido quando o status de atualização é OS_IMAGE_DOWNLOAD_IN_PROGRESS ou OS_UPDATE_NEED_REBOOT. 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 |
Apenas saída. Nova versão da plataforma solicitada do app do quiosque atualizado pendente. |
lastUpdateTime |
Apenas saída. Carimbo de data/hora da última atualização bem-sucedida. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
lastUpdateCheckTime |
Apenas saída. Carimbo de data/hora da última verificação de atualização. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
lastRebootTime |
Apenas saída. Carimbo de data/hora da última reinicialização. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
UpdateState
Estado da atualização do SO
Enums | |
---|---|
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 a fazer o download no dispositivo. |
OS_UPDATE_NEED_REBOOT |
O dispositivo precisa ser reiniciado para concluir o upload. |
GraphicsInfo
Informações do subsistema gráfico.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_GRAPHICS_INFO
Representação JSON |
---|
{ "adapterInfo": { object ( |
Campos | |
---|---|
adapterInfo |
Apenas saída. Informações sobre o adaptador gráfico (GPU). |
eprivacySupported |
Apenas saída. Indica se a tela de privacidade eletrônica tem suporte ou não. |
displayDevices[] |
Apenas saída. Informações sobre as telas do dispositivo. |
touchScreenInfo |
Apenas saída. Informações sobre as telas touch internas do dispositivo. |
GraphicsAdapterInfo
Informações de um adaptador gráfico (GPU).
Representação JSON |
---|
{ "adapter": string, "driverVersion": string, "deviceId": string } |
Campos | |
---|---|
adapter |
Apenas saída. Nome do adaptador. Exemplo: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2). |
driverVersion |
Apenas saída. Versão do driver da GPU. |
deviceId |
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 } |
Campos | |
---|---|
displayName |
Apenas saída. Nome do dispositivo de exibição. |
displayWidthMm |
Apenas saída. Largura da tela em milímetros. |
displayHeightMm |
Apenas saída. Altura da tela em milímetros. |
internal |
Apenas saída. A tela é interna ou não. |
manufacturerId |
Apenas saída. ID do fabricante com três letras. |
modelId |
Apenas saída. Código do produto do fabricante. |
manufactureYear |
Apenas saída. Ano de fabricação. |
TouchScreenInfo
Informações na tela de toque do dispositivo.
Representação JSON |
---|
{
"touchpadLibrary": string,
"devices": [
{
object ( |
Campos | |
---|---|
touchpadLibrary |
Apenas saída. Nome da biblioteca do touchpad usada pela pilha de entrada. |
devices[] |
Apenas saída. Lista dos dispositivos de tela touchscreen internos. |
TouchScreenDevice
Informações de um dispositivo de tela touch interno.
Representação JSON |
---|
{ "displayName": string, "touchPointCount": integer, "stylusCapable": boolean } |
Campos | |
---|---|
displayName |
Apenas saída. Nome de exibição do dispositivo com tela touch. |
touchPointCount |
Apenas saída. Número de pontos de toque compatíveis com o dispositivo. |
stylusCapable |
Apenas saída. O dispositivo com tela touch é compatível com stylus ou não. |
GraphicsStatusReport
Informações do subsistema gráfico.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
reportTime |
Apenas saída. Hora em que os dados gráficos foram informados. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
displays[] |
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 } |
Campos | |
---|---|
deviceId |
Apenas saída. Representa o ID do dispositivo da placa de vídeo. |
resolutionWidth |
Apenas saída. Largura da resolução em pixels. |
resolutionHeight |
Apenas saída. Altura da resolução em pixels. |
refreshRate |
Apenas saída. Taxa de atualização em Hz. |
isInternal |
Apenas saída. Indica se a tela é interna ou não. |
displayName |
Apenas saída. Nome do dispositivo de exibição. |
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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
serialNumber |
Apenas saída. Número de série da bateria. |
manufacturer |
Apenas saída. Fabricante da bateria. |
designCapacity |
Apenas saída. Capacidade de design (mA-h). |
designMinVoltage |
Apenas saída. Tensão mínima de saída (mV) projetada |
manufactureDate |
Apenas saída. A data de fabricação da bateria. |
technology |
Apenas saída. Tecnologia da bateria. Exemplo: Li-ion |
BatteryStatusReport
Dados de status da bateria.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
reportTime |
Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
serialNumber |
Apenas saída. Número de série da bateria. |
sample[] |
Apenas saída. Dados de amostra da bateria classificados em ordem decrescente de |
batteryHealth |
Apenas saída. Integridade da bateria. |
fullChargeCapacity |
Apenas saída. Capacidade de carga total (mA-h). |
cycleCount |
Apenas saída. Contagem de ciclos. |
BatterySampleReport
Amostragem de dados de bateria.
- Esse campo contém informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 |
Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
voltage |
Apenas saída. Tensão da bateria (milivolt). |
remainingCapacity |
Apenas saída. Capacidade restante da bateria (mA-h). |
temperature |
Apenas saída. Temperatura em graus Celsius. |
dischargeRate |
Apenas saída. Taxa de descarga da bateria medida em mW. Positivo se a bateria estiver sendo descarregada, negativo se estiver sendo carregada. |
chargeRate |
Apenas saída. Porcentagem de carga da bateria. |
current |
Apenas saída. Corrente da bateria (mA). |
status |
Apenas saída. O status da bateria é lido do sysfs. Exemplo: descarregar |
BatteryHealth
Representa a integridade atual da bateria.
- Esse status não é um indicador ou a indicação de uma bateria com defeito. Ela é calculada dividindo a capacidade de carga total atual pela capacidade de projeto.
- Cabe ao fabricante definir a integridade da bateria e a política de garantia.
Enums | |
---|---|
BATTERY_HEALTH_UNSPECIFIED |
Integridade desconhecida. |
BATTERY_HEALTH_NORMAL |
A bateria está em bom estado, a capacidade de carga total / capacidade de projeto é maior que 80% |
BATTERY_REPLACE_SOON |
A bateria está moderadamente inadequada e deve ser substituída em breve. A capacidade de carga total / capacidade de projeto é de 75% a 80%. |
BATTERY_REPLACE_NOW |
A bateria está com problemas e precisa ser substituída. A capacidade de carga total / capacidade de projeto é < 75% |
StorageInfo
Dados de status para armazenamento.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_STORAGE_INFO
Representação JSON |
---|
{
"volume": [
{
object ( |
Campos | |
---|---|
volume[] |
Informações sobre volumes de disco |
availableDiskBytes |
O espaço disponível para armazenamento de dados do usuário no dispositivo em bytes. |
totalDiskBytes |
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 |
ID do volume do disco. |
storageFreeBytes |
Espaço de armazenamento livre em bytes. |
storageTotalBytes |
Espaço de armazenamento total em bytes. |
StorageStatusReport
Dados de status para armazenamento.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 ( |
Campos | |
---|---|
reportTime |
Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
disk[] |
Apenas saída. Relatórios no disco. |
DiskInfo
Status do único dispositivo de armazenamento.
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 |
Apenas saída. Número de série do disco. |
manufacturer |
Apenas saída. Fabricante do disco. |
model |
Apenas saída. Modelo do disco. |
sizeBytes |
Apenas saída. Tamanho do disco |
type |
Apenas saída. Tipo de disco: eMMC / NVMe / ATA / SCSI. |
health |
Apenas saída. Integridade do disco. |
volumeIds[] |
Apenas saída. Volumes de disco. |
bytesReadThisSession |
Apenas saída. Número de bytes lidos desde a última inicialização. |
bytesWrittenThisSession |
Apenas saída. Número de bytes gravados desde a última inicialização. |
readTimeThisSession |
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 " |
writeTimeThisSession |
Apenas saída. Tempo gasto em gravações no disco desde a última inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " |
ioTimeThisSession |
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 " |
discardTimeThisSession |
Apenas saída. Tempo gasto com descarte desde a última inicialização. O descarte é a gravação em blocos claros que não estão mais em uso. Com suporte em kernels 4.18 e mais recentes. Duração em segundos com até nove dígitos fracionários, terminando em " |
ThunderboltInfo
Informações do barramento 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
- Controle de políticas: não
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver 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 ( |
Campos | |
---|---|
securityLevel |
Nível de segurança do barramento Thunderbolt. |
ThunderboltSecurityLevel
Nível de segurança do barramento Thunderbolt.
Enums | |
---|---|
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 a 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 túneis automaticamente para o Thunderbolt. |
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL |
O firmware cria túneis automaticamente para o controlador USB e a porta de exibição em uma base. Todos os links PCIe downstream da base 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 é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceBootMode
- Frequência de coleta de dados: em todos os eventos de inicialização
- Frequência padrão de relatórios de dados: 3 horas
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver 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 ( |
Campos | |
---|---|
bootUpDuration |
Tempo total de inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " |
bootUpTime |
O carimbo de data/hora da última vez que a energia foi ligada. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
shutdownDuration |
Tempo total desde o início da interrupção até a desativação. Duração em segundos com até nove dígitos fracionários, terminando em " |
shutdownTime |
O carimbo de data/hora do desligamento. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
shutdownReason |
O motivo do desligamento. |
reportTime |
Carimbo de data/hora em que o relatório foi coletado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
ShutdownReason
O motivo do desligamento.
Enums | |
---|---|
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, "On-line" para "Off-line").
- Os dados desse campo são controlados pela política: HeartbeatEnabled Mais informações
- Frequência de batimentos: 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 quando o dispositivo estiver 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 ( |
Campos | |
---|---|
reportTime |
Carimbo de data/hora em que a mudança de status foi detectada Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
state |
Estado para o qual o dispositivo mudou |
Estado
O estado do dispositivo
Enums | |
---|---|
STATE_UNSPECIFIED |
Estado não especificado |
UNKNOWN |
O dispositivo não está qualificado para monitoramento de batimentos |
ONLINE |
O dispositivo está on-line |
OFFLINE |
O dispositivo está off-line |
DEVICE_OUTDATED |
O dispositivo está desatualizado |
KioskAppStatusReport
Relatório de status do app de quiosque de um dispositivo.
- Disponível para quiosques
- Esse campo fornece o ID e o número da versão do app em execução em um dispositivo de quiosque e o 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
- Controle de políticas: sim
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: 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 |
Carimbo de data/hora de quando o relatório foi coletado Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
appId |
ID do app de quiosque, por exemplo, "mdmkkicfmmkgmpkmkdikhlbggogpicma" |
appVersion |
Número da versão do app de quiosque, por exemplo, "1.10.118" |
RuntimeCountersReport
Contadores de execução recuperados da CPU. No momento, a telemetria dos contadores de tempo de execução tem suporte apenas para o Intel vPro PSR na 14ª geração e mais recentes.
Representação JSON |
---|
{ "reportTime": string, "uptimeRuntimeDuration": string, "enterSleepCount": string, "enterHibernationCount": string, "enterPoweroffCount": string } |
Campos | |
---|---|
reportTime |
Carimbo de data/hora em que o relatório foi coletado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
uptimeRuntimeDuration |
Tempo de execução total. 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 " |
enterSleepCount |
Número de vezes que o dispositivo entrou no estado de inatividade. Atualmente, é obtido pelo PSR, contagem de S0 a S3. |
enterHibernationCount |
Número de vezes que o dispositivo entrou no estado de hibernação. Atualmente, é obtido pelo PSR, contagem de S0 a S4. |
enterPoweroffCount |
Número de vezes que o dispositivo entrou no estado de desligamento. Atualmente, é obtida pelo PSR, contando de S0 a S5. |
Métodos |
|
---|---|
|
Receber o dispositivo de telemetria. |
|
Lista todos os dispositivos de telemetria. |