REST Resource: customers.telemetry.devices

리소스: TelemetryDevice

관리 기기에서 수집된 원격 분석 데이터입니다.

  • 세분화된 권한 필요: TELEMETRY_API_DEVICE
JSON 표현
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
필드
name

string

출력 전용입니다. 기기의 리소스 이름입니다.

customer

string

출력 전용입니다. 기업에서 기기를 등록한 Google Workspace 고객

orgUnitId

string

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

deviceId

string

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

serialNumber

string

출력 전용입니다. 기기 일련번호입니다. 이 값은 ChromeOS 기기 탭에 있는 관리 콘솔의 일련번호와 동일합니다.

cpuInfo[]

object (CpuInfo)

출력 전용입니다. 기기의 CPU 사양 관련 정보입니다.

cpuStatusReport[]

object (CpuStatusReport)

출력 전용입니다. 주기적으로 수집된 CPU 상태 보고서는 reportTime의 내림차순으로 정렬됩니다.

memoryInfo

object (MemoryInfo)

출력 전용입니다. 기기의 메모리 사양 관련 정보입니다.

memoryStatusReport[]

object (MemoryStatusReport)

출력 전용입니다. 주기적으로 수집된 메모리 상태 보고서가 reportTime 기준으로 내림차순으로 정렬됩니다.

networkInfo

object (NetworkInfo)

출력 전용입니다. 네트워크 장치 정보입니다.

networkStatusReport[]

object (NetworkStatusReport)

출력 전용입니다. 주기적으로 수집되는 네트워크 사양.

networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

출력 전용입니다. 주기적으로 네트워크 진단 정보를 수집합니다.

osUpdateStatus[]

object (OsUpdateStatus)

출력 전용입니다. ChromeOS 업데이트 상태와 관련된 정보를 포함합니다.

graphicsInfo

object (GraphicsInfo)

출력 전용입니다. 기기의 그래픽 주변기기에 관한 정보가 포함됩니다.

graphicsStatusReport[]

object (GraphicsStatusReport)

출력 전용입니다. 주기적으로 수집되는 그래픽 보고서

batteryInfo[]

object (BatteryInfo)

출력 전용입니다. 기기의 배터리 사양에 관한 정보입니다.

batteryStatusReport[]

object (BatteryStatusReport)

출력 전용입니다. 배터리 보고서는 정기적으로 수집됩니다.

storageInfo

object (StorageInfo)

출력 전용입니다. 기기의 저장용량 사양에 관한 정보입니다.

storageStatusReport[]

object (StorageStatusReport)

출력 전용입니다. 주기적으로 수집되는 스토리지 보고서

thunderboltInfo[]

object (ThunderboltInfo)

출력 전용입니다. Thunderbolt 버스에 관한 정보입니다.

audioStatusReport[]

object (AudioStatusReport)

출력 전용입니다. 주기적으로 수집된 오디오 보고서는 reportTime의 내림차순으로 정렬됩니다.

bootPerformanceReport[]

object (BootPerformanceReport)

출력 전용입니다. 기기의 부팅 성능 보고서입니다.

heartbeatStatusReport[]

object (HeartbeatStatusReport)

출력 전용입니다. reportTime의 내림차순으로 주기적으로 정렬된 타임스탬프가 포함된 하트비트 상태 보고서

kioskAppStatusReport[]

object (KioskAppStatusReport)

출력 전용입니다. 키오스크 기기에 대한 키오스크 앱 상태 보고서

networkBandwidthReport[]

object (NetworkBandwidthReport)

출력 전용입니다. 주기적으로 수집된 네트워크 대역폭 보고서가 reportTime의 내림차순으로 정렬됩니다.

peripheralsReport[]

object (PeripheralsReport)

출력 전용입니다. 주기적으로 수집된 주변기기 보고서가 reportTime의 내림차순으로 정렬됩니다.

appReport[]

object (AppReport)

출력 전용입니다. 주기적으로 수집된 앱 보고서가 reportTime의 내림차순으로 정렬됩니다.

runtimeCountersReport[]

object (RuntimeCountersReport)

