REST Resource: customers.telemetry.events

Recurso: TelemetryEvent

Datos de telemetría informados por un dispositivo administrado.

Representación JSON
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso del evento.

device

object (TelemetryDeviceInfo)

Solo salida. Información sobre el dispositivo asociado con el evento.

user

object (TelemetryUserInfo)

Solo salida. Información sobre el usuario asociado con el evento.

reportTime

string (Timestamp format)

Marca de tiempo que representa el momento en que se informó el evento

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

Es el tipo de evento del evento actual.

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo salida. Carga útil para un evento de subdesbordamiento grave de audio. Presente solo cuando el campo eventType es AUDIO_SEVERE_UNDERRUN.

usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo salida. Carga útil para eventos de periféricos USB. Solo está presente cuando el campo eventType es USB_ADDED o USB_REMOVED.

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Carga útil para el evento de cambio de estado de la conexión de red. Presente solo cuando eventType sea NETWORK_STATE_CHANGE.

httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo salida. Carga útil para el evento de cambio de latencia de HTTPS Presente solo cuando eventType sea NETWORK_HTTPS_LATENCY_CHANGE.

wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo salida. Carga útil para eventos de intensidad de la señal de Wi-Fi Presente solo cuando eventType sea WIFI_SIGNAL_STRENGTH_LOW o WIFI_SIGNAL_STRENGTH_RECOVERED.

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Carga útil para el evento de cambio de estado de conexión de VPN. Presente solo cuando eventType sea VPN_CONNECTION_STATE_CHANGE.

TelemetryDeviceInfo

Información sobre un dispositivo asociado con datos de telemetría.

  • Se necesita un permiso detallado: TELEMETRY_API_DEVICE
Representación JSON
{
  "deviceId": string,
  "orgUnitId": string
}
Campos
deviceId

string

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

orgUnitId

string

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

TelemetryUserInfo

Información sobre un usuario asociado con los datos de telemetría.

  • Se necesita un permiso detallado: TELEMETRY_API_USER
Representación JSON
{
  "email": string,
  "orgUnitId": string
}
Campos
email

string

Solo salida. Correo electrónico del usuario.

orgUnitId

string

Solo salida. Es el ID de unidad organizativa del usuario.

TelemetryAudioSevereUnderrunEvent

Este tipo no tiene campos.

TelemetryAudioSevereUnderrunEvent se activa cuando un dispositivo de audio se queda sin datos de búfer durante más de 5 segundos.

  • Se necesita un permiso detallado: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Se activó TelemetryUsbPeripheralsEvent, y se agregaron o quitaron dispositivos USB.

  • Se necesita un permiso detallado: TELEMETRY_API_PERIPHERALS_REPORT
Representación JSON
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campos
usbPeripheralReport[]

object (UsbPeripheralReport)

Lista de dispositivos USB que se agregaron o quitaron.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent se activa cuando cambia el estado de la conexión de red.

  • Se necesita un permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campos
guid

string

Es el identificador único de la red.

connectionState

enum (NetworkConnectionState)

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

TelemetryHttpsLatencyChangeEvent

La rutina de latencia HTTPS se ejecuta periódicamente y se activa TelemetryHttpsLatencyChangeEvent si se detectó un problema de latencia o si el dispositivo se recuperó de un problema de latencia.

  • Se necesita un permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campos
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Datos de rutina de latencia HTTPS que activaron el evento.

httpsLatencyState

enum (HttpsLatencyState)

Estado actual de la latencia de HTTPS

HttpsLatencyState

Estado de latencia de HTTPS.

Enumeradores
HTTPS_LATENCY_STATE_UNSPECIFIED No se especificó el estado de latencia de HTTPS.
RECOVERY Se recuperó la latencia de HTTPS de un problema.
PROBLEM Hay un problema de latencia de HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent se activa en eventos de intensidad de la señal Wi-Fi.

  • Se necesita un permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campos
guid

string

Es el identificador único de la red.

signalStrengthDbm

integer

Intensidad de la señal de RSSI

Métodos

list

Enumera los eventos de telemetría.