REST Resource: customers.telemetry.devices

Ressource: TelemetryDevice

Telemetriedaten, die von einem verwalteten Gerät erhoben werden.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE
JSON-Darstellung 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
Felder
name

string

Nur Ausgabe. Ressourcenname des Geräts.
customer

string

Nur Ausgabe. Google Workspace-Kunde, in dessen Unternehmen das Gerät registriert wurde.
orgUnitId

string

Nur Ausgabe. ID der Organisationseinheit des Geräts.
deviceId

string

Nur Ausgabe. Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der ID der Directory API der Admin-Konsole auf dem Tab „ChromeOS-Geräte“
serialNumber

string

Nur Ausgabe. Seriennummer des Geräts Dieser Wert entspricht der Seriennummer der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
cpuInfo[]

object (CpuInfo)

Nur Ausgabe. Informationen zu den CPU-Spezifikationen für das Gerät.
cpuStatusReport[]

object (CpuStatusReport)

Nur Ausgabe. Die regelmäßig erfassten CPU-Statusberichte werden in absteigender Reihenfolge von reportTime sortiert.
memoryInfo

object (MemoryInfo)

Nur Ausgabe. Informationen zu den Speicherspezifikationen des Geräts.
memoryStatusReport[]

object (MemoryStatusReport)

Nur Ausgabe. Die erfassten Arbeitsspeicherstatusberichte werden regelmäßig absteigend nach reportTime sortiert.
networkInfo

object (NetworkInfo)

Nur Ausgabe. Informationen zu Netzwerkgeräten.
networkStatusReport[]

object (NetworkStatusReport)

Nur Ausgabe. Regelmäßig erfasste Netzwerkspezifikationen.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Nur Ausgabe. Die Netzwerkdiagnose wird in regelmäßigen Abständen erfasst.
osUpdateStatus[]

object (OsUpdateStatus)

Nur Ausgabe. Enthält relevante Informationen zum ChromeOS-Updatestatus.
graphicsInfo

object (GraphicsInfo)

Nur Ausgabe. Enthält Informationen zu grafischen Peripheriegeräten für das Gerät.
graphicsStatusReport[]

object (GraphicsStatusReport)

Nur Ausgabe. Grafikberichte, die in regelmäßigen Abständen erfasst werden.
batteryInfo[]

object (BatteryInfo)

Nur Ausgabe. Informationen zu den Akkuspezifikationen des Geräts.
batteryStatusReport[]

object (BatteryStatusReport)

Nur Ausgabe. Akkuberichte, die in regelmäßigen Abständen erfasst werden.
storageInfo

object (StorageInfo)

Nur Ausgabe. Informationen zu Speicherspezifikationen für das Gerät.
storageStatusReport[]

object (StorageStatusReport)

Nur Ausgabe. Speicherberichte, die in regelmäßigen Abständen erfasst werden.
thunderboltInfo[]

object (ThunderboltInfo)

Nur Ausgabe. Informationen zum Thunderbolt-Bus.
audioStatusReport[]

object (AudioStatusReport)

Nur Ausgabe. In regelmäßigen Abständen erfasste Audioberichte werden in absteigender Reihenfolge von reportTime sortiert.
bootPerformanceReport[]

object (BootPerformanceReport)

Nur Ausgabe. Leistungsberichte des Geräts starten
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Nur Ausgabe. Heartbeat-Statusbericht mit Zeitstempeln, die regelmäßig in absteigender Reihenfolge von reportTime sortiert sind
kioskAppStatusReport[]

object (KioskAppStatusReport)

Nur Ausgabe. Statusbericht zu Kiosk-Apps für das Kioskgerät
networkBandwidthReport[]

object (NetworkBandwidthReport)

Nur Ausgabe. Die regelmäßig erfassten Berichte zur Netzwerkbandbreite werden in absteigender Reihenfolge von reportTime sortiert.
peripheralsReport[]

object (PeripheralsReport)

Nur Ausgabe. Die regelmäßig erfassten Berichte zu Peripheriegeräten werden in absteigender Reihenfolge von reportTime sortiert.
appReport[]

