REST Resource: customers.telemetry.devices

Ressource: TelemetryDevice

Telemetriedaten, die von einem verwalteten Gerät erfasst 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, dessen Unternehmen das Gerät registriert hat.
orgUnitId

string

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

string

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

string

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

object (CpuInfo)

Nur Ausgabe. Informationen zu den CPU-Spezifikationen des Geräts.
cpuStatusReport[]

object (CpuStatusReport)

Nur Ausgabe. Regelmäßig erhobene CPU-Statusberichte, sortiert in absteigender Reihenfolge nach reportTime.
memoryInfo

object (MemoryInfo)

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

object (MemoryStatusReport)

Nur Ausgabe. Berichte zum Speicherstatus, die regelmäßig erfasst und in absteigender Reihenfolge nach reportTime sortiert werden.
networkInfo

object (NetworkInfo)

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

object (NetworkStatusReport)

Nur Ausgabe. Netzwerkspezifikationen, die regelmäßig erfasst werden.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Nur Ausgabe. Netzwerkdiagnose, die regelmäßig erfasst wird.
osUpdateStatus[]

object (OsUpdateStatus)

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

object (GraphicsInfo)

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

object (GraphicsStatusReport)

Nur Ausgabe. Grafikberichte, die regelmäßig erhoben werden.
batteryInfo[]

object (BatteryInfo)

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

object (BatteryStatusReport)

Nur Ausgabe. Akkuberichte, die regelmäßig erfasst werden.
storageInfo

object (StorageInfo)

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

object (StorageStatusReport)

Nur Ausgabe. Regelmäßig erhobene Speicherberichte
thunderboltInfo[]

object (ThunderboltInfo)

Nur Ausgabe. Informationen zum Thunderbolt-Bus
audioStatusReport[]

object (AudioStatusReport)

Nur Ausgabe. Regelmäßig erhobene Audioberichte, sortiert in absteigender Reihenfolge nach reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

Nur Ausgabe. Berichte zur Bootleistung des Geräts
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Nur Ausgabe. Bericht zum Status von Heartbeats mit Zeitstempeln, die regelmäßig in absteigender Reihenfolge nach reportTime sortiert werden
kioskAppStatusReport[]

object (KioskAppStatusReport)

Nur Ausgabe. Bericht zum Status der Kiosk-App für das Kioskgerät
networkBandwidthReport[]

object (NetworkBandwidthReport)

Nur Ausgabe. Berichte zur Netzwerkbandbreite, die regelmäßig erhoben und in absteigender Reihenfolge nach reportTime sortiert werden.
peripheralsReport[]

object (PeripheralsReport)

Nur Ausgabe. Berichte zu Peripheriegeräten, die regelmäßig erhoben werden, in absteigender Reihenfolge nach reportTime sortiert.
appReport[]

object (AppReport)

Nur Ausgabe. Regelmäßig erhobene App-Berichte, sortiert in absteigender Reihenfolge nach reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

Nur Ausgabe. In den Berichten zu Laufzeitzählern werden die Laufzeit des Geräts während der gesamten Lebensdauer sowie die Anzahl der Übergänge von S0 -> S3, S0 -> S4 und S0 -> S5 erfasst. Das bedeutet, dass der Ruhe-, der Ruhemodus und der Aus-Zustand aktiviert wurde.

CpuInfo

CPU-Spezifikationen für das Gerät

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • 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 @ 1.60GHz
architecture

enum (Architecture)

Nur Ausgabe. Architekturtyp der CPU.

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
maxClockSpeed

integer

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

boolean

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

boolean

Nur Ausgabe. Ob Key Locker konfiguriert ist.TRUE = aktiviert; FALSE = deaktiviert. Wird nur gemeldet, wenn „keylockerSupported“ den Wert „TRUE“ hat.

Architektur

Architekturtyp der CPU.

Enums
ARCHITECTURE_UNSPECIFIED Architektur unbekannt.
X64 x64-Architektur