출력 전용입니다. 런타임 카운터는 수집된 기기 전체 기간 런타임뿐 아니라 절전 모드, 최대 절전 모드, 전원 끄기 상태로 전환됨을 의미하는 S0->S3, S0->S4, S0-> S5 전환 횟수를 보고합니다.

CpuInfo

기기의 CPU 사양

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDeviceCpuInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 필요한 세부 권한: TELEMETRY_API_CPU_INFO
JSON 표현
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
필드
model

string

출력 전용입니다. CPU 모델 이름입니다. 예: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz

architecture

enum (Architecture)

출력 전용입니다. CPU의 아키텍처 유형입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDeviceCpuInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
maxClockSpeed

integer

출력 전용입니다. 최대 CPU 클록 속도(kHz)입니다.

keylockerSupported

boolean

출력 전용입니다. 키 잠금기 지원 여부입니다.

keylockerConfigured

boolean

출력 전용입니다. 키 잠금기 구성 여부입니다.TRUE = 사용 설정됨 FALSE = 사용 중지됨. keylockerSupported = TRUE인 경우에만 보고됩니다.

아키텍처

CPU의 아키텍처 유형입니다.

열거형
ARCHITECTURE_UNSPECIFIED 아키텍처를 알 수 없습니다.
X64 x64 아키텍처

CpuStatusReport

CPU 상태 정보를 제공합니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceCpuInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 10분마다
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_CPU_REPORT
JSON 표현
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 이 보고서가 샘플링된 시간을 나타내는 밀리초 단위의 타임스탬프입니다.

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

sampleFrequency

string (Duration format)

출력 전용입니다. 보고서가 샘플링되는 빈도입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

cpuUtilizationPct

integer

출력 전용입니다. CPU 사용률 샘플 (0~100%)

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

출력 전용입니다. CPU 코어당 CPU 온도 샘플 정보(섭씨)

CpuTemperatureInfo

기기의 CPU 온도입니다. CPU 코어당 섭씨로 샘플링됩니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceCpuInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 10분마다
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
JSON 표현
{
  "temperatureCelsius": integer,
  "label": string
}
필드
temperatureCelsius

integer

출력 전용입니다. CPU 온도(섭씨)입니다.

label

string

출력 전용입니다. CPU 라벨입니다. 예: Core 0

MemoryInfo

기기의 메모리 정보입니다.

  • 이 필드에는 원격 분석 및 기기 정보가 모두 포함됩니다. <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes - 기기 정보
    • availableRamBytes - 원격 분석 정보
    • totalMemoryEncryption - 기기 정보
  • 이 필드의 데이터는 ReportDeviceMemoryInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes - 업로드 시에만
    • availableRamBytes~10분마다
    • totalMemoryEncryption - 기기 시작 시
  • 기본 데이터 보고 빈도: <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes~3시간
    • availableRamBytes~3시간
    • totalMemoryEncryption - 기기 시작 시
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. totalMemoryEncryption에 한합니다.
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_MEMORY_INFO
JSON 표현
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
필드
totalRamBytes

string (int64 format)

출력 전용입니다. 총 RAM(바이트)입니다.

availableRamBytes

string (int64 format)

출력 전용입니다. 사용 가능한 RAM 크기(바이트)입니다.

totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

출력 전용입니다. 기기의 총 메모리 암호화 정보입니다.

TotalMemoryEncryptionInfo

기기의 메모리 암호화 정보입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDeviceMemoryInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 기기 시작 시
  • 기본 데이터 보고 빈도: 기기 시작 시 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
JSON 표현
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
필드
encryptionState

enum (MemoryEncryptionState)

기기의 메모리 암호화 상태입니다.

maxKeys

string (int64 format)

암호화에 사용할 수 있는 최대 키 수입니다.

keyLength

string (int64 format)

암호화 키의 길이입니다.

encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

메모리 암호화 알고리즘

MemoryEncryptionState

기기의 메모리 암호화 상태입니다.