object (AppReport)

Nur Ausgabe. Die regelmäßig erfassten App-Berichte werden in absteigender Reihenfolge von reportTime sortiert.
runtimeCountersReport[]

object (RuntimeCountersReport)

Nur Ausgabe. Laufzeitzähler melden die erfasste Geräte-Lebensdauerlaufzeit sowie die Anzahl der Übergänge von S0->S3, S0->S4 und S0->S5, d. h. in den Ruhemodus, dem Ruhezustand und dem Ausschalten.

CpuInfo

CPU-Spezifikationen für das Gerät

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceCpuInfo
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_CPU_INFO
JSON-Darstellung 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Felder
model

string

Nur Ausgabe. Der Name des CPU-Modells. Beispiel: Intel(R) Core(TM) i5-8250U CPU mit 1,60 GHz
architecture

enum (Architecture)

Nur Ausgabe. Architekturtyp für die CPU.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceCpuInfo
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
maxClockSpeed

integer

Nur Ausgabe. Die maximale CPU-Taktgeschwindigkeit in kHz.
keylockerSupported

boolean

Nur Ausgabe. Gibt an, ob Keylocker unterstützt wird.
keylockerConfigured

boolean

Nur Ausgabe. Gibt an, ob Keylocker konfiguriert ist.TRUE = Aktiviert; FALSE = deaktiviert. Wird nur gemeldet, wenn „keylockerSupported = TRUE“ ausgewählt ist.

Architektur

Architekturtyp für die CPU.

Enums
ARCHITECTURE_UNSPECIFIED Architektur unbekannt.
X64 x64-Architektur

CpuStatusReport

Liefert Informationen zum Status der CPU.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceCpuInfo
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_CPU_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel in Millisekunden, der den Zeitpunkt angibt, zu dem die Stichprobe für diesen Bericht erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe. Häufigkeit der Stichprobenerhebung für den Bericht

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
cpuUtilizationPct

integer

Nur Ausgabe. Beispiel für CPU-Auslastung (0–100 %).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Nur Ausgabe. CPU-Temperaturbeispielinformationen pro CPU-Kern in Celsius

CpuTemperatureInfo

CPU-Temperatur eines Geräts. Stichproben pro CPU-Kern in Celsius.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceCpuInfo
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "temperatureCelsius": integer,
  "label": string
}
Felder
temperatureCelsius

integer

Nur Ausgabe. CPU-Temperatur in Celsius.
label

string

Nur Ausgabe. CPU-Label. Beispiel: Kern 0

MemoryInfo

Informationen zum Arbeitsspeicher eines Geräts.

  • Dieses Feld enthält sowohl Telemetrie- als auch Geräteinformationen: <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes – Geräteinformationen
    • availableRamBytes – Telemetriedaten
    • totalMemoryEncryption – Geräteinformationen
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceMemoryInfo
  • Häufigkeit der Datenerhebung: <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes – nur beim Upload
    • availableRamBytes – alle 10 Minuten
    • totalMemoryEncryption: beim Gerätestart
  • Standardmäßige Häufigkeit für Datenberichte: <ph type="x-smartling-placeholder">
      </ph>
    • totalRamBytes–3 Stunden
    • availableRamBytes–3 Stunden
    • totalMemoryEncryption: beim Gerätestart
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: nur für totalMemoryEncryption
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_INFO
JSON-Darstellung 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Felder
totalRamBytes

string (int64 format)

Nur Ausgabe. RAM insgesamt in Byte.
availableRamBytes

string (int64 format)

Nur Ausgabe. Menge des verfügbaren RAM in Byte.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Nur Ausgabe. Die gesamten Informationen zur Arbeitsspeicherverschlüsselung für das Gerät.

TotalMemoryEncryptionInfo

Informationen zur Speicherverschlüsselung eines Geräts.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceMemoryInfo
  • Häufigkeit der Datenerfassung: beim Start des Geräts
  • Standardhäufigkeit für Datenberichte: beim Gerätestart <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Felder