CpuStatusReport

Bietet Informationen zum Status der CPU.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Erforderliche detaillierte Berechtigung: 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 die Uhrzeit angibt, zu der die Stichprobe für diesen Bericht erhoben wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
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 die CPU-Auslastung (0–100 Prozent).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Nur Ausgabe. CPU-Temperatur-Messwerte pro CPU-Kern in Grad Celsius

CpuTemperatureInfo

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

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: alle 10 Minuten
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
JSON-Darstellung 
{
  "temperatureCelsius": integer,
  "label": string
}
Felder
temperatureCelsius

integer

Nur Ausgabe. CPU-Temperatur in Grad Celsius.
label

string

Nur Ausgabe. CPU-Label Beispiel: Core 0

MemoryInfo

Arbeitsspeicherinformationen eines Geräts.

  • Dieses Feld enthält sowohl Telemetrie- als auch Geräteinformationen:
    • totalRamBytes – Geräteinformationen
    • availableRamBytes – Telemetrieinformationen
    • totalMemoryEncryption – Geräteinformationen
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung:
    • totalRamBytes – nur beim Upload
    • availableRamBytes – alle 10 Minuten
    • totalMemoryEncryption – beim Starten des Geräts
  • Standardhäufigkeit der Datenberichte:
    • totalRamBytes – 3 Stunden
    • availableRamBytes – 3 Stunden
    • totalMemoryEncryption – beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist. Nur für totalMemoryEncryption
  • Nur für zugehörige Nutzer erfasst: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_INFO
JSON-Darstellung 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Felder
totalRamBytes

string (int64 format)

Nur Ausgabe. Gesamter RAM in Byte.
availableRamBytes

string (int64 format)

Nur Ausgabe. Verfügbarer Arbeitsspeicher in Byte.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

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

TotalMemoryEncryptionInfo

Informationen zur Speicherverschlüsselung eines Geräts.

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung: Beim Starten des Geräts
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: –
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 Status der Speicherverschlüsselung ist nicht festgelegt.
MEMORY_ENCRYPTION_STATE_UNKNOWN Der Status der Speicherverschlüsselung ist unbekannt.
MEMORY_ENCRYPTION_STATE_DISABLED Die Speicherverschlüsselung auf dem Gerät ist 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 Der 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 Berichte zum Arbeitsspeicherstatus.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload, SystemRamFreeByes wird alle 10 Minuten erfasst
  • Standardhäufigkeit der Datenberichte: alle 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • 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 die Uhrzeit angibt, zu der die Stichprobe für diesen Bericht erhoben wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
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 (aufgrund der Garbage Collection möglicherweise unzuverlässig)
pageFaults

integer

Nur Ausgabe. Anzahl der Seitenfehler während dieser Sammlung

NetworkInfo

Informationen zum Netzwerkgerät.

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: Beim Starten des Geräts
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: –
  • 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 statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: Beim Starten des Geräts
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: –
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 IC-Karten-ID, 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

Netzwerkgerätetypen

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

NetworkStatusReport

Status der sichtbaren/konfigurierten Netzwerke.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: Ja
  • Erforderliche detaillierte Berechtigung: 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. Der Zeitpunkt, zu dem der Netzwerkstatus gemeldet wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
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 für drahtlose Netzwerke, gemessen in Dezibel.
lanIpAddress

string

Nur Ausgabe. LAN-IP-Adresse.
gatewayIpAddress

string

Nur Ausgabe. Gateway-IP-Adresse.
transmissionBitRateMbps

string (int64 format)

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

string (int64 format)

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

integer

Nur Ausgabe. Die Ü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. GUID der Netzwerkverbindung.
connectionState

enum (NetworkConnectionState)

Nur Ausgabe. Aktueller Verbindungsstatus des Netzwerks.
connectionType

enum (NetworkType)

Nur Ausgabe. Art der Netzwerkverbindung.

NetworkType

Arten von Netzwerkverbindungen

