REST Resource: customers.telemetry.events

리소스: TelemetryEvent

관리 기기에서 보고한 원격 분석 데이터

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)
  }
}
입력란
name

string

출력 전용. 이벤트의 리소스 이름입니다.
device

object (TelemetryDeviceInfo)

출력 전용. 이벤트와 연결된 기기에 대한 정보입니다.
user

object (TelemetryUserInfo)

출력 전용. 이벤트와 연결된 사용자에 대한 정보입니다.
reportTime

string (Timestamp format)

이벤트가 보고된 시점을 나타내는 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
eventType

enum (EventType)

현재 이벤트의 이벤트 유형입니다.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

출력 전용. 오디오 심각한 언더런 이벤트의 페이로드입니다. eventType 필드가 AUDIO_SEVERE_UNDERRUN인 경우에만 존재합니다.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

출력 전용. USB 주변기기 이벤트의 페이로드 eventType 필드가 USB_ADDED 또는 USB_REMOVED인 경우에만 존재합니다.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

출력 전용. 네트워크 연결 상태 변경 이벤트의 페이로드 eventType이 NETWORK_STATE_CHANGE인 경우에만 있습니다.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

출력 전용. HTTPS 지연 시간 변경 이벤트의 페이로드 eventType이 NETWORK_HTTPS_LATENCY_CHANGE인 경우에만 있습니다.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

출력 전용. Wi-Fi 신호 강도 이벤트의 페이로드입니다. eventType가 WIFI_SIGNAL_STRENGTH_LOW 또는 WIFI_SIGNAL_STRENGTH_RECOVERED인 경우에만 존재합니다.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

출력 전용. VPN 연결 상태 변경 이벤트의 페이로드 eventType이 VPN_CONNECTION_STATE_CHANGE인 경우에만 있습니다.

TelemetryDeviceInfo

원격 분석 데이터와 연결된 기기에 대한 정보입니다.

  • 세분화된 권한 필요: TELEMETRY_API_DEVICE
JSON 표현 
{
  "deviceId": string,
  "orgUnitId": string
}
입력란
deviceId

string

출력 전용. 기기의 고유한 Directory API ID입니다. 이 값은 ChromeOS 기기 탭에 있는 관리 콘솔의 Directory API ID와 동일합니다.
orgUnitId

string

출력 전용. 기기의 조직 단위 ID입니다.

TelemetryUserInfo

원격 분석 데이터와 연결된 사용자에 대한 정보입니다.

  • 세분화된 권한 필요: TELEMETRY_API_USER
JSON 표현 
{
  "email": string,
  "orgUnitId": string
}
입력란
email

string

출력 전용. 사용자의 이메일 주소입니다.
orgUnitId

string

출력 전용. 사용자의 조직 단위 ID입니다.

TelemetryAudioSevereUnderrunEvent

이 유형에는 필드가 없습니다.

TelemetryAudioSevereUnderrunEvent는 오디오 기기의 버퍼 데이터가 5초 넘게 부족하면 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent는 트리거된 USB 기기가 추가되거나 삭제됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_PERIPHERALS_REPORT
JSON 표현 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
입력란
usbPeripheralReport[]

object (UsbPeripheralReport)

추가 또는 삭제된 USB 기기 목록입니다.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent는 네트워크 연결 상태가 변경되면 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
입력란
guid

string

네트워크의 고유 식별자입니다.
connectionState

enum (NetworkConnectionState)

네트워크의 현재 연결 상태입니다.

TelemetryHttpsLatencyChangeEvent

HTTPS 지연 시간 루틴은 주기적으로 실행되며 지연 시간 문제가 감지되거나 기기가 지연 시간 문제에서 복구되면 TelemetryHttpsLatencyChangeEvent가 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
입력란
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

이벤트를 트리거한 HTTPS 지연 시간 루틴 데이터입니다.
httpsLatencyState

enum (HttpsLatencyState)

현재 HTTPS 지연 시간 상태입니다.

HttpsLatencyState

HTTPS 지연 시간 상태

열거형
HTTPS_LATENCY_STATE_UNSPECIFIED HTTPS 지연 시간 상태가 지정되지 않았습니다.
RECOVERY 문제에서 HTTPS 지연 시간이 복구되었습니다.
PROBLEM HTTPS 지연 시간 문제

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent는 Wi-Fi 신호 강도 이벤트 시 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "guid": string,
  "signalStrengthDbm": integer
}
입력란
guid

string

네트워크의 고유 식별자입니다.
signalStrengthDbm

integer

신호 강도 RSSI 값입니다.

방법

list

 원격 분석 이벤트를 나열합니다.