encryptionState

enum (MemoryEncryptionState)

Der Status der Speicherverschlüsselung auf dem Gerät.
maxKeys

string (int64 format)

Die maximale Anzahl von Schlüsseln, die für die Verschlüsselung verwendet werden können.
keyLength

string (int64 format)

Die Länge der Verschlüsselungsschlüssel.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Speicherverschlüsselungsalgorithmus.

MemoryEncryptionState

Der Status der Speicherverschlüsselung auf dem Gerät.

Enums
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Der Verschlüsselungsstatus des Arbeitsspeichers ist nicht festgelegt.
MEMORY_ENCRYPTION_STATE_UNKNOWN Der Verschlüsselungsstatus des Arbeitsspeichers ist unbekannt.
MEMORY_ENCRYPTION_STATE_DISABLED Die Speicherverschlüsselung ist auf dem Gerät deaktiviert.
MEMORY_ENCRYPTION_STATE_TME Die Speicherverschlüsselung auf dem Gerät verwendet die Gesamtspeicherverschlüsselung.
MEMORY_ENCRYPTION_STATE_MKTME Die Speicherverschlüsselung auf dem Gerät verwendet die Verschlüsselung des Gesamtarbeitsspeichers mit mehreren Schlüsseln.

MemoryEncryptionAlgorithm

Der auf dem Gerät verwendete Verschlüsselungsalgorithmus.

Enums
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED Speicherverschlüsselungsalgorithmus ist nicht festgelegt.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Der verwendete Speicherverschlüsselungsalgorithmus ist unbekannt.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 Der Speicherverschlüsselungsalgorithmus verwendet den AES_XTS-Verschlüsselungsalgorithmus mit einer 128-Bit-Blockverschlüsselung.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 Der Speicherverschlüsselungsalgorithmus verwendet den AES_XTS-Verschlüsselungsalgorithmus mit einer 256-Bit-Blockverschlüsselung.

MemoryStatusReport

Enthält Beispiele für Arbeitsspeicherstatusberichte.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceMemoryInfo
  • Häufigkeit der Datenerfassung: Nur beim Upload wird SystemRamFreeByes alle 10 Minuten erfasst.
  • Standardmäßige Häufigkeit für Datenberichte: alle 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel in Millisekunden, der den Zeitpunkt angibt, zu dem die Stichprobe für diesen Bericht erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe. Häufigkeit der Stichprobenerhebung für den Bericht

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
systemRamFreeBytes

string (int64 format)

Nur Ausgabe. Menge des kostenlosen RAM in Byte (nicht zuverlässig aufgrund der automatischen Speicherbereinigung).
pageFaults

integer

Nur Ausgabe. Anzahl der Seitenfehler während dieser Sammlung

NetworkInfo

Netzwerkgeräteinformationen.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerfassung: beim Start des Geräts
  • Standardhäufigkeit für Datenberichte: beim Gerätestart <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_INFO
JSON-Darstellung 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Felder
networkDevices[]

object (NetworkDevice)

Nur Ausgabe. Liste der Netzwerkgeräte.

NetworkDevice

Details zum Netzwerkgerät

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerfassung: beim Start des Geräts
  • Standardhäufigkeit für Datenberichte: beim Gerätestart <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Felder
type

enum (NetworkDeviceType)

Nur Ausgabe. Netzwerkgerätetyp.
macAddress

string

Nur Ausgabe. MAC-Adresse (falls zutreffend) des entsprechenden Netzwerkgeräts.
meid

string

Nur Ausgabe. MEID (falls zutreffend) des entsprechenden Netzwerkgeräts.
imei

string

Nur Ausgabe. IMEI (falls zutreffend) des entsprechenden Netzwerkgeräts.
iccid

string

Nur Ausgabe. Die ID der integrierten Schaltkreiskarte, die mit der SIM-Karte des Geräts verknüpft ist.
mdn

string