열거형
MEMORY_ENCRYPTION_STATE_UNSPECIFIED 메모리 암호화 상태가 설정되지 않았습니다.
MEMORY_ENCRYPTION_STATE_UNKNOWN 메모리 암호화 상태를 알 수 없습니다.
MEMORY_ENCRYPTION_STATE_DISABLED 기기에서 메모리 암호화가 사용 중지되었습니다.
MEMORY_ENCRYPTION_STATE_TME 기기의 메모리 암호화는 총 메모리 암호화를 사용합니다.
MEMORY_ENCRYPTION_STATE_MKTME 기기의 메모리 암호화는 다중 키 총 메모리 암호화를 사용합니다.

MemoryEncryptionAlgorithm

기기에서 사용 중인 암호화 알고리즘입니다.

열거형
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED 메모리 암호화 알고리즘이 설정되지 않았습니다.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN 사용 중인 메모리 암호화 알고리즘을 알 수 없습니다.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 메모리 암호화 알고리즘은 128비트 블록 암호가 포함된 AES_XTS 암호화 알고리즘을 사용합니다.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 메모리 암호화 알고리즘은 256비트 블록 암호가 포함된 AES_XTS 암호화 알고리즘을 사용합니다.

MemoryStatusReport

메모리 상태 보고서의 샘플이 포함되어 있습니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceMemoryInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만 10분마다 SystemRamFreeByes가 수집됨
  • 기본 데이터 보고 빈도: 3시간마다 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_MEMORY_REPORT
JSON 표현
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 이 보고서가 샘플링된 시간을 나타내는 밀리초 단위의 타임스탬프입니다.

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

sampleFrequency

string (Duration format)

출력 전용입니다. 보고서가 샘플링되는 빈도입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

systemRamFreeBytes

string (int64 format)

출력 전용입니다. 사용 가능한 RAM 크기(바이트)입니다(가비지 컬렉션으로 인해 신뢰할 수 없음).

pageFaults

integer

출력 전용입니다. 이 수집 중 발생한 페이지 오류 수

NetworkInfo

네트워크 장치 정보입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportNetworkDeviceConfiguration 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 기기 시작 시
  • 기본 데이터 보고 빈도: 기기 시작 시 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_INFO
JSON 표현
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
필드
networkDevices[]

object (NetworkDevice)

출력 전용입니다. 네트워크 기기 목록입니다.

NetworkDevice

네트워크 기기에 관한 세부정보입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportNetworkDeviceConfiguration 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 기기 시작 시
  • 기본 데이터 보고 빈도: 기기 시작 시 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
JSON 표현
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
필드
type

enum (NetworkDeviceType)

출력 전용입니다. 네트워크 기기 유형입니다.

macAddress

string

출력 전용입니다. 해당하는 네트워크 기기의 MAC 주소 (해당하는 경우)

meid

string

출력 전용입니다. 해당하는 네트워크 기기의 MEID (해당되는 경우).

imei

string

출력 전용입니다. 해당하는 네트워크 기기의 IMEI (해당하는 경우).

iccid

string

출력 전용입니다. 기기의 SIM 카드와 연결된 집적 회로 카드 ID입니다.

mdn

string

출력 전용입니다. 기기의 SIM 카드와 연결된 모바일 디렉터리 번호입니다.

NetworkDeviceType

네트워크 기기 유형입니다.

열거형
NETWORK_DEVICE_TYPE_UNSPECIFIED 네트워크 기기 유형이 지정되지 않았습니다.
CELLULAR_DEVICE 이동통신망 기기.
ETHERNET_DEVICE 이더넷 기기입니다.
WIFI_DEVICE Wi-Fi 기기

NetworkStatusReport

