Close httplib2 connections.
get(name, readMask=None, x__xgafv=None)
Get telemetry device.
list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)
List all telemetry devices.
Retrieves the next page of results.
close()
Close httplib2 connections.
get(name, readMask=None, x__xgafv=None)
Get telemetry device.
Args:
name: string, Required. Name of the `TelemetryDevice` to return. (required)
readMask: string, Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE
"appReport": [ # Output only. App reports collected periodically sorted in a decreasing order of report_time.
{ # App report.
"reportTime": "A String", # Timestamp when the report was collected.
"usageData": [ # App usage data.
{ # App usage data.
"appId": "A String", # App id.
"appInstanceId": "A String", # Application instance id. This will be unique per window/instance.
"appType": "A String", # Type of app.
"runningDuration": "A String", # App foreground running time.
},
],
},
],
"audioStatusReport": [ # Output only. Audio reports collected periodically sorted in a decreasing order of report_time.
{ # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_AUDIO_REPORT
"inputDevice": "A String", # Output only. Active input device's name.
"inputGain": 42, # Output only. Active input device's gain in [0, 100].
"inputMute": True or False, # Output only. Is active input device mute or not.
"outputDevice": "A String", # Output only. Active output device's name.
"outputMute": True or False, # Output only. Is active output device mute or not.
"outputVolume": 42, # Output only. Active output device's volume in [0, 100].
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device.
},
],
"batteryInfo": [ # Output only. Information on battery specs for the device.
{ # Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_INFO
"designCapacity": "A String", # Output only. Design capacity (mAmpere-hours).
"designMinVoltage": 42, # Output only. Designed minimum output voltage (mV)
"manufactureDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date the battery was manufactured.
"day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"manufacturer": "A String", # Output only. Battery manufacturer.
"serialNumber": "A String", # Output only. Battery serial number.
"technology": "A String", # Output only. Technology of the battery. Example: Li-ion
},
],
"batteryStatusReport": [ # Output only. Battery reports collected periodically.
{ # Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_REPORT
"batteryHealth": "A String", # Output only. Battery health.
"cycleCount": 42, # Output only. Cycle count.
"fullChargeCapacity": "A String", # Output only. Full charge capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"sample": [ # Output only. Sampling data for the battery sorted in a decreasing order of report_time.
{ # Sampling data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"chargeRate": 42, # Output only. Battery charge percentage.
"current": "A String", # Output only. Battery current (mA).
"dischargeRate": 42, # Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.
"remainingCapacity": "A String", # Output only. Battery remaining capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"status": "A String", # Output only. Battery status read from sysfs. Example: Discharging
"temperature": 42, # Output only. Temperature in Celsius degrees.
"voltage": "A String", # Output only. Battery voltage (millivolt).
},
],
"serialNumber": "A String", # Output only. Battery serial number.
},
],
"bootPerformanceReport": [ # Output only. Boot performance reports of the device.
{ # Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"bootUpDuration": "A String", # Total time to boot up.
"bootUpTime": "A String", # The timestamp when power came on.
"reportTime": "A String", # Timestamp when the report was collected.
"shutdownDuration": "A String", # Total time since shutdown start to power off.
"shutdownReason": "A String", # The shutdown reason.
"shutdownTime": "A String", # The timestamp when shutdown.
},
],
"cpuInfo": [ # Output only. Information regarding CPU specs for the device.
{ # CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_INFO
"architecture": "A String", # Output only. Architecture type for the CPU. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"keylockerConfigured": True or False, # Output only. Whether keylocker is configured.`TRUE` = Enabled; `FALSE` = disabled. Only reported if keylockerSupported = `TRUE`.
"keylockerSupported": True or False, # Output only. Whether keylocker is supported.
"maxClockSpeed": 42, # Output only. The max CPU clock speed in kHz.
"model": "A String", # Output only. The CPU model name. Example: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
},
],
"cpuStatusReport": [ # Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.
{ # Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_REPORT
"cpuTemperatureInfo": [ # Output only. CPU temperature sample info per CPU core in Celsius
{ # CPU temperature of a device. Sampled per CPU core in Celsius. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"label": "A String", # Output only. CPU label. Example: Core 0
"temperatureCelsius": 42, # Output only. CPU temperature in Celsius.
},
],
"cpuUtilizationPct": 42, # Output only. Sample of CPU utilization (0-100 percent).
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
},
],
"customer": "A String", # Output only. Google Workspace Customer whose enterprise enrolled the device.
"deviceId": "A String", # Output only. The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab
"graphicsInfo": { # Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_INFO # Output only. Contains information regarding Graphic peripherals for the device.
"adapterInfo": { # Information of a graphics adapter (GPU). # Output only. Information about the graphics adapter (GPU).
"adapter": "A String", # Output only. Adapter name. Example: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
"deviceId": "A String", # Output only. Represents the graphics card device id.
"driverVersion": "A String", # Output only. Version of the GPU driver.
},
"displayDevices": [ # Output only. Information about the display(s) of the device.
{ # Information of a display device.
"displayHeightMm": 42, # Output only. Display height in millimeters.
"displayName": "A String", # Output only. Display device name.
"displayWidthMm": 42, # Output only. Display width in millimeters.
"internal": True or False, # Output only. Is display internal or not.
"manufactureYear": 42, # Output only. Year of manufacture.
"manufacturerId": "A String", # Output only. Three letter manufacturer ID.
"modelId": 42, # Output only. Manufacturer product code.
},
],
"eprivacySupported": True or False, # Output only. Is ePrivacy screen supported or not.
"touchScreenInfo": { # Information on the device touch screen. # Output only. Information about the internal touch screen(s) of the device.
"devices": [ # Output only. List of the internal touch screen devices.
{ # Information of an internal touch screen device.
"displayName": "A String", # Output only. Touch screen device display name.
"stylusCapable": True or False, # Output only. Touch screen device is stylus capable or not.
"touchPointCount": 42, # Output only. Number of touch points supported on the device.
},
],
"touchpadLibrary": "A String", # Output only. Touchpad library name used by the input stack.
},
},
"graphicsStatusReport": [ # Output only. Graphics reports collected periodically.
{ # Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_REPORT
"displays": [ # Output only. Information about the displays for the device.
{ # Information for a display.
"deviceId": "A String", # Output only. Represents the graphics card device id.
"displayName": "A String", # Output only. Display device name.
"isInternal": True or False, # Output only. Indicates if display is internal or not.
"refreshRate": 42, # Output only. Refresh rate in Hz.
"resolutionHeight": 42, # Output only. Resolution height in pixels.
"resolutionWidth": 42, # Output only. Resolution width in pixels.
},
],
"reportTime": "A String", # Output only. Time at which the graphics data was reported.
},
],
"heartbeatStatusReport": [ # Output only. Heartbeat status report containing timestamps periodically sorted in decreasing order of report_time
{ # Heartbeat status report of a device. * Available for Kiosks * This field provides online/offline/unknown status of a device and will only be included if the status has changed (e.g. Online -> Offline) * Data for this field is controlled via policy: [HeartbeatEnabled](https://chromeenterprise.google/policies/#HeartbeatEnabled) [More Info](https://support.google.com/chrome/a/answer/6179663#:~:text=On%20the%20Chrome,device%20status%20alerts) * Heartbeat Frequency: 2 mins * Note: If a device goes offline, it can take up to 12 minutes for the online status of the device to be updated * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: N/A * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
"reportTime": "A String", # Timestamp of when status changed was detected
"state": "A String", # State the device changed to
},
],
"kioskAppStatusReport": [ # Output only. Kiosk app status report for the kiosk device
{ # Kiosk app status report of a device. * Available for Kiosks * This field provides the app id and version number running on a kiosk device and the timestamp of when the report was last updated * Data for this field is controlled via policy: [ReportDeviceSessionStatus](https://chromeenterprise.google/policies/#ReportDeviceSessionStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_APPS_REPORT
"appId": "A String", # App id of kiosk app for example "mdmkkicfmmkgmpkmkdikhlbggogpicma"
"appVersion": "A String", # App version number of kiosk app for example "1.10.118"
"reportTime": "A String", # Timestamp of when report was collected
},
],
"memoryInfo": { # Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_INFO # Output only. Information regarding memory specs for the device.
"availableRamBytes": "A String", # Output only. Amount of available RAM in bytes.
"totalMemoryEncryption": { # Memory encryption information of a device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A # Output only. Total memory encryption info for the device.
"encryptionAlgorithm": "A String", # Memory encryption algorithm.
"encryptionState": "A String", # The state of memory encryption on the device.
"keyLength": "A String", # The length of the encryption keys.
"maxKeys": "A String", # The maximum number of keys that can be used for encryption.
},
"totalRamBytes": "A String", # Output only. Total RAM in bytes.
},
"memoryStatusReport": [ # Output only. Memory status reports collected periodically sorted decreasing by report_time.
{ # Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_REPORT
"pageFaults": 42, # Output only. Number of page faults during this collection
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"systemRamFreeBytes": "A String", # Output only. Amount of free RAM in bytes (unreliable due to Garbage Collection).
},
],
"name": "A String", # Output only. Resource name of the device.
"networkBandwidthReport": [ # Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time.
{ # Network bandwidth report. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"downloadSpeedKbps": "A String", # Output only. Download speed in kilobits per second.
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
},
],
"networkDiagnosticsReport": [ # Output only. Network diagnostics collected periodically.
{ # Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"httpsLatencyData": { # Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites. # Output only. HTTPS latency test data.
"latency": "A String", # Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY.
"problem": "A String", # Output only. HTTPS latency routine problem if a problem occurred.
},
"reportTime": "A String", # Output only. Timestamp of when the diagnostics were collected.
},
],
"networkInfo": { # Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_NETWORK_INFO # Output only. Network devices information.
"networkDevices": [ # Output only. List of network devices.
{ # Details about the network device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A
"iccid": "A String", # Output only. The integrated circuit card ID associated with the device's sim card.
"imei": "A String", # Output only. IMEI (if applicable) of the corresponding network device.
"macAddress": "A String", # Output only. MAC address (if applicable) of the corresponding network device.
"mdn": "A String", # Output only. The mobile directory number associated with the device's sim card.
"meid": "A String", # Output only. MEID (if applicable) of the corresponding network device.
"type": "A String", # Output only. Network device type.
},
],
},
"networkStatusReport": [ # Output only. Network specs collected periodically.
{ # State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"connectionState": "A String", # Output only. Current connection state of the network.
"connectionType": "A String", # Output only. Network connection type.
"encryptionOn": True or False, # Output only. Whether the wifi encryption key is turned off.
"gatewayIpAddress": "A String", # Output only. Gateway IP address.
"guid": "A String", # Output only. Network connection guid.
"lanIpAddress": "A String", # Output only. LAN IP address.
"receivingBitRateMbps": "A String", # Output only. Receiving bit rate measured in Megabits per second.
"reportTime": "A String", # Output only. Time at which the network state was reported.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"signalStrengthDbm": 42, # Output only. Signal strength for wireless networks measured in decibels.
"transmissionBitRateMbps": "A String", # Output only. Transmission bit rate measured in Megabits per second.
"transmissionPowerDbm": 42, # Output only. Transmission power measured in decibels.
"wifiLinkQuality": "A String", # Output only. Wifi link quality. Value ranges from [0, 70]. 0 indicates no signal and 70 indicates a strong signal.
"wifiPowerManagementEnabled": True or False, # Output only. Wifi power management enabled
},
],
"orgUnitId": "A String", # Output only. Organization unit ID of the device.
"osUpdateStatus": [ # Output only. Contains relevant information regarding ChromeOS update status.
{ # Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"lastRebootTime": "A String", # Output only. Timestamp of the last reboot.
"lastUpdateCheckTime": "A String", # Output only. Timestamp of the last update check.
"lastUpdateTime": "A String", # Output only. Timestamp of the last successful update.
"newPlatformVersion": "A String", # Output only. New platform version of the os image being downloaded and applied. It is only set when update status is OS_IMAGE_DOWNLOAD_IN_PROGRESS or OS_UPDATE_NEED_REBOOT. Note this could be a dummy "0.0.0.0" for OS_UPDATE_NEED_REBOOT status for some edge cases, e.g. update engine is restarted without a reboot.
"newRequestedPlatformVersion": "A String", # Output only. New requested platform version from the pending updated kiosk app.
"updateState": "A String", # Output only. Current state of the os update.
},
],
"peripheralsReport": [ # Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.
{ # Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
"usbPeripheralReport": [ # Reports of all usb connected devices.
{ # USB connected peripheral report.
"categories": [ # Output only. Categories the device belongs to https://www.usb.org/defined-class-codes
"A String",
],
"classId": 42, # Output only. Class ID https://www.usb.org/defined-class-codes
"firmwareVersion": "A String", # Output only. Firmware version
"name": "A String", # Output only. Device name, model name, or product name
"pid": 42, # Output only. Product ID
"subclassId": 42, # Output only. Subclass ID https://www.usb.org/defined-class-codes
"vendor": "A String", # Output only. Vendor name
"vid": 42, # Output only. Vendor ID
},
],
},
],
"runtimeCountersReport": [ # Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0->S3, S0->S4, and S0->S5 transitions, meaning entering into sleep, hibernation, and power-off states
{ # Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+.
"enterHibernationCount": "A String", # Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0->S4.
"enterPoweroffCount": "A String", # Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0->S5.
"enterSleepCount": "A String", # Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0->S3.
"reportTime": "A String", # Timestamp when the report was collected.
"uptimeRuntimeDuration": "A String", # Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR.
},
],
"serialNumber": "A String", # Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab.
"storageInfo": { # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO # Output only. Information of storage specs for the device.
"availableDiskBytes": "A String", # The available space for user data storage in the device in bytes.
"totalDiskBytes": "A String", # The total space for user data storage in the device in bytes.
"volume": [ # Information for disk volumes
{ # Information for disk volumes
"storageFreeBytes": "A String", # Free storage space in bytes.
"storageTotalBytes": "A String", # Total storage space in bytes.
"volumeId": "A String", # Disk volume id.
},
],
},
"storageStatusReport": [ # Output only. Storage reports collected periodically.
{ # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_REPORT
"disk": [ # Output only. Reports on disk.
{ # Status of the single storage device.
"bytesReadThisSession": "A String", # Output only. Number of bytes read since last boot.
"bytesWrittenThisSession": "A String", # Output only. Number of bytes written since last boot.
"discardTimeThisSession": "A String", # Output only. Time spent discarding since last boot. Discarding is writing to clear blocks which are no longer in use. Supported on kernels 4.18+.
"health": "A String", # Output only. Disk health.
"ioTimeThisSession": "A String", # Output only. Counts the time the disk and queue were busy, so unlike the fields above, parallel requests are not counted multiple times.
"manufacturer": "A String", # Output only. Disk manufacturer.
"model": "A String", # Output only. Disk model.
"readTimeThisSession": "A String", # Output only. Time spent reading from disk since last boot.
"serialNumber": "A String", # Output only. Disk serial number.
"sizeBytes": "A String", # Output only. Disk size.
"type": "A String", # Output only. Disk type: eMMC / NVMe / ATA / SCSI.
"volumeIds": [ # Output only. Disk volumes.
"A String",
],
"writeTimeThisSession": "A String", # Output only. Time spent writing to disk since last boot.
},
],
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
},
],
"thunderboltInfo": [ # Output only. Information on Thunderbolt bus.
{ # Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BUS_DEVICE_INFO
"securityLevel": "A String", # Security level of the Thunderbolt bus.
},
],
}
list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)
List all telemetry devices.
Args:
parent: string, Required. Customer id or "my_customer" to use the customer associated to the account making the request. (required)
filter: string, Optional. Only include resources that match the filter. Requests that don't specify a "reports_timestamp" value will default to returning only recent reports. Specify "reports_timestamp>=0" to get all report data. Supported filter fields: - org_unit_id - serial_number - device_id - reports_timestamp The "reports_timestamp" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC "Zulu" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".
pageSize: integer, Maximum number of results to return. Default value is 100. Maximum value is 1000.
pageToken: string, Token to specify next page in the list.
readMask: string, Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"devices": [ # Telemetry devices returned in the response.
{ # Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE
"appReport": [ # Output only. App reports collected periodically sorted in a decreasing order of report_time.
{ # App report.
"reportTime": "A String", # Timestamp when the report was collected.
"usageData": [ # App usage data.
{ # App usage data.
"appId": "A String", # App id.
"appInstanceId": "A String", # Application instance id. This will be unique per window/instance.
"appType": "A String", # Type of app.
"runningDuration": "A String", # App foreground running time.
},
],
},
],
"audioStatusReport": [ # Output only. Audio reports collected periodically sorted in a decreasing order of report_time.
{ # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_AUDIO_REPORT
"inputDevice": "A String", # Output only. Active input device's name.
"inputGain": 42, # Output only. Active input device's gain in [0, 100].
"inputMute": True or False, # Output only. Is active input device mute or not.
"outputDevice": "A String", # Output only. Active output device's name.
"outputMute": True or False, # Output only. Is active output device mute or not.
"outputVolume": 42, # Output only. Active output device's volume in [0, 100].
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device.
},
],
"batteryInfo": [ # Output only. Information on battery specs for the device.
{ # Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_INFO
"designCapacity": "A String", # Output only. Design capacity (mAmpere-hours).
"designMinVoltage": 42, # Output only. Designed minimum output voltage (mV)
"manufactureDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date the battery was manufactured.
"day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"manufacturer": "A String", # Output only. Battery manufacturer.
"serialNumber": "A String", # Output only. Battery serial number.
"technology": "A String", # Output only. Technology of the battery. Example: Li-ion
},
],
"batteryStatusReport": [ # Output only. Battery reports collected periodically.
{ # Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_REPORT
"batteryHealth": "A String", # Output only. Battery health.
"cycleCount": 42, # Output only. Cycle count.
"fullChargeCapacity": "A String", # Output only. Full charge capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"sample": [ # Output only. Sampling data for the battery sorted in a decreasing order of report_time.
{ # Sampling data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"chargeRate": 42, # Output only. Battery charge percentage.
"current": "A String", # Output only. Battery current (mA).
"dischargeRate": 42, # Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.
"remainingCapacity": "A String", # Output only. Battery remaining capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"status": "A String", # Output only. Battery status read from sysfs. Example: Discharging
"temperature": 42, # Output only. Temperature in Celsius degrees.
"voltage": "A String", # Output only. Battery voltage (millivolt).
},
],
"serialNumber": "A String", # Output only. Battery serial number.
},
],
"bootPerformanceReport": [ # Output only. Boot performance reports of the device.
{ # Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"bootUpDuration": "A String", # Total time to boot up.
"bootUpTime": "A String", # The timestamp when power came on.
"reportTime": "A String", # Timestamp when the report was collected.
"shutdownDuration": "A String", # Total time since shutdown start to power off.
"shutdownReason": "A String", # The shutdown reason.
"shutdownTime": "A String", # The timestamp when shutdown.
},
],
"cpuInfo": [ # Output only. Information regarding CPU specs for the device.
{ # CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_INFO
"architecture": "A String", # Output only. Architecture type for the CPU. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"keylockerConfigured": True or False, # Output only. Whether keylocker is configured.`TRUE` = Enabled; `FALSE` = disabled. Only reported if keylockerSupported = `TRUE`.
"keylockerSupported": True or False, # Output only. Whether keylocker is supported.
"maxClockSpeed": 42, # Output only. The max CPU clock speed in kHz.
"model": "A String", # Output only. The CPU model name. Example: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
},
],
"cpuStatusReport": [ # Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.
{ # Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_REPORT
"cpuTemperatureInfo": [ # Output only. CPU temperature sample info per CPU core in Celsius
{ # CPU temperature of a device. Sampled per CPU core in Celsius. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A
"label": "A String", # Output only. CPU label. Example: Core 0
"temperatureCelsius": 42, # Output only. CPU temperature in Celsius.
},
],
"cpuUtilizationPct": 42, # Output only. Sample of CPU utilization (0-100 percent).
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
},
],
"customer": "A String", # Output only. Google Workspace Customer whose enterprise enrolled the device.
"deviceId": "A String", # Output only. The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab
"graphicsInfo": { # Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_INFO # Output only. Contains information regarding Graphic peripherals for the device.
"adapterInfo": { # Information of a graphics adapter (GPU). # Output only. Information about the graphics adapter (GPU).
"adapter": "A String", # Output only. Adapter name. Example: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
"deviceId": "A String", # Output only. Represents the graphics card device id.
"driverVersion": "A String", # Output only. Version of the GPU driver.
},
"displayDevices": [ # Output only. Information about the display(s) of the device.
{ # Information of a display device.
"displayHeightMm": 42, # Output only. Display height in millimeters.
"displayName": "A String", # Output only. Display device name.
"displayWidthMm": 42, # Output only. Display width in millimeters.
"internal": True or False, # Output only. Is display internal or not.
"manufactureYear": 42, # Output only. Year of manufacture.
"manufacturerId": "A String", # Output only. Three letter manufacturer ID.
"modelId": 42, # Output only. Manufacturer product code.
},
],
"eprivacySupported": True or False, # Output only. Is ePrivacy screen supported or not.
"touchScreenInfo": { # Information on the device touch screen. # Output only. Information about the internal touch screen(s) of the device.
"devices": [ # Output only. List of the internal touch screen devices.
{ # Information of an internal touch screen device.
"displayName": "A String", # Output only. Touch screen device display name.
"stylusCapable": True or False, # Output only. Touch screen device is stylus capable or not.
"touchPointCount": 42, # Output only. Number of touch points supported on the device.
},
],
"touchpadLibrary": "A String", # Output only. Touchpad library name used by the input stack.
},
},
"graphicsStatusReport": [ # Output only. Graphics reports collected periodically.
{ # Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_REPORT
"displays": [ # Output only. Information about the displays for the device.
{ # Information for a display.
"deviceId": "A String", # Output only. Represents the graphics card device id.
"displayName": "A String", # Output only. Display device name.
"isInternal": True or False, # Output only. Indicates if display is internal or not.
"refreshRate": 42, # Output only. Refresh rate in Hz.
"resolutionHeight": 42, # Output only. Resolution height in pixels.
"resolutionWidth": 42, # Output only. Resolution width in pixels.
},
],
"reportTime": "A String", # Output only. Time at which the graphics data was reported.
},
],
"heartbeatStatusReport": [ # Output only. Heartbeat status report containing timestamps periodically sorted in decreasing order of report_time
{ # Heartbeat status report of a device. * Available for Kiosks * This field provides online/offline/unknown status of a device and will only be included if the status has changed (e.g. Online -> Offline) * Data for this field is controlled via policy: [HeartbeatEnabled](https://chromeenterprise.google/policies/#HeartbeatEnabled) [More Info](https://support.google.com/chrome/a/answer/6179663#:~:text=On%20the%20Chrome,device%20status%20alerts) * Heartbeat Frequency: 2 mins * Note: If a device goes offline, it can take up to 12 minutes for the online status of the device to be updated * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: N/A * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
"reportTime": "A String", # Timestamp of when status changed was detected
"state": "A String", # State the device changed to
},
],
"kioskAppStatusReport": [ # Output only. Kiosk app status report for the kiosk device
{ # Kiosk app status report of a device. * Available for Kiosks * This field provides the app id and version number running on a kiosk device and the timestamp of when the report was last updated * Data for this field is controlled via policy: [ReportDeviceSessionStatus](https://chromeenterprise.google/policies/#ReportDeviceSessionStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_APPS_REPORT
"appId": "A String", # App id of kiosk app for example "mdmkkicfmmkgmpkmkdikhlbggogpicma"
"appVersion": "A String", # App version number of kiosk app for example "1.10.118"
"reportTime": "A String", # Timestamp of when report was collected
},
],
"memoryInfo": { # Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_INFO # Output only. Information regarding memory specs for the device.
"availableRamBytes": "A String", # Output only. Amount of available RAM in bytes.
"totalMemoryEncryption": { # Memory encryption information of a device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A # Output only. Total memory encryption info for the device.
"encryptionAlgorithm": "A String", # Memory encryption algorithm.
"encryptionState": "A String", # The state of memory encryption on the device.
"keyLength": "A String", # The length of the encryption keys.
"maxKeys": "A String", # The maximum number of keys that can be used for encryption.
},
"totalRamBytes": "A String", # Output only. Total RAM in bytes.
},
"memoryStatusReport": [ # Output only. Memory status reports collected periodically sorted decreasing by report_time.
{ # Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_REPORT
"pageFaults": 42, # Output only. Number of page faults during this collection
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"systemRamFreeBytes": "A String", # Output only. Amount of free RAM in bytes (unreliable due to Garbage Collection).
},
],
"name": "A String", # Output only. Resource name of the device.
"networkBandwidthReport": [ # Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time.
{ # Network bandwidth report. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"downloadSpeedKbps": "A String", # Output only. Download speed in kilobits per second.
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
},
],
"networkDiagnosticsReport": [ # Output only. Network diagnostics collected periodically.
{ # Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"httpsLatencyData": { # Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites. # Output only. HTTPS latency test data.
"latency": "A String", # Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY.
"problem": "A String", # Output only. HTTPS latency routine problem if a problem occurred.
},
"reportTime": "A String", # Output only. Timestamp of when the diagnostics were collected.
},
],
"networkInfo": { # Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_NETWORK_INFO # Output only. Network devices information.
"networkDevices": [ # Output only. List of network devices.
{ # Details about the network device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A
"iccid": "A String", # Output only. The integrated circuit card ID associated with the device's sim card.
"imei": "A String", # Output only. IMEI (if applicable) of the corresponding network device.
"macAddress": "A String", # Output only. MAC address (if applicable) of the corresponding network device.
"mdn": "A String", # Output only. The mobile directory number associated with the device's sim card.
"meid": "A String", # Output only. MEID (if applicable) of the corresponding network device.
"type": "A String", # Output only. Network device type.
},
],
},
"networkStatusReport": [ # Output only. Network specs collected periodically.
{ # State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"connectionState": "A String", # Output only. Current connection state of the network.
"connectionType": "A String", # Output only. Network connection type.
"encryptionOn": True or False, # Output only. Whether the wifi encryption key is turned off.
"gatewayIpAddress": "A String", # Output only. Gateway IP address.
"guid": "A String", # Output only. Network connection guid.
"lanIpAddress": "A String", # Output only. LAN IP address.
"receivingBitRateMbps": "A String", # Output only. Receiving bit rate measured in Megabits per second.
"reportTime": "A String", # Output only. Time at which the network state was reported.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"signalStrengthDbm": 42, # Output only. Signal strength for wireless networks measured in decibels.
"transmissionBitRateMbps": "A String", # Output only. Transmission bit rate measured in Megabits per second.
"transmissionPowerDbm": 42, # Output only. Transmission power measured in decibels.
"wifiLinkQuality": "A String", # Output only. Wifi link quality. Value ranges from [0, 70]. 0 indicates no signal and 70 indicates a strong signal.
"wifiPowerManagementEnabled": True or False, # Output only. Wifi power management enabled
},
],
"orgUnitId": "A String", # Output only. Organization unit ID of the device.
"osUpdateStatus": [ # Output only. Contains relevant information regarding ChromeOS update status.
{ # Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"lastRebootTime": "A String", # Output only. Timestamp of the last reboot.
"lastUpdateCheckTime": "A String", # Output only. Timestamp of the last update check.
"lastUpdateTime": "A String", # Output only. Timestamp of the last successful update.
"newPlatformVersion": "A String", # Output only. New platform version of the os image being downloaded and applied. It is only set when update status is OS_IMAGE_DOWNLOAD_IN_PROGRESS or OS_UPDATE_NEED_REBOOT. Note this could be a dummy "0.0.0.0" for OS_UPDATE_NEED_REBOOT status for some edge cases, e.g. update engine is restarted without a reboot.
"newRequestedPlatformVersion": "A String", # Output only. New requested platform version from the pending updated kiosk app.
"updateState": "A String", # Output only. Current state of the os update.
},
],
"peripheralsReport": [ # Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.
{ # Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
"usbPeripheralReport": [ # Reports of all usb connected devices.
{ # USB connected peripheral report.
"categories": [ # Output only. Categories the device belongs to https://www.usb.org/defined-class-codes
"A String",
],
"classId": 42, # Output only. Class ID https://www.usb.org/defined-class-codes
"firmwareVersion": "A String", # Output only. Firmware version
"name": "A String", # Output only. Device name, model name, or product name
"pid": 42, # Output only. Product ID
"subclassId": 42, # Output only. Subclass ID https://www.usb.org/defined-class-codes
"vendor": "A String", # Output only. Vendor name
"vid": 42, # Output only. Vendor ID
},
],
},
],
"runtimeCountersReport": [ # Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0->S3, S0->S4, and S0->S5 transitions, meaning entering into sleep, hibernation, and power-off states
{ # Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+.
"enterHibernationCount": "A String", # Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0->S4.
"enterPoweroffCount": "A String", # Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0->S5.
"enterSleepCount": "A String", # Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0->S3.
"reportTime": "A String", # Timestamp when the report was collected.
"uptimeRuntimeDuration": "A String", # Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR.
},
],
"serialNumber": "A String", # Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab.
"storageInfo": { # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO # Output only. Information of storage specs for the device.
"availableDiskBytes": "A String", # The available space for user data storage in the device in bytes.
"totalDiskBytes": "A String", # The total space for user data storage in the device in bytes.
"volume": [ # Information for disk volumes
{ # Information for disk volumes
"storageFreeBytes": "A String", # Free storage space in bytes.
"storageTotalBytes": "A String", # Total storage space in bytes.
"volumeId": "A String", # Disk volume id.
},
],
},
"storageStatusReport": [ # Output only. Storage reports collected periodically.
{ # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_REPORT
"disk": [ # Output only. Reports on disk.
{ # Status of the single storage device.
"bytesReadThisSession": "A String", # Output only. Number of bytes read since last boot.
"bytesWrittenThisSession": "A String", # Output only. Number of bytes written since last boot.
"discardTimeThisSession": "A String", # Output only. Time spent discarding since last boot. Discarding is writing to clear blocks which are no longer in use. Supported on kernels 4.18+.
"health": "A String", # Output only. Disk health.
"ioTimeThisSession": "A String", # Output only. Counts the time the disk and queue were busy, so unlike the fields above, parallel requests are not counted multiple times.
"manufacturer": "A String", # Output only. Disk manufacturer.
"model": "A String", # Output only. Disk model.
"readTimeThisSession": "A String", # Output only. Time spent reading from disk since last boot.
"serialNumber": "A String", # Output only. Disk serial number.
"sizeBytes": "A String", # Output only. Disk size.
"type": "A String", # Output only. Disk type: eMMC / NVMe / ATA / SCSI.
"volumeIds": [ # Output only. Disk volumes.
"A String",
],
"writeTimeThisSession": "A String", # Output only. Time spent writing to disk since last boot.
},
],
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
},
],
"thunderboltInfo": [ # Output only. Information on Thunderbolt bus.
{ # Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BUS_DEVICE_INFO
"securityLevel": "A String", # Security level of the Thunderbolt bus.
},
],
},
],
"nextPageToken": "A String", # Token to specify next page in the list.
}
list_next()
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.