Nur Ausgabe. Die Mobiltelefonnummer, die mit der SIM-Karte des Geräts verknüpft ist

NetworkDeviceType

Typen von Netzwerkgeräten.

Enums
NETWORK_DEVICE_TYPE_UNSPECIFIED Der Netzwerkgerätetyp ist nicht angegeben.
CELLULAR_DEVICE Mobilfunkgerät.
ETHERNET_DEVICE Ethernet-Gerät.
WIFI_DEVICE Wifi-Gerät.

NetworkStatusReport

Status sichtbarer/konfigurierter Netzwerke.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkStatus gesteuert.
  • Häufigkeit der Datenerhebung: 60 Minuten
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: Ja
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem der Netzwerkstatus gemeldet wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

Nur Ausgabe. Häufigkeit der Stichprobenerhebung für den Bericht

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
signalStrengthDbm

integer

Nur Ausgabe. Signalstärke bei drahtlosen Netzwerken, gemessen in Dezibel.
lanIpAddress

string

Nur Ausgabe. LAN-IP-Adresse.
gatewayIpAddress

string

Nur Ausgabe. Gateway-IP-Adresse.
transmissionBitRateMbps

string (int64 format)

Nur Ausgabe. Die Übertragungs-Bitrate, gemessen in Megabit pro Sekunde.
receivingBitRateMbps

string (int64 format)

Nur Ausgabe. Die Empfangsbitrate, gemessen in Megabit pro Sekunde.
transmissionPowerDbm

integer

Nur Ausgabe. Übertragungsleistung, gemessen in Dezibel.
encryptionOn

boolean

Nur Ausgabe. Gibt an, ob der WLAN-Verschlüsselungsschlüssel deaktiviert ist.
wifiPowerManagementEnabled

boolean

Nur Ausgabe. WLAN-Energiesparmodus aktiviert
guid

string

Nur Ausgabe. Anleitung für die Netzwerkverbindung.
connectionState

enum (NetworkConnectionState)

Nur Ausgabe. Aktueller Verbindungsstatus des Netzwerks.
connectionType

enum (NetworkType)

Nur Ausgabe. Art der Netzwerkverbindung.

NetworkType

Netzwerkverbindungstypen.

Enums
NETWORK_TYPE_UNSPECIFIED Netzwerkverbindungstyp nicht angegeben
CELLULAR Mobilfunkverbindung.
ETHERNET Ethernet-Netzwerkverbindung.
TETHER Tethering-Netzwerkverbindung.
VPN VPN-Netzwerkverbindung.
WIFI WLAN-Netzwerkverbindung.

NetworkDiagnosticsReport

Ergebnisse von Netzwerktests zur Bestimmung des Zustands der Netzwerkverbindung des Geräts, z. B. ob die HTTPS-Latenz hoch oder normal ist.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel, der angibt, wann die Diagnose erfasst wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
httpsLatencyData

object (HttpsLatencyRoutineData)

Nur Ausgabe. HTTPS-Latenztestdaten.

OsUpdateStatus

Enthält Informationen zum aktuellen Updatestatus des Betriebssystems.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceOsUpdateStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_OS_REPORT
JSON-Darstellung 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Felder
updateState

enum (UpdateState)

Nur Ausgabe. Aktueller Status des Betriebssystemupdates.
newPlatformVersion

string

Nur Ausgabe. Neue Plattformversion des Betriebssystem-Images, das heruntergeladen und angewendet wird Sie wird nur festgelegt, wenn der Updatestatus OS_IMAGE_DOWNLOAD_IN_PROGRESS oder OS_UPDATE_NEED_REBOOT ist. Beachten Sie, dass dies ein Dummy-Element "0.0.0.0" sein kann. für den Status OS_UPDATE_NEED_REBOOT in einigen Grenzfällen, z.B. die Update-Engine ohne Neustart neu gestartet wird.
newRequestedPlatformVersion

string

Nur Ausgabe. Neue angeforderte Plattformversion von der ausstehenden aktualisierten Kiosk-App.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten erfolgreichen Aktualisierung.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastUpdateCheckTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Updateprüfung.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
lastRebootTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel des letzten Neustarts.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