표시/구성된 네트워크의 상태입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportNetworkStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 60분
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 예
  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
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 (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 네트워크 상태가 보고된 시간입니다.

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

sampleFrequency

string (Duration format)

출력 전용입니다. 보고서가 샘플링되는 빈도입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

signalStrengthDbm

integer

출력 전용입니다. 데시벨 단위로 측정된 무선 네트워크의 신호 강도입니다.

lanIpAddress

string

출력 전용입니다. LAN IP 주소입니다.

gatewayIpAddress

string

출력 전용입니다. 게이트웨이 IP 주소입니다.

transmissionBitRateMbps

string (int64 format)

출력 전용입니다. 초당 메가비트 단위로 측정된 전송 비트 전송률

receivingBitRateMbps

string (int64 format)

출력 전용입니다. 초당 메가비트 단위로 측정된 수신 비트 전송률

transmissionPowerDbm

integer

출력 전용입니다. 데시벨 단위로 측정된 전송 전력입니다.

encryptionOn

boolean

출력 전용입니다. Wi-Fi 암호화 키의 사용 중지 여부입니다.

wifiPowerManagementEnabled

boolean

출력 전용입니다. Wi-Fi 전원 관리 사용 설정됨

guid

string

출력 전용입니다. 네트워크 연결 가이드입니다.

connectionState

enum (NetworkConnectionState)

출력 전용입니다. 네트워크의 현재 연결 상태입니다.

connectionType

enum (NetworkType)

출력 전용입니다. 네트워크 연결 유형입니다.

NetworkType

네트워크 연결 유형.

열거형
NETWORK_TYPE_UNSPECIFIED 네트워크 연결 유형 미지정
CELLULAR 셀룰러 네트워크에 연결되어 있습니다.
ETHERNET 이더넷 네트워크 연결
TETHER 테더링 네트워크 연결
VPN VPN 네트워크 연결
WIFI Wi-Fi 네트워크 연결

NetworkDiagnosticsReport

네트워크 테스트 결과로 기기의 네트워크 연결 상태(예: HTTPS 지연 시간이 긴지 보통인지)를 확인합니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 진단이 수집된 시점의 타임스탬프입니다.

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

httpsLatencyData

object (HttpsLatencyRoutineData)

출력 전용입니다. HTTPS 지연 시간 테스트 데이터

OsUpdateStatus

현재 OS 업데이트 상태에 관한 정보가 포함됩니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceOsUpdateStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_OS_REPORT
JSON 표현
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
필드
updateState

enum (UpdateState)

출력 전용입니다. OS 업데이트의 현재 상태입니다.

newPlatformVersion

string

출력 전용입니다. 다운로드 및 적용되는 OS 이미지의 새 플랫폼 버전입니다. 업데이트 상태가 OS_IMAGE_DOWNLOAD_IN_PROGRESS 또는 OS_UPDATE_NEED_REBOOT인 경우에만 설정됩니다. 더미 '0.0.0.0'일 수 있습니다. 일부 극단적인 사례의 경우 OS_UPDATE_NEED_REBOOT 상태(예: 업데이트 엔진이 재부팅 없이 다시 시작됩니다.

newRequestedPlatformVersion

string

출력 전용입니다. 업데이트 대기 중인 키오스크 앱에서 새로 요청한 플랫폼 버전입니다.

lastUpdateTime

string (Timestamp format)

출력 전용입니다. 마지막으로 성공한 업데이트의 타임스탬프입니다.

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

lastUpdateCheckTime

string (Timestamp format)

출력 전용입니다. 마지막 업데이트 확인의 타임스탬프입니다.

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

lastRebootTime

string (Timestamp format)

출력 전용입니다. 마지막 재부팅의 타임스탬프입니다.

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

UpdateState

OS 업데이트 상태

열거형
UPDATE_STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
OS_IMAGE_DOWNLOAD_NOT_STARTED OS에서 다운로드를 시작하지 않았습니다.
OS_IMAGE_DOWNLOAD_IN_PROGRESS OS가 기기에 다운로드를 시작했습니다.
OS_UPDATE_NEED_REBOOT 업로드를 완료하려면 기기를 재부팅해야 합니다.

GraphicsInfo

그래픽 하위 시스템에 관한 정보입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDeviceGraphicsStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 필요한 세부 권한: TELEMETRY_API_GRAPHICS_INFO
JSON 표현
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
필드
adapterInfo

object (GraphicsAdapterInfo)

출력 전용입니다. 그래픽 어댑터 (GPU)에 대한 정보입니다.

eprivacySupported

boolean

출력 전용입니다. 온라인 개인 정보 보호 화면 지원 여부

displayDevices[]

object (DisplayDevice)

출력 전용입니다. 기기 디스플레이에 관한 정보입니다.

touchScreenInfo

object (TouchScreenInfo)

출력 전용입니다. 기기의 내부 터치 스크린에 관한 정보입니다.

GraphicsAdapterInfo

그래픽 어댑터 (GPU)의 정보입니다.

JSON 표현
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
필드
adapter

string

출력 전용입니다. 어댑터 이름. 예: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).

driverVersion

string

출력 전용입니다. GPU 드라이버의 버전입니다.

deviceId

string (int64 format)

출력 전용입니다. 그래픽 카드 장치 ID를 나타냅니다.

DisplayDevice

디스플레이 기기에 관한 정보입니다.

JSON 표현
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
필드
displayName

string

출력 전용입니다. 기기 이름을 표시합니다.

displayWidthMm

integer

출력 전용입니다. 너비를 밀리미터 단위로 표시합니다.

displayHeightMm

integer

출력 전용입니다. 높이를 밀리미터 단위로 표시합니다.

internal

boolean

출력 전용입니다. 디스플레이 내부 여부입니다.

manufacturerId

string

출력 전용입니다. 세 글자로 된 제조업체 ID입니다.

modelId

integer

출력 전용입니다. 제조업체 제품 코드입니다.

manufactureYear

integer

출력 전용입니다. 제조 연도

TouchScreenInfo

기기 터치스크린의 정보입니다.

JSON 표현
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
필드
touchpadLibrary

string

출력 전용입니다. 입력 스택에서 사용하는 터치패드 라이브러리 이름입니다.

devices[]

object (TouchScreenDevice)

출력 전용입니다. 내부 터치 스크린 기기 목록입니다.

TouchScreenDevice

내부 터치 스크린 기기에 관한 정보입니다.

JSON 표현
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
필드
displayName

string

출력 전용입니다. 터치 스크린 기기 표시 이름입니다.

touchPointCount

integer

출력 전용입니다. 기기에서 지원되는 터치 포인트의 수입니다.

stylusCapable

boolean

출력 전용입니다. 터치 스크린 기기에서 스타일러스를 사용할 수 있는지 여부입니다.

GraphicsStatusReport

그래픽 하위 시스템에 관한 정보입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceGraphicsInfo 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 3시간
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_GRAPHICS_REPORT
JSON 표현
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 그래픽 데이터가 보고된 시간입니다.

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

displays[]

object (DisplayInfo)

출력 전용입니다. 기기의 디스플레이에 관한 정보입니다.

DisplayInfo

디스플레이에 관한 정보입니다.

JSON 표현
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
필드
deviceId

string (int64 format)

출력 전용입니다. 그래픽 카드 장치 ID를 나타냅니다.

resolutionWidth

integer

출력 전용입니다. 픽셀 단위의 해상도 너비입니다.

resolutionHeight

integer

출력 전용입니다. 픽셀 단위의 해상도 높이입니다.

refreshRate

integer

출력 전용입니다. 화면 재생 빈도(Hz)

isInternal

boolean

출력 전용입니다. 디스플레이가 내부인지 여부를 나타냅니다.

displayName

string

출력 전용입니다. 기기 이름을 표시합니다.

BatteryInfo

배터리에 관한 정보입니다.

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDevicePowerStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_BATTERY_INFO
JSON 표현
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
필드
serialNumber

string

출력 전용입니다. 배터리 일련번호입니다.

manufacturer

string

출력 전용입니다. 배터리 제조업체입니다.

designCapacity

string (int64 format)

출력 전용입니다. 설계 용량 (mAmpere-시간)

designMinVoltage

integer

출력 전용입니다. 설계된 최소 출력 전압 (mV)

manufactureDate

object (Date)

출력 전용입니다. 배터리 제조 날짜입니다.

technology

string

출력 전용입니다. 배터리 기술입니다. 예: 리튬 이온

BatteryStatusReport

배터리의 상태 데이터입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDevicePowerStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_BATTERY_REPORT
JSON 표현
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 기기에서 샘플이 수집된 시점의 타임스탬프

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

serialNumber

string

출력 전용입니다. 배터리 일련번호입니다.

sample[]

object (BatterySampleReport)

출력 전용입니다. 배터리의 샘플링 데이터를 reportTime의 내림차순으로 정렬합니다.

batteryHealth

enum (BatteryHealth)

출력 전용입니다. 배터리 성능 상태

fullChargeCapacity

string (int64 format)

출력 전용입니다. 완전 충전 용량 (mAmpere-시간)

cycleCount

integer

출력 전용입니다. 사이클 수

BatterySampleReport

배터리 데이터를 샘플링하는 중입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDevicePowerStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
JSON 표현
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 기기에서 샘플이 수집된 시점의 타임스탬프

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

voltage

string (int64 format)

출력 전용입니다. 배터리 전압 (밀리볼트).

remainingCapacity

string (int64 format)

출력 전용입니다. 배터리 잔량 (mAmpere-hours)입니다.

temperature

integer

출력 전용입니다. 온도(섭씨)입니다.

dischargeRate

integer

출력 전용입니다. mW 단위로 측정된 배터리 방전 속도입니다. 배터리가 방전되는 경우 양수, 충전 중인 경우 음수입니다.

chargeRate

integer

출력 전용입니다. 배터리 충전율

current

string (int64 format)

출력 전용입니다. 배터리 전류 (mA).

status

string

출력 전용입니다. sysfs에서 배터리 상태를 읽습니다. 예: 방전 중

BatteryHealth

배터리의 현재 상태를 나타냅니다.

  • 이 상태는 배터리 결함의 게이지나 표시가 아닙니다. 현재 완전 충전 용량을 설계 용량으로 나누어 계산합니다.
  • 배터리 무결성 및 보증 정책을 정의하는 것은 제조업체에서 결정합니다.
열거형
BATTERY_HEALTH_UNSPECIFIED 상태를 알 수 없습니다.
BATTERY_HEALTH_NORMAL 배터리가 정상입니다. 완전히 충전된 용량 / 설계 용량 > 80%
BATTERY_REPLACE_SOON 배터리가 다소 건강하지 않으며 곧 교체하는 것이 좋습니다. 완전 충전 용량 / 설계 용량 75%~80%
BATTERY_REPLACE_NOW 배터리가 불량이며 교체 권장됨, 완전 충전 용량 / 설계 용량 < 75%

StorageInfo

스토리지의 상태 데이터입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceStorageStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_STORAGE_INFO
JSON 표현
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
필드
volume[]

object (DiskVolume)

디스크 볼륨 정보

availableDiskBytes

string (int64 format)

기기에서 사용자 데이터를 저장할 수 있는 공간(바이트)입니다.

totalDiskBytes

string (int64 format)

기기에 있는 사용자 데이터 저장소의 총 공간(바이트)입니다.

DiskVolume

디스크 볼륨 정보

JSON 표현
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
필드
volumeId

string

디스크 볼륨 ID입니다.

storageFreeBytes

string (int64 format)

여유 저장공간(바이트)입니다.

storageTotalBytes

string (int64 format)

총 저장공간(바이트)입니다.

StorageStatusReport

스토리지의 상태 데이터입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceStorageStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_STORAGE_REPORT
JSON 표현
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
필드
reportTime

string (Timestamp format)

출력 전용입니다. 기기에서 샘플이 수집된 시점의 타임스탬프

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

disk[]

object (DiskInfo)

출력 전용입니다. 디스크에 대한 보고서입니다.

DiskInfo

단일 저장소 기기의 상태입니다.

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
}
필드
serialNumber