Enums
NETWORK_TYPE_UNSPECIFIED Art der Netzwerkverbindung nicht angegeben
CELLULAR Mobilfunkverbindung
ETHERNET Ethernet-Netzwerkverbindung
TETHER Tether-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.

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

string (Timestamp format)

Nur Ausgabe. Zeitstempel, zu dem die Diagnosedaten erfasst wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

Nur Ausgabe. Testdaten zur HTTPS-Latenz

OsUpdateStatus

Enthält Informationen zum aktuellen Update-Status des Betriebssystems.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • 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 heruntergeladenen und angewendeten Betriebssystem-Images. Sie wird nur festgelegt, wenn der Updatestatus OS_IMAGE_DOWNLOAD_IN_PROGRESS oder OS_UPDATE_NEED_REBOOT lautet. Hinweis: In einigen Grenzfällen kann dies ein Dummy-Wert „0.0.0.0“ für den Status „OS_UPDATE_NEED_REBOOT“ sein, z.B. wenn die Update-Engine ohne Neustart neu gestartet wird.
newRequestedPlatformVersion

string

Nur Ausgabe. Neue angeforderte Plattformversion aus der ausstehenden Aktualisierung der Kiosk-App.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten erfolgreichen Aktualisierung.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierungsüberprüfung.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel des letzten Neustarts.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

UpdateState

Status des Betriebssystemupdates

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

GraphicsInfo

Informationen zum Grafik-Subsystem.

  • Dieses Feld enthält statische Geräteinformationen, die 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • 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 zum Grafikadapter (GPU).
eprivacySupported

boolean

Nur Ausgabe. Ob der ePrivacy-Bildschirm unterstützt wird oder nicht.
displayDevices[]

object (DisplayDevice)

Nur Ausgabe. Informationen zum Display oder den Displays des Geräts.
touchScreenInfo

object (TouchScreenInfo)

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

GraphicsAdapterInfo

Informationen zu einer 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. Stellt die Geräte-ID der Grafikkarte dar.

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. Gerätenamen anzeigen
displayWidthMm

integer

Nur Ausgabe. Displaybreite in Millimetern.
displayHeightMm

integer

Nur Ausgabe. Höhe des Displays in Millimetern.
internal

boolean

Nur Ausgabe. Ob das Display intern ist oder nicht.
manufacturerId

string

Nur Ausgabe. Dreistellige 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. Name der Touchpad-Bibliothek, die vom Eingabestapel verwendet wird.
devices[]

object (TouchScreenDevice)

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

TouchScreenDevice

Informationen zu einem internen Touchscreengerät.

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

string

Nur Ausgabe. Anzeigename des Touchscreen-Geräts.
touchPointCount

integer

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

boolean

Nur Ausgabe. Ob das Gerät mit Touchscreen einen Eingabestift unterstützt.

GraphicsStatusReport

Informationen zum Grafik-Subsystem.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsInfo gesteuert.
  • Häufigkeit der Datenerhebung: 3 Stunden.
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Grafikdaten erfasst wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

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

DisplayInfo

Informationen für ein Display.

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

string (int64 format)

Nur Ausgabe. Stellt die Geräte-ID der Grafikkarte dar.
resolutionWidth

integer

Nur Ausgabe. Die Breite der Auflösung in Pixeln.
resolutionHeight

integer

Nur Ausgabe. Höhe der Auflösung 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. Gerätenamen anzeigen

BatteryInfo

Informationen zum Akku.

  • Dieses Feld enthält statische Geräteinformationen, die 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Erforderliche detaillierte Berechtigung: 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. Akkuhersteller
designCapacity

string (int64 format)

Nur Ausgabe. Nennkapazität (Milliamperestunden)
designMinVoltage

integer

Nur Ausgabe. Ausgelegte 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 den Akku.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Erforderliche detaillierte Berechtigung: 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 Stichprobe auf dem Gerät erfasst wurde

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
serialNumber

string

Nur Ausgabe. Seriennummer des Akkus.
sample[]