UpdateState

Status des Betriebssystemupdates

Enums
UPDATE_STATE_UNSPECIFIED Status nicht angegeben.
OS_IMAGE_DOWNLOAD_NOT_STARTED Der Download des Betriebssystems wurde nicht gestartet.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Das Betriebssystem hat den Download auf das Gerät gestartet.
OS_UPDATE_NEED_REBOOT Das Gerät muss neu gestartet werden, um den Upload abzuschließen.

GraphicsInfo

Informationen zum Grafiksubsystem.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_INFO
JSON-Darstellung 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Felder
adapterInfo

object (GraphicsAdapterInfo)

Nur Ausgabe. Informationen zur Grafikkarte (GPU).
eprivacySupported

boolean

Nur Ausgabe. Wird der ePrivacy-Bildschirm unterstützt oder nicht?
displayDevices[]

object (DisplayDevice)

Nur Ausgabe. Informationen zu den Displays des Geräts.
touchScreenInfo

object (TouchScreenInfo)

Nur Ausgabe. Informationen zu den internen Touchscreens des Geräts.

GraphicsAdapterInfo

Informationen zur Grafikkarte (GPU).

JSON-Darstellung 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Felder
adapter

string

Nur Ausgabe. Name des Adapters. Beispiel: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

Nur Ausgabe. Version des GPU-Treibers.
deviceId

string (int64 format)

Nur Ausgabe. Geräte-ID der Grafikkarte

DisplayDevice

Informationen zu einem Anzeigegerät.

JSON-Darstellung 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
Felder
displayName

string

Nur Ausgabe. Anzeige des Gerätenamens.
displayWidthMm

integer

Nur Ausgabe. Anzeigebreite in Millimetern.
displayHeightMm

integer

Nur Ausgabe. Die Höhe wird in Millimetern angezeigt.
internal

boolean

Nur Ausgabe. Ist das Display intern oder nicht.
manufacturerId

string

Nur Ausgabe. Aus drei Buchstaben bestehende Hersteller-ID.
modelId

integer

Nur Ausgabe. Produktcode des Herstellers.
manufactureYear

integer

Nur Ausgabe. Herstellungsjahr.

TouchScreenInfo

Informationen auf dem Touchscreen des Geräts.

JSON-Darstellung 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Felder
touchpadLibrary

string

Nur Ausgabe. Der vom Eingabestapel verwendete Name der Touchpad-Bibliothek.
devices[]

object (TouchScreenDevice)

Nur Ausgabe. Liste der internen Touchscreen-Geräte.

TouchScreenDevice

Informationen zu einem internen Touchscreen-Gerät.

JSON-Darstellung 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Felder
displayName

string

Nur Ausgabe. Anzeigename des Touchscreengeräts
touchPointCount

integer

Nur Ausgabe. Anzahl der auf dem Gerät unterstützten Touchpoints.
stylusCapable

boolean

Nur Ausgabe. Touchscreengeräte sind mit Eingabestift kompatibel oder nicht.

GraphicsStatusReport

Informationen zum Grafiksubsystem.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceGraphicsInfo
  • Häufigkeit der Datenerhebung: 3 Stunden.
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die Grafikdaten gemeldet wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
displays[]

object (DisplayInfo)

Nur Ausgabe. Informationen zu den Displays für das Gerät.

DisplayInfo

Informationen zu einem Display.

JSON-Darstellung 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
Felder
deviceId

string (int64 format)

Nur Ausgabe. Geräte-ID der Grafikkarte
resolutionWidth

integer

Nur Ausgabe. Auflösungsbreite in Pixeln.
resolutionHeight

integer

Nur Ausgabe. Auflösungshöhe in Pixeln.
refreshRate

integer

Nur Ausgabe. Aktualisierungsrate in Hz.
isInternal

boolean

Nur Ausgabe. Gibt an, ob das Display intern ist oder nicht.
displayName

string