string

출력 전용입니다. 디스크 일련번호입니다.

manufacturer

string

출력 전용입니다. 디스크 제조업체입니다.

model

string

출력 전용입니다. 디스크 모델

sizeBytes

string (int64 format)

출력 전용입니다. 디스크 크기

type

string

출력 전용입니다. 디스크 유형: eMMC / NVMe / ATA / SCSI

health

string

출력 전용입니다. 디스크 상태

volumeIds[]

string

출력 전용입니다. 디스크 볼륨

bytesReadThisSession

string (int64 format)

출력 전용입니다. 마지막 부팅 이후 읽은 바이트 수입니다.

bytesWrittenThisSession

string (int64 format)

출력 전용입니다. 마지막 부팅 이후 쓴 바이트 수입니다.

readTimeThisSession

string (Duration format)

출력 전용입니다. 마지막 부팅 이후 디스크에서 읽는 데 걸린 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

writeTimeThisSession

string (Duration format)

출력 전용입니다. 마지막 부팅 이후 디스크에 쓰는 데 걸린 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

ioTimeThisSession

string (Duration format)

출력 전용입니다. 디스크와 큐가 사용 중이었던 시간을 계산하므로 위의 필드와 달리 병렬 요청은 여러 번 계산되지 않습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

discardTimeThisSession