object (BatterySampleReport)

Nur Ausgabe. Stichprobendaten für den Akku, sortiert in absteigender Reihenfolge nach reportTime.
batteryHealth

enum (BatteryHealth)

Nur Ausgabe. Akkuzustand
fullChargeCapacity

string (int64 format)

Nur Ausgabe. Akkulaufzeit bei voller Ladung (Milliamperestunden)
cycleCount

integer

Nur Ausgabe. Anzahl der Ladezyklen.

BatterySampleReport

Stichprobenerhebung von Akkudaten.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
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 Stichprobe auf dem Gerät erfasst wurde

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

Nur Ausgabe. Akkuspannung (Millivolt)
remainingCapacity

string (int64 format)

Nur Ausgabe. Verbleibende Akkukapazität (Milliamperestunden)
temperature

integer

Nur Ausgabe. Temperatur in Grad Celsius.
dischargeRate

integer

Nur Ausgabe. Die Akkuentladungsrate, gemessen in mW. 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 gelesen von Sysfs. Beispiel: Entladung

BatteryHealth

Stellt den aktuellen Zustand des Akkus dar.

  • Dieser Status ist keine Messanzeige und auch kein Hinweis auf einen defekten Akku. Er wird berechnet, indem die aktuelle Kapazität bei voller Ladung durch die Nennkapazität geteilt wird.
  • Die Definition der Akkuintegrität und der beschränkten Garantie obliegt dem Hersteller.
Enums
BATTERY_HEALTH_UNSPECIFIED Status unbekannt.
BATTERY_HEALTH_NORMAL Akku ist in Ordnung, volle Ladekapazität / Nennkapazität > 80%
BATTERY_REPLACE_SOON Der Akku ist mäßig in schlechtem Zustand und sollte bald ersetzt werden. Die volle Ladekapazität / Nennkapazität beträgt 75 % bis 80 %.
BATTERY_REPLACE_NOW Der Akku ist in einem schlechten Zustand und sollte ersetzt werden. Die volle Ladekapazität / Nennkapazität liegt unter 75 %.

StorageInfo

Statusdaten für den Speicher.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_INFO
JSON-Darstellung 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Felder
volume[]

object (DiskVolume)

Informationen zu Laufwerkvolumes
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 Laufwerkvolumes

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)

Gesamter Speicherplatz in Byte.

StorageStatusReport

Statusdaten für den Speicher.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, 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 der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_STORAGE_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

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

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

Nur Ausgabe. Berichte auf dem 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. Laufwerkvolumes
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 Start geschriebenen Byte.
readTimeThisSession

string (Duration format)

Nur Ausgabe. Zeitaufwand 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 Schreibvorgänge auf dem 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. Hier wird die Zeit gezählt, in der der Datenträger und die Warteschlange belegt waren. Im Gegensatz zu den oben genannten Feldern werden parallele Anfragen also nicht mehrmals 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 seit dem letzten Start, in der Daten verworfen wurden. Beim Verwerfen werden Daten in leere Blöcke geschrieben, die nicht mehr verwendet werden. Unterstützt von Kernels ab Version 4.18.

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

ThunderboltInfo

Thunderbolt-Bus-Informationen

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceSecurityStatus gesteuert.
  • Häufigkeit der Datenerhebung: Beim Starten des Geräts
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Nein
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_BUS_DEVICE_INFO
JSON-Darstellung 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Felder
securityLevel

enum (ThunderboltSecurityLevel)

Sicherheitsebene des Thunderbolt-Busses.

ThunderboltSecurityLevel

Sicherheitsebene des Thunderbolt-Busses.

Enums
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Die Thunderbolt-Sicherheitsstufe ist nicht festgelegt.
THUNDERBOLT_SECURITY_NONE_LEVEL Alle Geräte werden automatisch von der Firmware verbunden. Es ist keine Nutzergenehmigung 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. Außerdem wird dem Gerät eine Herausforderung gesendet, die mit der erwarteten übereinstimmen sollte. Diese Herausforderung basiert auf einem zufälligen Schlüssel, der in das sysfs-Attribut für den Schlüssel 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-Glieder nach dem Dock werden entfernt.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIe-Tunneling ist deaktiviert.