Nur Ausgabe. Anzeige des Gerätenamens.

BatteryInfo

Informationen zum Akku.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BATTERY_INFO
JSON-Darstellung 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Felder
serialNumber

string

Nur Ausgabe. Seriennummer des Akkus.
manufacturer

string

Nur Ausgabe. Hersteller des Akkus.
designCapacity

string (int64 format)

Nur Ausgabe. Designkapazität (mAmpere-Stunden).
designMinVoltage

integer

Nur Ausgabe. Ausgewiesene minimale Ausgangsspannung (mV)
manufactureDate

object (Date)

Nur Ausgabe. Das Datum, an dem der Akku hergestellt wurde.
technology

string

Nur Ausgabe. Technologie des Akkus. Beispiel: Li-Ionen

BatteryStatusReport

Statusdaten für Akku.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BATTERY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel, der angibt, wann die Probe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
serialNumber

string

Nur Ausgabe. Seriennummer des Akkus.
sample[]

object (BatterySampleReport)

Nur Ausgabe. Die Stichprobendaten für den Akku werden in absteigender Reihenfolge von reportTime sortiert.
batteryHealth

enum (BatteryHealth)

Nur Ausgabe. Akkuzustand.
fullChargeCapacity

string (int64 format)

Nur Ausgabe. Volle Ladekapazität (mAmpere-Stunden).
cycleCount

integer

Nur Ausgabe. Anzahl der Ladezyklen.

BatterySampleReport

Stichprobendaten für Akku.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel, der angibt, wann die Probe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
voltage

string (int64 format)

Nur Ausgabe. Akkuspannung (Millivolt).
remainingCapacity

string (int64 format)

Nur Ausgabe. Verbleibende Akkukapazität (mAmpere-Stunden).
temperature

integer

Nur Ausgabe. Temperatur in Celsius
dischargeRate

integer

Nur Ausgabe. Die in mW gemessene Entladerate des Akkus. Positiv, wenn der Akku entladen wird, negativ, wenn er geladen wird.
chargeRate

integer

Nur Ausgabe. Akkustand in Prozent.
current

string (int64 format)

Nur Ausgabe. Akkustrom (mA).
status

string

Nur Ausgabe. Der Akkustatus wurde von Sysfs gelesen. Beispiel: Entladung

BatteryHealth

Stellt den aktuellen Akkuzustand dar.

  • Dieser Status ist weder eine Anzeige noch ein Hinweis auf einen defekten Akku. Sie wird berechnet, indem die aktuelle volle Ladekapazität durch die Designkapazität geteilt wird.
  • Der Hersteller legt die Integrität des Akkus und die Garantierichtlinien fest.
Enums
BATTERY_HEALTH_UNSPECIFIED Zustand unbekannt.
BATTERY_HEALTH_NORMAL Akku ist fehlerfrei, volle Ladekapazität / Designkapazität > 80%
BATTERY_REPLACE_SOON Akku ist mäßig fehlerhaft und wird empfohlen, bald gewechselt zu werden, volle Ladekapazität / Designkapazität 75–80 %
BATTERY_REPLACE_NOW Akku ist fehlerhaft und wird empfohlen, volle Ladekapazität / Designkapazität < 75%

StorageInfo

Zu speichernde Statusdaten.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceStorageStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_INFO
JSON-Darstellung 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Felder
volume[]

object (DiskVolume)

Informationen zu Laufwerks-Volumes
availableDiskBytes

string (int64 format)

Der verfügbare Speicherplatz für Nutzerdaten auf dem Gerät in Byte.
totalDiskBytes

string (int64 format)

Der Gesamtspeicherplatz für Nutzerdaten auf dem Gerät in Byte.

DiskVolume

Informationen zu Laufwerks-Volumes

JSON-Darstellung 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Felder
volumeId

string

Laufwerk-Volume-ID.
storageFreeBytes

string (int64 format)

Freier Speicherplatz in Byte.
storageTotalBytes

string (int64 format)

Gesamtspeicherplatz in Byte.

