Update gam print crostelemetry

This commit is contained in:
Ross Scroggs
2026-05-29 19:44:49 -07:00
parent 22d70ca2c3
commit 3e9b46b650
4 changed files with 40 additions and 16 deletions

View File

@@ -185,25 +185,30 @@ gam oauth create
<CrOSActivityListFieldNameList> ::= "<CrOSActivityListFieldName>(,<CrOSActivityListFieldName>)*" <CrOSActivityListFieldNameList> ::= "<CrOSActivityListFieldName>(,<CrOSActivityListFieldName>)*"
<CrOSTelemetryFieldName> ::= <CrOSTelemetryFieldName> ::=
appreport|
audiostatusreport| audiostatusreport|
batteryinfo| batteryinfo|
batterystatusreport| batterystatusreport|
bootPerformancereport| bootperformancereport|
cpuinfo| cpuinfo|
cpustatusreport| cpustatusreport|
customer| customer|
deviceid| deviceid|
graphicsinfo| graphicsinfo|
graphicsstatusreport| graphicsstatusreport|
heartbeatstatusreport|
kioskappstatusreport|
memoryinfo| memoryinfo|
memorystatusreport| memorystatusreport|
name| name|
networkbandwidthreport|
networkdiagnosticsreport| networkdiagnosticsreport|
networkinfo| networkinfo|
networkstatusreport| networkstatusreport|
orgunitid| orgunitid|
osupdatestatus| osupdatestatus|
peripheralsreport| peripheralsreport|
runtimecountersreport|
serialnumber| serialnumber|
storageinfo| storageinfo|
storagestatusreport| storagestatusreport|
@@ -211,20 +216,22 @@ gam oauth create
<CrOSTelemetryFieldNameList> ::= "<CrOSTelemetryFieldName>(,<CrOSTelemetryFieldName>)*" <CrOSTelemetryFieldNameList> ::= "<CrOSTelemetryFieldName>(,<CrOSTelemetryFieldName>)*"
<CrOSTelemetryListFieldName> ::= <CrOSTelemetryListFieldName> ::=
appreport|
audiostatusreport| audiostatusreport|
batteryinfo|
batterystatusreport| batterystatusreport|
bootperformancereport| bootperformancereport|
cpuinfo|
cpustatusreport| cpustatusreport|
graphicsstatusreport| graphicsstatusreport|
heartbeatstatusreport|
kioskappstatusreport|
memorystatusreport| memorystatusreport|
networkbandwidthreport|
networkdiagnosticsreport| networkdiagnosticsreport|
networkstatusreport| networkstatusreport|
osupdatestatus| osupdatestatus|
peripheralsreport| peripheralsreport|
storagestatusreport| runtimecountersreport|
thunderboltinfo storagestatusreport
<CrOSTelemetryListFieldNameList> ::= "<CrOSTelemetryListFieldName>(,<CrOSTelemetryLIstFieldName>)*" <CrOSTelemetryListFieldNameList> ::= "<CrOSTelemetryListFieldName>(,<CrOSTelemetryLIstFieldName>)*"
``` ```
@@ -964,19 +971,21 @@ By default, Gam displays the information as an indented list of keys and values:
gam print crostelemetry [todrive <ToDriveAttribute>*] gam print crostelemetry [todrive <ToDriveAttribute>*]
[(ou|org|orgunit|ou_and_children <OrgUnitItem>)|(cros_sn <SerialNumber>)|(filter <String>)] [(ou|org|orgunit|ou_and_children <OrgUnitItem>)|(cros_sn <SerialNumber>)|(filter <String>)]
<CrOSTelemetryFieldName>* [fields <CrOSTelemetryFieldNameList>] <CrOSTelemetryFieldName>* [fields <CrOSTelemetryFieldNameList>]
[reverselists <CrOSTelemetryListFieldNameList>] [reverselists <CrOSTelemetryListFieldNameList>] [oneitemperrow]
[start <Date>] [end <Date>] [listlimit <Number>] [start <Date>] [end <Date>] [listlimit <Number>]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```
Use these options to select CrOS devices; if none are chosen, all CrOS devices in the account are selected. Use these options to select CrOS devices; if none are chosen, all CrOS devices in the account are selected.
- `ou|org|orgunit <OrgUnitItem>` - Select CrOS devices directly in the OU `<OrgUnitItem>` - `ou|org|orgunit <OrgUnitItem>` - Select CrOS devices directly in the OU `<OrgUnitItem>`
- `ou_and_children <OrgUnitItem>` - Select CrOS devices in the OU `<OrgUnitItem>` and its sub OUs - `ou_and_children <OrgUnitItem>` - Select CrOS devices in the OU `<OrgUnitItem>` and its sub OUs
- `cros_sn <SerialNumber>` - Select the CrOS device with serial number `<SerialNumber>`. - `cros_sn <SerialNumber>` - Select the CrOS device with serial number `<SerialNumber>`.
- `filter <String>` - Select the CrOS device with a filter. - `filter <String>` - Select the CrOS device with a filter.
Use these options to limit/modify the displayed lists.
- `listlimit <Number>` - Limits the number of repetitions to `<Number>`; if not specified or `<Number>` equals zero, there is no limit. - `listlimit <Number>` - Limits the number of repetitions to `<Number>`; if not specified or `<Number>` equals zero, there is no limit.
- `start <Date>` and `end <Date>` - Constrain list `reportTime` to fall within the specified `<Dates>`. If a `<Date>` isn't specified, there is no filtering in that range. - `start <Date>` and `end <Date>` - Constrain list `reportTime` to fall within the specified `<Dates>`. If a `<Date>` isn't specified, there is no filtering in that range.
- `reverselists <CrOSTelemetryListFieldNameList>` - For each list, change order from ascending (oldest to newest) to descending (newest to oldest); this makes it easy to get the `N` most recent values with `listlimit N reverselists cpustatusreport,memorystatusreport` - `reverselists <CrOSTelemetryListFieldNameList>` - For each list, change order from descending (newest to oldest) to ascending (oldest to newest)
- `oneitemrerrow` - Display each instance of a list item on a separate row; by default, all list items are displayed on a single row
By default, all telemetry data is displayed, use the following to select specific fields: By default, all telemetry data is displayed, use the following to select specific fields:
- `<CrOSTelemetryFieldName>*` - Specify fields individually - `<CrOSTelemetryFieldName>*` - Specify fields individually

View File

@@ -10,6 +10,21 @@ Add the `-s` option to the end of the above commands to suppress creating the `g
See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation
### 7.44.01
Added option `oneitemperrow` to `gam print crostelemetry` to have each of a device's
report field entries displayed on a separate row with all of the other device fields.
Added additional fields to `<CrOSTelemetryFieldName>`and `<CrOSTelemetryListFieldName>`:
Added additional fields to `<CrOSTelemetryFieldName>`:
```
appreport
heartbeatstatusreport
kioskappstatusreport
networkbandwidthreport
runtimecountersreport
```
### 7.44.00 ### 7.44.00
Added support for User data `archivalTime` and `suspensionTime` that is available Added support for User data `archivalTime` and `suspensionTime` that is available

