- リソース: TelemetryDevice
- CpuInfo
- アーキテクチャ
- CpuStatusReport
- CpuTemperatureInfo
- MemoryInfo
- TotalMemoryEncryptionInfo
- MemoryEncryptionState
- MemoryEncryptionAlgorithm
- MemoryStatusReport
- NetworkInfo
- NetworkDevice
- NetworkDeviceType
- NetworkStatusReport
- NetworkType
- NetworkDiagnosticsReport
- OsUpdateStatus
- UpdateState
- GraphicsInfo
- GraphicsAdapterInfo
- DisplayDevice
- TouchScreenInfo
- TouchScreenDevice
- GraphicsStatusReport
- DisplayInfo
- BatteryInfo
- BatteryStatusReport
- BatterySampleReport
- BatteryHealth
- StorageInfo
- DiskVolume
- StorageStatusReport
- DiskInfo
- ThunderboltInfo
- ThunderboltSecurityLevel
- BootPerformanceReport
- ShutdownReason
- HeartbeatStatusReport
- 州名
- KioskAppStatusReport
- RuntimeCountersReport
- メソッド
リソース: TelemetryDevice
管理対象デバイスから収集されたテレメトリー データ。
- 必要なきめ細かい権限: TELEMETRY_API_DEVICE
| JSON 表現 |
|---|
{ "name": string, "customer": string, "orgUnitId": string, "deviceId": string, "serialNumber": string, "cpuInfo": [ { object ( |
| フィールド | |
|---|---|
name |
出力専用。デバイスのリソース名。 |
customer |
出力専用。デバイスを登録した企業の Google Workspace ユーザー。 |
orgUnitId |
出力専用。デバイスの組織部門 ID。 |
deviceId |
出力専用。デバイスの一意の Directory API ID。この値は、管理コンソールの [ChromeOS デバイス] タブにある Directory API ID と同じです。 |
serialNumber |
出力専用。デバイスのシリアル番号。この値は、管理コンソールの [ChromeOS デバイス] タブのシリアル番号と同じです。 |
cpuInfo[] |
出力専用。デバイスの CPU 仕様に関する情報。 |
cpuStatusReport[] |
出力専用。定期的に収集された CPU ステータス レポート。 |
memoryInfo |
出力専用。デバイスのメモリ仕様に関する情報。 |
memoryStatusReport[] |
出力専用。定期的に収集されたメモリ ステータス レポートが |
networkInfo |
出力専用。ネットワーク デバイスの情報。 |
networkStatusReport[] |
出力専用。ネットワークの仕様が定期的に収集されます。 |
networkDiagnosticsReport[] |
出力専用。ネットワーク診断が定期的に収集されます。 |
osUpdateStatus[] |
出力専用。ChromeOS の更新ステータスに関する関連情報が含まれます。 |
graphicsInfo |
出力専用。デバイスのグラフィック周辺機器に関する情報が含まれています。 |
graphicsStatusReport[] |
出力専用。定期的に収集されるグラフィック レポート。 |
batteryInfo[] |
出力専用。デバイスのバッテリー仕様に関する情報。 |
batteryStatusReport[] |
出力専用。バッテリー レポートが定期的に収集されます。 |
storageInfo |
出力専用。デバイスのストレージ仕様に関する情報。 |
storageStatusReport[] |
出力専用。定期的に収集されるストレージ レポート。 |
thunderboltInfo[] |
出力専用。Thunderbolt バスに関する情報。 |
audioStatusReport[] |
出力専用。定期的に収集された音声レポートを |
bootPerformanceReport[] |
出力専用。デバイスの起動パフォーマンス レポート。 |
heartbeatStatusReport[] |
出力専用。 |
kioskAppStatusReport[] |
出力専用。キオスク デバイスのキオスクアプリのステータス レポート |
networkBandwidthReport[] |
出力専用。定期的に収集されたネットワーク帯域幅レポートが |
peripheralsReport[] |
出力専用。定期的に収集された周辺機器レポートが、 |
appReport[] |
出力専用。定期的に収集されたアプリレポートが |
runtimeCountersReport[] |
出力専用。ランタイム カウンタ レポートは、デバイスの全期間のランタイムと、S0->S3、S0->S4、S0->S5 の移行回数(スリープ、休止状態、電源オフ状態への移行)を収集します。 |
CpuInfo
デバイスの CPU の仕様
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportDeviceCpuInfo で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_CPU_INFO
| JSON 表現 |
|---|
{
"model": string,
"architecture": enum ( |
| フィールド | |
|---|---|
model |
出力専用。CPU のモデル名。例: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz |
architecture |
出力専用。CPU のアーキテクチャ タイプ。
|
maxClockSpeed |
出力専用。CPU の最大クロック速度(kHz)。 |
keylockerSupported |
出力専用。キーロッカーがサポートされているかどうか。 |
keylockerConfigured |
出力専用。キーロッカーが設定されているかどうか。 |
アーキテクチャ
CPU のアーキテクチャ タイプ。
| 列挙型 | |
|---|---|
ARCHITECTURE_UNSPECIFIED |
アーキテクチャが不明です。 |
X64 |
x64 アーキテクチャ |
CpuStatusReport
CPU のステータスに関する情報を提供します。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceCpuInfo で制御されます。
- データ収集頻度: 10 分ごと
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_CPU_REPORT
| JSON 表現 |
|---|
{
"reportTime": string,
"sampleFrequency": string,
"cpuUtilizationPct": integer,
"cpuTemperatureInfo": [
{
object ( |
| フィールド | |
|---|---|
reportTime |
出力専用。このレポートがサンプリングされた時刻を表すタイムスタンプ(ミリ秒単位)。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
sampleFrequency |
出力専用。レポートがサンプリングされる頻度。
|
cpuUtilizationPct |
出力専用。CPU 使用率のサンプル(0 ~ 100%)。 |
cpuTemperatureInfo[] |
出力専用。CPU コアごとの CPU 温度サンプル情報(摂氏) |
CpuTemperatureInfo
デバイスの CPU 温度。CPU コアごとに摂氏でサンプリングされます。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceCpuInfo で制御されます。
- データ収集頻度: 10 分ごと
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
| JSON 表現 |
|---|
{ "temperatureCelsius": integer, "label": string } |
| フィールド | |
|---|---|
temperatureCelsius |
出力専用。CPU の温度(摂氏)。 |
label |
出力専用。CPU ラベル。例: Core 0 |
MemoryInfo
デバイスのメモリ情報。
- このフィールドには、テレメトリーとデバイスの両方の情報が含まれます。
totalRamBytes- デバイス情報availableRamBytes- テレメトリー情報totalMemoryEncryption- デバイス情報
- このフィールドのデータは、ポリシー ReportDeviceMemoryInfo で制御されます。
- データの収集頻度:
totalRamBytes- アップロード時のみavailableRamBytes- 10 分ごとtotalMemoryEncryption- デバイスの起動時
- デフォルトのデータ レポートの頻度:
totalRamBytes- 3 時間availableRamBytes- 3 時間totalMemoryEncryption- デバイスの起動時- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます(
totalMemoryEncryptionのみ)。 - 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_MEMORY_INFO
| JSON 表現 |
|---|
{
"totalRamBytes": string,
"availableRamBytes": string,
"totalMemoryEncryption": {
object ( |
| フィールド | |
|---|---|
totalRamBytes |
出力専用。合計 RAM(バイト単位)。 |
availableRamBytes |
出力専用。使用可能な RAM の量(バイト単位)。 |
totalMemoryEncryption |
出力専用。デバイスのメモリ全体の暗号化情報。 |
TotalMemoryEncryptionInfo
デバイスのメモリ暗号化情報。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportDeviceMemoryInfo で制御されます。
- データ収集の頻度: デバイスの起動時
- デフォルトのデータ レポートの頻度: デバイスの起動時
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: N/A
| JSON 表現 |
|---|
{ "encryptionState": enum ( |
| フィールド | |
|---|---|
encryptionState |
デバイスのメモリ暗号化の状態。 |
maxKeys |
暗号化に使用できる鍵の最大数。 |
keyLength |
暗号鍵の長さ。 |
encryptionAlgorithm |
メモリの暗号化アルゴリズム。 |
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 で制御されます。
- データ収集の頻度: アップロード時のみ。SystemRamFreeByes は 10 分ごとに収集されます
- デフォルトのデータ レポートの頻度: 3 時間ごと
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_MEMORY_REPORT
| JSON 表現 |
|---|
{ "reportTime": string, "sampleFrequency": string, "systemRamFreeBytes": string, "pageFaults": integer } |
| フィールド | |
|---|---|
reportTime |
出力専用。このレポートがサンプリングされた時刻を表すタイムスタンプ(ミリ秒単位)。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
sampleFrequency |
出力専用。レポートがサンプリングされる頻度。
|
systemRamFreeBytes |
出力専用。空き RAM の容量(バイト単位)(ガベージ コレクションのため信頼性が低い)。 |
pageFaults |
出力専用。この収集中のページ フォールトの数 |
NetworkInfo
ネットワーク デバイス情報。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportNetworkDeviceConfiguration で制御されます。
- データ収集の頻度: デバイスの起動時
- デフォルトのデータ レポートの頻度: デバイスの起動時
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_NETWORK_INFO
| JSON 表現 |
|---|
{
"networkDevices": [
{
object ( |
| フィールド | |
|---|---|
networkDevices[] |
出力専用。ネットワーク デバイスのリスト。 |
NetworkDevice
ネットワーク デバイスに関する詳細。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportNetworkDeviceConfiguration で制御されます。
- データ収集の頻度: デバイスの起動時
- デフォルトのデータ レポートの頻度: デバイスの起動時
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: N/A
| JSON 表現 |
|---|
{
"type": enum ( |
| フィールド | |
|---|---|
type |
出力専用。ネットワーク デバイスのタイプ。 |
macAddress |
出力専用。対応するネットワーク デバイスの MAC アドレス(該当する場合)。 |
meid |
出力専用。対応するネットワーク デバイスの MEID(該当する場合)。 |
imei |
出力専用。対応するネットワーク デバイスの IMEI(該当する場合)。 |
iccid |
出力専用。デバイスの SIM カードに関連付けられている集積回路カード ID。 |
mdn |
出力専用。デバイスの SIM カードに関連付けられているモバイル ディレクトリ番号。 |
NetworkDeviceType
ネットワーク デバイスの種類。
| 列挙型 | |
|---|---|
NETWORK_DEVICE_TYPE_UNSPECIFIED |
ネットワーク デバイスの種類が指定されていません。 |
CELLULAR_DEVICE |
モバイル デバイス。 |
ETHERNET_DEVICE |
イーサネット デバイス。 |
WIFI_DEVICE |
Wifi デバイス。 |
NetworkStatusReport
表示/構成されたネットワークの状態。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportNetworkStatus で制御されます。
- データ収集の頻度: 60 分
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: はい
- 必要なきめ細かい権限: 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 ( |
| フィールド | |
|---|---|
reportTime |
出力専用。ネットワークの状態が報告された時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
sampleFrequency |
出力専用。レポートがサンプリングされる頻度。
|
signalStrengthDbm |
出力専用。ワイヤレス ネットワークの信号強度(デシベル単位)。 |
lanIpAddress |
出力専用。LAN の IP アドレス。 |
gatewayIpAddress |
出力専用。ゲートウェイ IP アドレス。 |
transmissionBitRateMbps |
出力専用。メガビット/秒で表される送信ビットレート。 |
receivingBitRateMbps |
出力専用。メガビット/秒で測定される受信ビットレート。 |
transmissionPowerDbm |
出力専用。デシベルで表される転送強度。 |
encryptionOn |
出力専用。Wi-Fi の暗号化キーが無効であるかどうか。 |
wifiLinkQuality |
出力専用。Wi-Fi のリンク品質。値の範囲は [0, 70] です。0 は信号がないことを示し、70 は信号が強いことを示します。 |
wifiPowerManagementEnabled |
出力専用。Wi-Fi 電源管理が有効 |
guid |
出力専用。ネットワーク接続の GUID。 |
connectionState |
出力専用。ネットワークの現在の接続状態。 |
connectionType |
出力専用。ネットワーク接続の種類。 |
ipv6Address[] |
出力専用。このネットワークに割り当てられた IPv6 アドレス(ある場合)。各アドレスは、標準の IPv6 テキスト表現(「2001:db8::1」など)の文字列です。 |
gatewayIpv6Address |
出力専用。検出された場合、このインターフェースのゲートウェイ IPv6 |
metered |
出力専用。ネットワークが従量制として検出されたかどうか。 |
linkDownSpeedKbps |
出力専用。ネットワーク インターフェースまたは接続によって報告された場合、1 秒あたりの最大ダウンストリーム帯域幅(Kbps)。 |
NetworkType
ネットワーク接続の種類。
| 列挙型 | |
|---|---|
NETWORK_TYPE_UNSPECIFIED |
ネットワーク接続の種類が指定されていない |
CELLULAR |
モバイル ネットワーク接続。 |
ETHERNET |
イーサネット ネットワーク接続。 |
TETHER |
テザリング ネットワーク接続。 |
VPN |
VPN ネットワーク接続。 |
WIFI |
Wi-Fi ネットワーク接続。 |
NetworkDiagnosticsReport
デバイスのネットワーク接続の状態を判断するためのネットワーク テストの結果(HTTPS のレイテンシが高いか正常かなど)。
- 必要なきめ細かい権限: TELEMETRY_API_NETWORK_REPORT
| JSON 表現 |
|---|
{
"reportTime": string,
"httpsLatencyData": {
object ( |
| フィールド | |
|---|---|
reportTime |
出力専用。診断情報が収集されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
httpsLatencyData |
出力専用。HTTPS レイテンシ テストデータ。 |
OsUpdateStatus
現在の OS アップデートのステータスに関する情報が含まれます。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceOsUpdateStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_OS_REPORT
| JSON 表現 |
|---|
{
"updateState": enum ( |
| フィールド | |
|---|---|
updateState |
出力専用。OS アップデートの現在の状態。 |
newPlatformVersion |
出力専用。新しいプラットフォーム バージョンの OS イメージがダウンロードされ、適用されています。更新ステータスが OS_IMAGE_DOWNLOAD_IN_PROGRESS または OS_UPDATE_NEED_REBOOT の場合にのみ設定されます。一部の例外的なケース(再起動せずに更新エンジンが再起動された場合など)では、OS_UPDATE_NEED_REBOOT ステータスに対してダミーの「0.0.0.0」が返されることがあります。 |
newRequestedPlatformVersion |
出力専用。保留中の更新済みキオスクアプリからリクエストされた新しいプラットフォーム バージョン。 |
lastUpdateTime |
出力専用。前回、更新が成功した際のタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
lastUpdateCheckTime |
出力専用。最終更新チェックのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
lastRebootTime |
出力専用。最後の再起動のタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
UpdateState
OS アップデートの状態
| 列挙型 | |
|---|---|
UPDATE_STATE_UNSPECIFIED |
状態が指定されていません。 |
OS_IMAGE_DOWNLOAD_NOT_STARTED |
OS がダウンロードを開始していません。 |
OS_IMAGE_DOWNLOAD_IN_PROGRESS |
OS がデバイス上でダウンロードを開始しました。 |
OS_UPDATE_NEED_REBOOT |
アップロードを完了するにはデバイスの再起動が必要です。 |
GraphicsInfo
グラフィック サブシステムの情報。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportDeviceGraphicsStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_GRAPHICS_INFO
| JSON 表現 |
|---|
{ "adapterInfo": { object ( |
| フィールド | |
|---|---|
adapterInfo |
出力専用。グラフィック アダプター(GPU)に関する情報。 |
eprivacySupported |
出力専用。e プライバシー画面がサポートされているかどうか。 |
displayDevices[] |
出力専用。デバイスのディスプレイに関する情報。 |
touchScreenInfo |
出力専用。デバイスの内部タッチ スクリーンに関する情報。 |
GraphicsAdapterInfo
グラフィック アダプター(GPU)の情報。
| JSON 表現 |
|---|
{ "adapter": string, "driverVersion": string, "deviceId": string } |
| フィールド | |
|---|---|
adapter |
出力専用。アダプターの名前。例: Mesa DRI Intel(R) UHD Graphics 620(Kabylake GT2)。 |
driverVersion |
出力専用。GPU ドライバのバージョン。 |
deviceId |
出力専用。グラフィック カードのデバイス ID を表します。 |
DisplayDevice
ディスプレイ デバイスの情報。
| JSON 表現 |
|---|
{ "displayName": string, "displayWidthMm": integer, "displayHeightMm": integer, "internal": boolean, "manufacturerId": string, "modelId": integer, "manufactureYear": integer, "serialNumber": integer, "edidVersion": string } |
| フィールド | |
|---|---|
displayName |
出力専用。デバイス名を表示します。 |
displayWidthMm |
出力専用。ディスプレイの幅(ミリメートル単位)。 |
displayHeightMm |
出力専用。ディスプレイの高さ(ミリメートル単位)。 |
internal |
出力専用。ディスプレイが内部かどうか。 |
manufacturerId |
出力専用。3 文字のメーカー ID。 |
modelId |
出力専用。メーカーのプロダクト コード。 |
manufactureYear |
出力専用。製造年。 |
serialNumber |
出力専用。シリアル番号。 |
edidVersion |
出力専用。EDID バージョン。 |
TouchScreenInfo
デバイスのタッチ スクリーンに関する情報。
| JSON 表現 |
|---|
{
"touchpadLibrary": string,
"devices": [
{
object ( |
| フィールド | |
|---|---|
touchpadLibrary |
出力専用。入力スタックで使用されるタッチパッド ライブラリ名。 |
devices[] |
出力専用。内蔵タッチ スクリーン デバイスのリスト。 |
TouchScreenDevice
内部タッチ スクリーン デバイスの情報。
| JSON 表現 |
|---|
{ "displayName": string, "touchPointCount": integer, "stylusCapable": boolean } |
| フィールド | |
|---|---|
displayName |
出力専用。タッチ スクリーン デバイスの表示名。 |
touchPointCount |
出力専用。デバイスでサポートされているタッチポイントの数。 |
stylusCapable |
出力専用。タッチ スクリーン デバイスがタッチペンに対応しているかどうか。 |
GraphicsStatusReport
グラフィック サブシステムの情報。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceGraphicsInfo で制御されます。
- データ収集頻度: 3 時間。
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_GRAPHICS_REPORT
| JSON 表現 |
|---|
{
"reportTime": string,
"displays": [
{
object ( |
| フィールド | |
|---|---|
reportTime |
出力専用。グラフィック データがレポートされた時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
displays[] |
出力専用。デバイスのディスプレイに関する情報。 |
DisplayInfo
ディスプレイの情報。
| JSON 表現 |
|---|
{ "deviceId": string, "resolutionWidth": integer, "resolutionHeight": integer, "refreshRate": integer, "isInternal": boolean, "displayName": string, "serialNumber": integer, "edidVersion": string } |
| フィールド | |
|---|---|
deviceId |
出力専用。グラフィック カードのデバイス ID を表します。 |
resolutionWidth |
出力専用。解像度の幅(ピクセル単位)。 |
resolutionHeight |
出力専用。解像度の高さ(ピクセル単位)。 |
refreshRate |
出力専用。リフレッシュ レート(Hz)。 |
isInternal |
出力専用。ディスプレイが内蔵かどうかを示します。 |
displayName |
出力専用。デバイス名を表示します。 |
serialNumber |
出力専用。シリアル番号。 |
edidVersion |
出力専用。EDID バージョン。 |
BatteryInfo
バッテリーに関する情報。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportDevicePowerStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_BATTERY_INFO
| JSON 表現 |
|---|
{
"serialNumber": string,
"manufacturer": string,
"designCapacity": string,
"designMinVoltage": integer,
"manufactureDate": {
object ( |
| フィールド | |
|---|---|
serialNumber |
出力専用。バッテリーのシリアル番号。 |
manufacturer |
出力専用。バッテリーのメーカー。 |
designCapacity |
出力専用。設計容量(ミリアンペア時)。 |
designMinVoltage |
出力専用。設計上の最小出力電圧(mV) |
manufactureDate |
出力専用。バッテリーの製造日。 |
technology |
出力専用。バッテリーのテクノロジー。例: リチウムイオン |
BatteryStatusReport
バッテリーのステータス データ。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDevicePowerStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_BATTERY_REPORT
| JSON 表現 |
|---|
{ "reportTime": string, "serialNumber": string, "sample": [ { object ( |
| フィールド | |
|---|---|
reportTime |
出力専用。デバイスでサンプルが収集されたときのタイムスタンプ RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
serialNumber |
出力専用。バッテリーのシリアル番号。 |
sample[] |
出力専用。 |
batteryHealth |
出力専用。バッテリー ヘルス。 |
fullChargeCapacity |
出力専用。フル充電容量(ミリアンペア時)。 |
cycleCount |
出力専用。循環棚卸。 |
BatterySampleReport
バッテリーのデータをサンプリングします。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDevicePowerStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
| JSON 表現 |
|---|
{ "reportTime": string, "voltage": string, "remainingCapacity": string, "temperature": integer, "dischargeRate": integer, "chargeRate": integer, "current": string, "status": string } |
| フィールド | |
|---|---|
reportTime |
出力専用。デバイスでサンプルが収集されたときのタイムスタンプ RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
voltage |
出力専用。バッテリーの電圧(ミリボルト)。 |
remainingCapacity |
出力専用。バッテリー残量(ミリアンペア時)。 |
temperature |
出力専用。温度(摂氏)。 |
dischargeRate |
出力専用。バッテリーの放電率は mW で表されます。バッテリーの放電中は正の値になり、充電中は負の値になります。 |
chargeRate |
出力専用。バッテリー残量(%)。 |
current |
出力専用。バッテリー電流(mA)。 |
status |
出力専用。sysfs から読み取ったバッテリーのステータス。例: 放電中 |
BatteryHealth
バッテリーの現在の状態を表します。
- このステータスは、バッテリーの欠陥を示すものではありません。現在のフル充電容量を設計容量で割って計算されます。
- バッテリーの完全性と保証ポリシーは、メーカーが定義します。
| 列挙型 | |
|---|---|
BATTERY_HEALTH_UNSPECIFIED |
ヘルス ステータスが不明です。 |
BATTERY_HEALTH_NORMAL |
バッテリーは正常です。フル充電容量 / 設計容量 > 80% |
BATTERY_REPLACE_SOON |
バッテリーの状態がやや悪い。早めに交換することが推奨される。フル充電容量 / 設計容量が 75%~ 80% |
BATTERY_REPLACE_NOW |
バッテリーの状態が良くなく、交換が推奨される。フル充電容量 / 設計容量 < 75% |
StorageInfo
ストレージのステータス データ。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceStorageStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_STORAGE_INFO
| JSON 表現 |
|---|
{
"volume": [
{
object ( |
| フィールド | |
|---|---|
volume[] |
ディスク ボリュームの情報 |
availableDiskBytes |
デバイスのユーザーデータ保存に利用できる容量(バイト単位)。 |
totalDiskBytes |
デバイス内のユーザー データ ストレージの合計容量(バイト単位)。 |
DiskVolume
ディスク ボリュームの情報
| JSON 表現 |
|---|
{ "volumeId": string, "storageFreeBytes": string, "storageTotalBytes": string } |
| フィールド | |
|---|---|
volumeId |
ディスク ボリューム ID。 |
storageFreeBytes |
空き容量(バイト単位)。 |
storageTotalBytes |
合計ストレージ容量(バイト単位)。 |
StorageStatusReport
ストレージのステータス データ。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceStorageStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_STORAGE_REPORT
| JSON 表現 |
|---|
{
"reportTime": string,
"disk": [
{
object ( |
| フィールド | |
|---|---|
reportTime |
出力専用。デバイスでサンプルが収集されたときのタイムスタンプ RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
disk[] |
出力専用。ディスク上のレポート。 |
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 |
出力専用。ディスクのシリアル番号。 |
manufacturer |
出力専用。ディスクのメーカー。 |
model |
出力専用。ディスクモデル。 |
sizeBytes |
出力専用。ディスクサイズ。 |
type |
出力専用。ディスクタイプ: eMMC / NVMe / ATA / SCSI。 |
health |
出力専用。ディスクの健全性。 |
volumeIds[] |
出力専用。ディスク ボリューム。 |
bytesReadThisSession |
出力専用。前回の起動以降に読み取られたバイト数。 |
bytesWrittenThisSession |
出力専用。前回の起動以降に書き込まれたバイト数。 |
readTimeThisSession |
出力専用。前回の起動以降にディスクからの読み取りに費やされた時間。
|
writeTimeThisSession |
出力専用。前回の起動以降にディスクへの書き込みに費やされた時間。
|
ioTimeThisSession |
出力専用。ディスクとキューがビジー状態だった時間をカウントします。上記のフィールドとは異なり、並列リクエストは複数回カウントされません。
|
discardTimeThisSession |
出力専用。前回の起動以降に破棄に費やされた時間。破棄とは、使用されなくなったクリアブロックに書き込むことです。カーネル 4.18 以降でサポートされています。
|
ThunderboltInfo
Thunderbolt バス情報。
- このフィールドには、静的で時間とともに変化しないデバイス情報が提供されます。
- このフィールドのデータは、ポリシー ReportDeviceSecurityStatus で制御されます。
- データ収集の頻度: デバイスの起動時
- デフォルトのデータ レポートの頻度: デバイスの起動時
- ポリシー制御: いいえ
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_BUS_DEVICE_INFO
| JSON 表現 |
|---|
{
"securityLevel": enum ( |
| フィールド | |
|---|---|
securityLevel |
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 コントローラと Display Port のトンネルを自動的に作成します。ドックの下流にあるすべての PCIe リンクが削除されます。 |
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL |
PCIE トンネリングが無効になっています。 |
BootPerformanceReport
デバイスの起動パフォーマンス レポート。
- このフィールドはテレメトリー情報であり、デバイスの使用状況に応じて変化します。
- このフィールドのデータは、ポリシー ReportDeviceBootMode で制御されます。
- データ収集の頻度: 起動イベントごと
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: はい
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_OS_REPORT
| JSON 表現 |
|---|
{
"bootUpDuration": string,
"bootUpTime": string,
"shutdownDuration": string,
"shutdownTime": string,
"shutdownReason": enum ( |
| フィールド | |
|---|---|
bootUpDuration |
起動にかかる合計時間。
|
bootUpTime |
電源がオンになったときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
shutdownDuration |
シャットダウン開始から電源オフまでの合計時間。
|
shutdownTime |
シャットダウン時のタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
shutdownReason |
シャットダウンの理由。 |
reportTime |
レポートが収集されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
ShutdownReason
シャットダウンの理由。
| 列挙型 | |
|---|---|
SHUTDOWN_REASON_UNSPECIFIED |
シャットダウンの理由が指定されていません。 |
USER_REQUEST |
ユーザーが開始。 |
SYSTEM_UPDATE |
システム アップデートを開始しました。 |
LOW_BATTERY |
バッテリー残量の低下によるシャットダウン。 |
OTHER |
その他の理由によるシャットダウン。 |
HeartbeatStatusReport
デバイスのハートビート ステータス レポート。
- キオスクで利用可能
- このフィールドは、デバイスのオンライン/オフライン/不明のステータスを提供します。ステータスが変更された場合(オンラインからオフラインなど)にのみ含まれます。
- このフィールドのデータは、HeartbeatEnabled ポリシーで制御されます。詳細
- Heartbeat Frequency: 2 mins
- 注: デバイスがオフラインになると、デバイスのオンライン ステータスが更新されるまでに最長で 12 分ほどかかることがあります。
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます。該当なし
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
| JSON 表現 |
|---|
{
"reportTime": string,
"state": enum ( |
| フィールド | |
|---|---|
reportTime |
ステータスの変更が検出されたときのタイムスタンプ RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
state |
デバイスの変更後の状態 |
州
デバイスの状態
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
状態が指定されていません |
UNKNOWN |
デバイスが心拍数モニタリングの対象外である |
ONLINE |
デバイスがオンラインである |
OFFLINE |
デバイスはオフラインです |
DEVICE_OUTDATED |
デバイスが古い |
KioskAppStatusReport
デバイスのキオスクアプリのステータス レポート。
- キオスクで利用可能
- このフィールドには、キオスク デバイスで実行されているアプリの ID とバージョン番号、レポートが最後に更新されたときのタイムスタンプが提供されます。
- このフィールドのデータは、ポリシー ReportDeviceSessionStatus で制御されます。
- データ収集の頻度: アップロード時のみ
- デフォルトのデータ レポートの頻度: 3 時間
- ポリシー制御: はい
- キャッシュ: デバイスがオフラインの場合、収集されたデータはローカルに保存され、デバイスが次にオンラインになったときにレポートされます: いいえ
- 関連付けられているユーザーにのみ報告: N/A
- 必要なきめ細かい権限: TELEMETRY_API_APPS_REPORT
| JSON 表現 |
|---|
{ "reportTime": string, "appId": string, "appVersion": string } |
| フィールド | |
|---|---|
reportTime |
レポートが収集されたときのタイムスタンプ RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
appId |
キオスクアプリのアプリ ID(例: "mdmkkicfmmkgmpkmkdikhlbggogpicma") |
appVersion |
キオスクアプリのアプリ バージョン番号(「1.10.118」など) |
RuntimeCountersReport
CPU から取得したランタイム カウンタ。現在、ランタイム カウンタのテレメトリーは、第 14 世代以降の Intel vPro PSR でのみサポートされています。
| JSON 表現 |
|---|
{ "reportTime": string, "uptimeRuntimeDuration": string, "enterSleepCount": string, "enterHibernationCount": string, "enterPoweroffCount": string } |
| フィールド | |
|---|---|
reportTime |
レポートが収集されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
uptimeRuntimeDuration |
合計ライフタイム ランタイム。現在、Intel vPro PSR の S0 ランタイムが常に返されます。
|
enterSleepCount |
デバイスがスリープ状態になった回数。現在は PSR 経由で取得され、S0->S3 からカウントされます。 |
enterHibernationCount |
デバイスが休止状態に入った回数。現在は PSR 経由で取得され、S0 から S4 までのカウントです。 |
enterPoweroffCount |
デバイスが電源オフ状態になった回数。現在は PSR 経由で取得され、S0 から S5 までのカウントです。 |
メソッド |
|
|---|---|
|
テレメトリー デバイスを取得します。 |
|
すべてのテレメトリー デバイスを一覧表示します。 |