StorageStatusReport

Zu speichernde Statusdaten.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceStorageStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel, der angibt, wann die Probe auf dem Gerät erfasst wurde

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
disk[]

object (DiskInfo)

Nur Ausgabe. Berichtet das Laufwerk.

DiskInfo

Status des einzelnen Speichergeräts.

JSON-Darstellung 
{
  "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
}
Felder
serialNumber

string

Nur Ausgabe. Seriennummer des Laufwerks.
manufacturer

string

Nur Ausgabe. Hersteller des Laufwerks
model

string

Nur Ausgabe. Laufwerksmodell.
sizeBytes

string (int64 format)

Nur Ausgabe. Laufwerkgröße
type

string

Nur Ausgabe. Laufwerkstyp: eMMC / NVMe / ATA / SCSI.
health

string

Nur Ausgabe. Laufwerkzustand.
volumeIds[]

string

Nur Ausgabe. Laufwerks-Volumes
bytesReadThisSession

string (int64 format)

Nur Ausgabe. Anzahl der seit dem letzten Start gelesenen Byte.
bytesWrittenThisSession

string (int64 format)

Nur Ausgabe. Anzahl der seit dem letzten Bootvorgang geschriebenen Byte.
readTimeThisSession

string (Duration format)

Nur Ausgabe. Zeit für das Lesen vom Laufwerk seit dem letzten Start.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
writeTimeThisSession

string (Duration format)

Nur Ausgabe. Zeitaufwand für das Schreiben auf das Laufwerk seit dem letzten Start.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
ioTimeThisSession

string (Duration format)

Nur Ausgabe. Zählt, wie lange das Laufwerk und die Warteschlange ausgelastet waren. Im Gegensatz zu den oben genannten Feldern werden parallele Anfragen also nicht mehrfach gezählt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
discardTimeThisSession

string (Duration format)

Nur Ausgabe. Zeit zum Verwerfen seit dem letzten Start. Beim Verwerfen werden nicht mehr verwendete Blöcke gelöscht. Unterstützt auf Kernel 4.18 und höher.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

ThunderboltInfo

Thunderbolt-Businfos.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceSecurityStatus gesteuert.
  • Häufigkeit der Datenerfassung: beim Start des Geräts
  • Standardhäufigkeit für Datenberichte: beim Gerätestart <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Nein
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BUS_DEVICE_INFO
JSON-Darstellung 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Felder
securityLevel

enum (ThunderboltSecurityLevel)

Das Sicherheitsniveau des Thunderbolt-Busses.

ThunderboltSecurityLevel

Das Sicherheitsniveau des Thunderbolt-Busses.

Enums
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Das Sicherheitsniveau von Thunderbolt ist nicht festgelegt.
THUNDERBOLT_SECURITY_NONE_LEVEL Alle Geräte werden automatisch über die Firmware verbunden. Eine Nutzergenehmigung ist nicht erforderlich.
THUNDERBOLT_SECURITY_USER_LEVEL Der Nutzer wird gefragt, ob das Gerät verbunden werden darf.
THUNDERBOLT_SECURITY_SECURE_LEVEL Der Nutzer wird gefragt, ob das Gerät verbunden werden darf. Darüber hinaus wird dem Gerät eine Identitätsbestätigung gesendet, die mit der erwarteten Abfrage übereinstimmen sollte. Grundlage ist ein zufälliger Schlüssel, der in das Schlüsselattribut sysfs geschrieben wird.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Die Firmware erstellt automatisch Tunnel für Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Die Firmware erstellt automatisch Tunnel für den USB-Controller und den Displayport in einem Dock. Alle PCIe-Links, die dem Dock nachgeschaltet sind, werden entfernt.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIE-Tunneling ist deaktiviert.

BootPerformanceReport

Startleistungsbericht für ein Gerät

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceBootMode gesteuert.
  • Häufigkeit der Datenerfassung: bei jedem Start
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_OS_REPORT
JSON-Darstellung 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Felder
bootUpDuration

string (Duration format)