BootPerformanceReport

Bericht zur Bootleistung eines Geräts.

  • Dieses Feld enthält Telemetrieinformationen, die sich im Laufe der Zeit ändern, wenn das Gerät verwendet wird.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceBootMode gesteuert.
  • Häufigkeit der Datenerhebung: Bei jedem Startvorgang
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für zugehörige Nutzer erfasst: –
  • 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)

Gesamte Zeit für den Startvorgang.

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

string (Timestamp format)

Der Zeitstempel, zu dem die Stromversorgung wiederhergestellt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

Gesamtzeit seit Beginn des Herunterfahrens bis zum Ausschalten.

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

string (Timestamp format)

Der Zeitstempel für das Herunterfahren.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

Der Grund für das Herunterfahren.
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann die Daten erfasst wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

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 initiiert.
LOW_BATTERY Herunterfahren aufgrund eines niedrigen Akkustands
OTHER Herunterfahren aus anderen Gründen

HeartbeatStatusReport

Heartbeat-Statusbericht eines Geräts.

  • Verfügbar für Kioske
  • Dieses Feld gibt den Online-/Offline-/Unbekannten-Status eines Geräts an und wird nur eingeschlossen, wenn sich der Status geändert hat (z. B. „Online“ -> „Offline“).
  • Die Daten für dieses Feld werden über die Richtlinie HeartbeatEnabled verwaltet. Weitere Informationen
  • Herzschlaghäufigkeit: 2 Minuten
    • Hinweis: Wenn ein Gerät offline geht, kann es bis zu zwölf Minuten dauern, bis der Onlinestatus des Geräts aktualisiert wird.
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: –
  • Nur für zugehörige Nutzer erfasst: –
  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "state": enum (State)
}
Felder
reportTime

string (Timestamp format)

Zeitstempel für den Zeitpunkt, zu dem die Statusänderung erkannt wurde

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
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 Heartbeat-Überwachung geeignet
ONLINE Gerät ist online
OFFLINE Gerät ist offline
DEVICE_OUTDATED Gerät ist veraltet

KioskAppStatusReport

Bericht zum Status der Kiosk-App eines Geräts.

  • Verfügbar für Kioske
  • In diesem Feld sind die App-ID und die Versionsnummer angegeben, die auf einem Kioskgerät ausgeführt wird, sowie der Zeitstempel der letzten Aktualisierung des Berichts.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceSessionStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardhäufigkeit der Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Nein
  • Nur für zugehörige Nutzer erfasst: –
  • 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 erfasst wurde

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
appId

string

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

string

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

RuntimeCountersReport

Laufzeitzähler, die von der CPU abgerufen werden. Derzeit wird die Laufzeitzähler-Telemetrie nur von Intel vPro PSR auf Gen 14 und höher unterstützt.

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

string (Timestamp format)

Zeitstempel, der angibt, wann die Daten erfasst wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Laufzeit insgesamt. Derzeit immer S0-Laufzeit aus Intel vPro PSR.

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

string (int64 format)

Anzahl der Male, dass das Gerät in den Ruhemodus gewechselt ist. Wird derzeit über den PSR abgerufen, Zählung von S0 bis S3.
enterHibernationCount

string (int64 format)

Anzahl der Male, dass das Gerät in den Ruhemodus gewechselt ist. Wird derzeit über den PSR abgerufen, Zählung von S0 bis S4.
enterPoweroffCount

string (int64 format)

Anzahl der Male, dass das Gerät ausgeschaltet wurde. Wird derzeit über den PSR abgerufen, Zählung von S0 -> S5.

Methoden

get

 Telemetriegerät abrufen

list

 Listet alle Telemetriegeräte auf.