string (Duration format)

출력 전용입니다. 마지막 부팅 이후 삭제하는 데 걸린 시간입니다. 삭제는 더 이상 사용하지 않는 블록을 지우는 것을 말합니다. 커널 4.18 이상에서 지원됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

ThunderboltInfo

Thunderbolt 버스 정보

  • 이 필드는 기기 정보를 제공합니다. 이 정보는 정적이며 시간이 지나도 변하지 않습니다.
  • 이 필드의 데이터는 ReportDeviceSecurityStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 기기 시작 시
  • 기본 데이터 보고 빈도: 기기 시작 시 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 아니요
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_BUS_DEVICE_INFO
JSON 표현
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
필드
securityLevel

enum (ThunderboltSecurityLevel)

Thunderbolt 버스의 보안 수준입니다.

ThunderboltSecurityLevel

Thunderbolt 버스의 보안 수준입니다.

열거형
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Thunderbolt 보안 수준이 설정되지 않았습니다.
THUNDERBOLT_SECURITY_NONE_LEVEL 모든 기기는 펌웨어에 의해 자동으로 연결됩니다. 사용자 승인이 필요하지 않습니다.
THUNDERBOLT_SECURITY_USER_LEVEL 사용자에게 기기를 연결할 수 있는지 묻는 메시지가 표시됩니다.
THUNDERBOLT_SECURITY_SECURE_LEVEL 사용자에게 기기를 연결할 수 있는지 묻는 메시지가 표시됩니다. 또한 키 sysfs 속성에 작성된 임의의 키를 기반으로 예상되는 챌린지와 일치해야 하는 챌린지가 기기에 전송됩니다.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL 펌웨어는 Thunderbolt용 터널을 자동으로 생성합니다.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL 펌웨어는 도크의 USB 컨트롤러 및 디스플레이 포트를 위한 터널을 자동으로 생성합니다. 도크의 다운스트림은 모든 PCIe 링크가 제거됩니다.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIE 터널링이 사용 중지되었습니다.

