REST Resource: customers.telemetry.events

Risorsa: TelemetryEvent

Dati di telemetria segnalati da un dispositivo gestito.

Rappresentazione 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)
  }
}
Campi
name

string

Solo output. Nome della risorsa dell'evento.
device

object (TelemetryDeviceInfo)

Solo output. Informazioni sul dispositivo associato all'evento.
user

object (TelemetryUserInfo)

Solo output. Informazioni sull'utente associato all'evento.
reportTime

string (Timestamp format)

Timestamp che rappresenta il momento in cui l'evento è stato segnalato.

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

enum (EventType)

Il tipo di evento corrente.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo output. Payload per evento audio grave di sottoesecuzione. Presenta solo quando il campo eventType è AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo output. Payload per evento di periferiche USB. Presenta solo quando il campo eventType è USB_ADDED o USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo output. Payload per l'evento di modifica dello stato della connessione di rete. Presenta solo quando eventType è NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo output. Payload per l'evento di modifica della latenza HTTPS. Presenta solo quando eventType è NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo output. Payload per eventi di intensità del segnale Wi-Fi. Presenta solo quando eventType è WIFI_SIGNAL_STRENGTH_LOW o WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo output. Payload per l'evento di modifica dello stato della connessione VPN. Presenta solo quando eventType è VPN_CONNECTION_STATE_CHANGE.

TelemetryDeviceInfo

Informazioni su un dispositivo associato ai dati di telemetria.

  • Autorizzazione granulare necessaria: TELEMETRY_API_DEVICE
Rappresentazione JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Campi
deviceId

string

Solo output. L'ID univoco dell'API Directory del dispositivo. Questo valore corrisponde all'ID API Directory della Console di amministrazione nella scheda Dispositivi ChromeOS.
orgUnitId

string

Solo output. ID unità organizzativa del dispositivo.

TelemetryUserInfo

Informazioni su un utente associato ai dati di telemetria.

  • Autorizzazione granulare necessaria: TELEMETRY_API_USER
Rappresentazione JSON 
{
  "email": string,
  "orgUnitId": string
}
Campi
email

string

Solo output. Email dell'utente.
orgUnitId

string

Solo output. ID unità organizzativa dell'utente.

TelemetryAudioSevereUnderrunEvent

Questo tipo non contiene campi.

La funzionalità TelemetryAudioSevereUnderrunEvent viene attivata quando un dispositivo audio esaurisce i dati del buffer per più di 5 secondi.

  • Autorizzazione granulare necessaria: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Viene attivato TelemetryUsbPeripheralsEvent. I dispositivi USB sono stati aggiunti o rimossi.

  • Autorizzazione granulare necessaria: TELEMETRY_API_PERIPHERALS_REPORT
Rappresentazione JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campi
usbPeripheralReport[]

object (UsbPeripheralReport)

Elenco dei dispositivi USB aggiunti o rimossi.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent viene attivato alle modifiche dello stato della connessione di rete.

  • Autorizzazione granulare necessaria: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campi
guid

string

Identificatore univoco della rete.
connectionState

enum (NetworkConnectionState)

Stato attuale della connessione della rete.

TelemetryHttpsLatencyChangeEvent

La routine di latenza HTTPS viene eseguita periodicamente e l'opzione TelemetryHttpsLatencyChangeEvent viene attivata se è stato rilevato un problema di latenza o se il dispositivo si è ripristinato da un problema di latenza.

  • Autorizzazione granulare necessaria: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campi
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Dati della routine di latenza HTTPS che hanno attivato l'evento.
httpsLatencyState

enum (HttpsLatencyState)

Stato di latenza HTTPS attuale.

HttpsLatencyState

Stato della latenza HTTPS.

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Lo stato di latenza HTTPS non è specificato.
RECOVERY Latenza HTTPS recuperata da un problema.
PROBLEM Problema di latenza HTTPS.

TelemetryNetworkSignalStrengthEvent

L'opzione TelemetryNetworkSignalStrengthEvent viene attivata in caso di eventi di intensità del segnale Wi-Fi.

  • Autorizzazione granulare necessaria: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campi
guid

string

Identificatore univoco della rete.
signalStrengthDbm

integer

Valore RSSI di intensità del segnale.

Metodi

list

 Elenca gli eventi di telemetria.