View File

@@ -251,7 +251,7 @@ writes the credentials into the file oauth2.txt.
``` ```
gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt
gamteam@server:/Users/gamteam$ gam version gamteam@server:/Users/gamteam$ gam version
GAM 7.44.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.44.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
macOS Tahoe 26.5 arm64 macOS Tahoe 26.5 arm64
@@ -1034,7 +1034,7 @@ writes the credentials into the file oauth2.txt.
``` ```
C:\>del C:\GAMConfig\oauth2.txt C:\>del C:\GAMConfig\oauth2.txt
C:\>gam version C:\>gam version
GAM 7.44.00 - https://github.com/GAM-team/GAM - pythonsource GAM 7.44.01 - https://github.com/GAM-team/GAM - pythonsource
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
Windows 11 10.0.26200 AMD64 Windows 11 10.0.26200 AMD64

View File

@@ -3,7 +3,7 @@
Print the current version of Gam with details Print the current version of Gam with details
``` ```
gam version gam version
GAM 7.44.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.44.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
macOS Tahoe 26.5 arm64 macOS Tahoe 26.5 arm64
@@ -15,7 +15,7 @@ Time: 2026-02-15T07:51:00-08:00
Print the current version of Gam with details and time offset information Print the current version of Gam with details and time offset information
``` ```
gam version timeoffset gam version timeoffset
GAM 7.44.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.44.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
macOS Tahoe 26.5 arm64 macOS Tahoe 26.5 arm64
@@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second
Print the current version of Gam with extended details and SSL information Print the current version of Gam with extended details and SSL information
``` ```
gam version extended gam version extended
GAM 7.44.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.44.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
macOS Tahoe 26.5 arm64 macOS Tahoe 26.5 arm64
@@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64
Path: /Users/gamteam/bin/gam7 Path: /Users/gamteam/bin/gam7
Version Check: Version Check:
Current: 5.35.08 Current: 5.35.08
Latest: 7.44.00 Latest: 7.44.01
echo $? echo $?
1 1
``` ```
@@ -76,7 +76,7 @@ echo $?
Print the current version number without details Print the current version number without details
``` ```
gam version simple gam version simple
7.44.00 7.44.01
``` ```
In Linux/MacOS you can do: In Linux/MacOS you can do:
``` ```
@@ -86,7 +86,7 @@ echo $VER
Print the current version of Gam and address of this Wiki Print the current version of Gam and address of this Wiki
``` ```
gam help gam help
GAM 7.44.00 - https://github.com/GAM-team/GAM GAM 7.44.01 - https://github.com/GAM-team/GAM
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.5 64-bit final Python 3.14.5 64-bit final
macOS Tahoe 26.5 arm64 macOS Tahoe 26.5 arm64