BootPerformanceReport

기기의 부팅 성능 보고서입니다.

  • 이 필드는 텔레메트리 정보이며 시간이 지남에 따라 기기가 활용됨에 따라 변경됩니다.
  • 이 필드의 데이터는 ReportDeviceBootMode 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 모든 부팅 이벤트 시
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 예
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_OS_REPORT
JSON 표현
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
필드
bootUpDuration

string (Duration format)

부팅하는 데 걸린 총 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

bootUpTime

string (Timestamp format)

전원이 켜졌을 때의 타임스탬프입니다.

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

shutdownDuration

string (Duration format)

종료가 시작된 후 전원이 꺼지기까지의 총 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

shutdownTime

string (Timestamp format)

종료 시점의 타임스탬프입니다.

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

shutdownReason

enum (ShutdownReason)

종료 이유입니다.

reportTime

string (Timestamp format)

보고서가 수집된 시점의 타임스탬프입니다.

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

ShutdownReason

종료 이유입니다.

열거형
SHUTDOWN_REASON_UNSPECIFIED 종료 이유가 지정되지 않았습니다.
USER_REQUEST 사용자에 의해 시작됩니다.
SYSTEM_UPDATE 시스템 업데이트가 시작되었습니다.
LOW_BATTERY 배터리 부족으로 인해 종료됩니다.
OTHER 기타 이유로 종료됩니다.

