REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Données de télémétrie enregistrées par un appareil géré.

Représentation 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)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'événement.

device

object (TelemetryDeviceInfo)

Uniquement en sortie. Informations sur l'appareil associé à l'événement.

user

object (TelemetryUserInfo)

Uniquement en sortie. Informations sur l'utilisateur associé à l'événement.

reportTime

string (Timestamp format)

Code temporel représentant le moment où l'événement a été signalé

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

Type d'événement de l'événement en cours.

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Uniquement en sortie. Charge utile pour l'événement audio grave de sous-utilisation. Présent uniquement lorsque le champ eventType est défini sur AUDIO_SEVERE_UNDERRUN.

usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Uniquement en sortie. Charge utile pour l'événement de périphériques USB. Présent uniquement lorsque le champ eventType correspond à USB_ADDED ou USB_REMOVED.

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Uniquement en sortie. Charge utile pour l'événement de changement d'état de la connexion réseau. Présent uniquement lorsque eventType est défini sur NETWORK_STATE_CHANGE.

httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Uniquement en sortie. Charge utile pour l'événement de changement de latence HTTPS. Présent uniquement lorsque eventType est défini sur NETWORK_HTTPS_LATENCY_CHANGE.

wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Uniquement en sortie. Charge utile pour les événements d'intensité du signal Wi-Fi. Présent uniquement lorsque eventType est défini sur WIFI_SIGNAL_STRENGTH_LOW ou WIFI_SIGNAL_STRENGTH_RECOVERED.

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Uniquement en sortie. Charge utile pour l'événement de changement d'état de la connexion VPN. Présent uniquement lorsque eventType est défini sur VPN_CONNECTION_STATE_CHANGE.

TelemetryDeviceInfo

Informations sur un appareil associé à des données de télémétrie.

  • Autorisation précise requise: TELEMETRY_API_DEVICE
Représentation JSON
{
  "deviceId": string,
  "orgUnitId": string
}
Champs
deviceId

string

Uniquement en sortie. ID unique de l'API Directory de l'appareil. Cette valeur est identique à l'ID de l'API Directory de la console d'administration dans l'onglet "Appareils ChromeOS".

orgUnitId

string

Uniquement en sortie. ID d'unité organisationnelle de l'appareil.

TelemetryUserInfo

Informations sur un utilisateur associé à des données de télémétrie.

  • Autorisation précise requise: TELEMETRY_API_USER
Représentation JSON
{
  "email": string,
  "orgUnitId": string
}
Champs
email

string

Uniquement en sortie. Adresse e-mail de l'utilisateur.

orgUnitId

string

Uniquement en sortie. ID d'unité organisationnelle de l'utilisateur.

TelemetryAudioSevereUnderrunEvent

Ce type ne comporte aucun champ.

TelemetryAudioSevereUnderrunEvent se déclenche lorsqu'un appareil audio n'a plus de données de mémoire tampon pendant plus de cinq secondes.

  • Autorisation détaillée requise: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent : les appareils USB sont ajoutés ou supprimés.

  • Autorisation précise requise: TELEMETRY_API_PERIPHERALS_REPORT
Représentation JSON
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Champs
usbPeripheralReport[]

object (UsbPeripheralReport)

Liste des appareils USB ajoutés ou supprimés.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent est déclenché lorsque l'état de la connexion réseau change.

  • Autorisation détaillée requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Champs
guid

string

Identifiant unique du réseau.

connectionState

enum (NetworkConnectionState)

État de connexion actuel du réseau.

TelemetryHttpsLatencyChangeEvent

La routine de latence HTTPS est exécutée régulièrement et TelemetryHttpsLatencyChangeEvent se déclenche si un problème de latence a été détecté ou si l'appareil a résolu un problème de latence.

  • Autorisation détaillée requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Champs
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Données de routine de latence HTTPS ayant déclenché l'événement.

httpsLatencyState

enum (HttpsLatencyState)

État de latence HTTPS actuel.

HttpsLatencyState

État de latence HTTPS.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED L'état de latence HTTPS n'est pas spécifié.
RECOVERY Latence HTTPS résolue suite à un problème.
PROBLEM Problème de latence HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent se déclenche en cas d'événements d'intensité du signal Wi-Fi.

  • Autorisation détaillée requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON
{
  "guid": string,
  "signalStrengthDbm": integer
}
Champs
guid

string

Identifiant unique du réseau.

signalStrengthDbm

integer

Valeur RSSI de l'intensité du signal.

Méthodes

list

Répertorier les événements de télémétrie