Gesamtzeit für den Start.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
bootUpTime

string (Timestamp format)

Zeitstempel für das Einschalten des Geräts.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
shutdownDuration

string (Duration format)

Gesamtzeit seit dem Start des Ausschaltens.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
shutdownTime

string (Timestamp format)

Zeitstempel für das Herunterfahren.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
shutdownReason

enum (ShutdownReason)

Der Grund für das Herunterfahren.
reportTime

string (Timestamp format)

Zeitstempel für die Erstellung des Berichts.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

ShutdownReason

Der Grund für das Herunterfahren.

Enums
SHUTDOWN_REASON_UNSPECIFIED Der Grund für das Herunterfahren ist nicht angegeben.
USER_REQUEST Vom Nutzer initiiert.
SYSTEM_UPDATE Systemupdate gestartet.
LOW_BATTERY Wegen niedrigem Akkustand heruntergefahren.
OTHER Herunterfahren aus anderen Gründen.

HeartbeatStatusReport

Heartbeat-Statusbericht eines Geräts.

  • Für Kioske verfügbar
  • In diesem Feld wird der Online-/Offline-/Unbekannter Status eines Geräts angezeigt. Es ist nur enthalten, wenn sich der Status geändert hat (z. B. Online -> Offline).
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: HeartbeatEnabled Weitere Informationen
  • Heartbeat-Frequenz: 2 Min. <ph type="x-smartling-placeholder">
      </ph>
    • Hinweis: Wenn ein Gerät offline geht, kann es bis zu 12 Minuten dauern, bis der Onlinestatus des Geräts aktualisiert wird.
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: –
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "state": enum (State)
}
Felder
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann der Status geändert wurde

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Status, in den das Gerät geändert wurde

Status

Gerätestatus

Enums
STATE_UNSPECIFIED Status nicht angegeben
UNKNOWN Gerät ist nicht für die Überwachung des Herzschlags geeignet
ONLINE Gerät ist online
OFFLINE Gerät ist offline

KioskAppStatusReport

Statusbericht zu Kiosk-Apps auf einem Gerät

  • Für Kioske verfügbar
  • Dieses Feld enthält die App-ID und die Versionsnummer, die auf einem Kioskgerät ausgeführt werden, sowie den Zeitstempel der letzten Aktualisierung des Berichts
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceSessionStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardhäufigkeit für Datenberichte: 3 Stunden <ph type="x-smartling-placeholder">
      </ph>
    • Richtlinienkontrolliert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_APPS_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Felder
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann der Bericht erstellt wurde

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
appId

string

App-ID der Kiosk-App, z. B. „mdmkkicfmmkgmpkmkdikhlbggogpicma“
appVersion

string

App-Versionsnummer der Kiosk-App, z. B. „1.10.118“

RuntimeCountersReport

Von der CPU abgerufene Laufzeitzähler. Derzeit wird die Telemetriedaten der Laufzeitzähler nur von Intel vPro PSR ab Generation 14 unterstützt.

JSON-Darstellung 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Felder
reportTime

string (Timestamp format)

Zeitstempel für die Erstellung des Berichts.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
uptimeRuntimeDuration

string (Duration format)

Gesamtlaufzeit für die gesamte Lebensdauer. Derzeit immer die S0-Laufzeit von Intel vPro PSR.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
enterSleepCount

string (int64 format)

Gibt an, wie oft das Gerät in den Ruhemodus wechselte. Derzeit über PSR abgerufen, Anzahl von S0->S3.
enterHibernationCount

string (int64 format)

Häufigkeit, mit der das Gerät in den Ruhezustand gewechselt ist. Derzeit über den PSR abgerufen, Anzahl von S0->S4.
enterPoweroffCount

string (int64 format)

Gibt an, wie oft das Gerät in den Modus „Ausschalten“ gewechselt ist. Derzeit über PSR abgerufen, Anzahl von S0->S5.

Methoden

get

 Telemetriegerät abrufen.

list

 Alle Telemetriegeräte auflisten.