HeartbeatStatusReport

기기의 하트비트 상태 보고서입니다.

  • 키오스크에서 사용 가능
  • 이 필드는 기기의 온라인/오프라인/알 수 없는 상태를 제공하며 상태가 변경된 경우에만 포함됩니다 (예: 온라인 -> 오프라인).
  • 이 필드의 데이터는 HeartbeatEnabled 정책을 통해 제어됩니다. 추가 정보
  • 하트비트 빈도: 2분 <ph type="x-smartling-placeholder">
      </ph>
    • 참고: 기기가 오프라인 상태가 되면 기기의 온라인 상태가 업데이트되는 데 최대 12분이 걸릴 수 있습니다.
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 해당 사항 없음
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON 표현
{
  "reportTime": string,
  "state": enum (State)
}
필드
reportTime

string (Timestamp format)

상태 변경이 감지된 시점의 타임스탬프

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

state

enum (State)

기기가 변경된 상태

기기 상태

열거형
STATE_UNSPECIFIED 상태가 지정되지 않음
UNKNOWN 기기에서 하트비트 모니터링을 사용할 수 없음
ONLINE 기기가 온라인 상태임
OFFLINE 기기가 오프라인 상태입니다.

KioskAppStatusReport

기기의 키오스크 앱 상태 보고서

  • 키오스크에서 사용 가능
  • 이 필드는 키오스크 기기에서 실행 중인 앱 ID와 버전 번호와 보고서가 마지막으로 업데이트된 시점의 타임스탬프를 제공합니다.
  • 이 필드의 데이터는 ReportDeviceSessionStatus 정책을 통해 제어됩니다.
  • 데이터 수집 빈도: 업로드 시에만
  • 기본 데이터 보고 빈도: 3시간 <ph type="x-smartling-placeholder">
      </ph>
    • 정책 제어: 예
  • 캐시: 기기가 오프라인 상태인 경우 수집된 데이터는 로컬에 저장되며 기기가 다음에 온라인 상태가 되면 보고됩니다. 아니요
  • 연결된 사용자에 대해서만 보고됨: 해당 사항 없음
  • 세분화된 권한 필요: TELEMETRY_API_APPS_REPORT
JSON 표현
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
필드
reportTime

string (Timestamp format)

보고서가 수집된 시점의 타임스탬프

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

appId

string

키오스크 앱의 앱 ID(예: 'mdmkkicfmmkgmpkmkdikhlbggogpicma')

appVersion

string

키오스크 앱의 앱 버전 번호(예: '1.10.118')

RuntimeCountersReport

CPU에서 검색된 런타임 카운터입니다. 현재 런타임 카운터 원격 분석은 14세대 이상의 Intel vPro PSR에서만 지원됩니다.

JSON 표현
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
필드
reportTime

string (Timestamp format)

보고서가 수집된 시점의 타임스탬프입니다.

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

uptimeRuntimeDuration

string (Duration format)

총 전체 기간 런타임입니다. 현재 항상 Intel vPro PSR의 S0 런타임입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

enterSleepCount

string (int64 format)

기기가 절전 모드로 전환된 횟수입니다. 현재 PSR을 통해 얻은 경우 S0->S3에서 계산합니다.

enterHibernationCount

string (int64 format)

기기가 최대 절전 모드로 전환된 횟수입니다. 현재 PSR을 통해 얻은 것으로, S0->S4에서 계산합니다.

enterPoweroffCount

string (int64 format)

기기가 전원 꺼짐 상태로 전환된 횟수입니다. 현재는 PSR을 통해 얻은 것으로, S0~S5에서 계산합니다.

메서드

get

원격 분석 기기를 가져옵니다.

list

모든 원격 분석 기기를 나열합니다.