REST Resource: customers.telemetry.devices

Ressource: TelemetryDevice

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

  • Erforderliche detaillierte Berechtigung: 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. 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 in 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 erstellte CPU-Statusberichte, sortiert in absteigender Reihenfolge nach reportTime.
memoryInfo

object (MemoryInfo)

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

object (MemoryStatusReport)

Nur Ausgabe. Regelmäßig erfasste Berichte zum Speicherstatus, absteigend sortiert nach reportTime.
networkInfo

object (NetworkInfo)

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

object (NetworkStatusReport)

Nur Ausgabe. Netzwerkspezifikationen werden regelmäßig erhoben.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Nur Ausgabe. Netzwerkdiagnosen werden regelmäßig erhoben.
osUpdateStatus[]

object (OsUpdateStatus)

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

object (GraphicsInfo)

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

object (GraphicsStatusReport)

Nur Ausgabe. Grafikberichte werden regelmäßig erstellt.
batteryInfo[]

object (BatteryInfo)

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

object (BatteryStatusReport)

Nur Ausgabe. Akkuberichte werden regelmäßig erhoben.
storageInfo

object (StorageInfo)

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

object (StorageStatusReport)

Nur Ausgabe. Speicherberichte werden regelmäßig erstellt.
thunderboltInfo[]

object (ThunderboltInfo)

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

object (AudioStatusReport)

Nur Ausgabe. Audioberichte, die regelmäßig erhoben und in absteigender Reihenfolge nach reportTime sortiert werden.
bootPerformanceReport[]

object (BootPerformanceReport)

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

object (HeartbeatStatusReport)

Nur Ausgabe. Statusbericht zu Herzschlägen mit Zeitstempeln, die regelmäßig in absteigender Reihenfolge nach reportTime sortiert werden.
kioskAppStatusReport[]

object (KioskAppStatusReport)

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

object (NetworkBandwidthReport)

Nur Ausgabe. Regelmäßig erhobene Berichte zur Netzwerkbandbreite, sortiert in absteigender Reihenfolge nach reportTime.
peripheralsReport[]

object (PeripheralsReport)

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

object (AppReport)

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

object (RuntimeCountersReport)

Nur Ausgabe. Laufzeitzählerberichte enthalten die Laufzeit des Geräts während seiner gesamten Lebensdauer sowie die Anzahl der Übergänge von S0 –> S3, S0 –> S4 und S0 –> S5, d. h. den Übergang in den Schlaf-, Ruhezustand und Aus-Zustand.

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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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 für die CPU.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und 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 Hochladen
  • Standardhäufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
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. Gibt an, ob Key Locker konfiguriert ist.TRUE = aktiviert; FALSE = deaktiviert. Wird nur gemeldet, wenn keylockerSupported = TRUE.

Architektur

Architekturtyp für die CPU.

Enums
ARCHITECTURE_UNSPECIFIED Architektur unbekannt.
X64 x64-Architektur

CpuStatusReport

Enthält 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
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • 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 dieser Bericht durch eine Stichprobenerhebung ermittelt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 %).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Nur Ausgabe. Informationen zu CPU-Temperatur-Samples pro CPU-Kern in Grad Celsius

CpuTemperatureInfo

CPU-Temperatur eines Geräts. Wird pro CPU-Kern in Grad 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
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
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 Datenerfassung:
    • totalRamBytes – Nur beim Hochladen
    • availableRamBytes – alle 10 Minuten
    • totalMemoryEncryption – beim Start des Geräts
  • Standardmäßige Häufigkeit der Datenberichterstellung:
    • totalRamBytes – 3 Stunden
    • availableRamBytes – 3 Stunden
    • totalMemoryEncryption – beim Start des Geräts
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist. Dies gilt nur für totalMemoryEncryption.
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_MEMORY_INFO
JSON-Darstellung 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Felder
totalRamBytes

string (int64 format)

Nur Ausgabe. Gesamt-RAM in Byte.
availableRamBytes

string (int64 format)

Nur Ausgabe. Menge des verfügbaren RAM 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 Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung: Beim Start des Geräts
  • Standardmäßige Häufigkeit der Datenberichterstellung: Beim Gerätestart
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für verbundene Nutzer gemeldet: N/A
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 Speicherstatus.

  • 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 Hochladen. „SystemRamFreeByes“ wird alle 10 Minuten erhoben.
  • Standardmäßige Häufigkeit der Datenberichterstellung: alle 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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 dieser Bericht durch eine Stichprobenerhebung ermittelt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 an kostenlosem RAM in Byte (aufgrund der Garbage Collection unzuverlässig).
pageFaults

integer

Nur Ausgabe. Anzahl der Seitenfehler während dieser Erfassung

NetworkInfo

Informationen zu Netzwerkgeräten.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: Beim Start des Geräts
  • Standardmäßige Häufigkeit der Datenberichterstellung: Beim Gerätestart
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerhebung: Beim Start des Geräts
  • Standardmäßige Häufigkeit der Datenberichterstellung: Beim Gerätestart
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für verbundene Nutzer gemeldet: N/A
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. Die MEID (falls zutreffend) des entsprechenden Netzwerkgeräts.
imei

string

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

string

Nur Ausgabe. Die ICCID (Integrated Circuit Card ID) der SIM-Karte des Geräts.
mdn

string

Nur Ausgabe. Die mit der SIM-Karte des Geräts verknüpfte Mobiltelefonnummer.

NetworkDeviceType

Netzwerkgerätetypen.

Enums
NETWORK_DEVICE_TYPE_UNSPECIFIED Der Netzwerkgerätetyp wurde 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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportNetworkStatus gesteuert.
  • Häufigkeit der Datenerfassung: 60 Minuten
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Wird nur für verbundene 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),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
Felder
reportTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 WLANs in Dezibel.
lanIpAddress

string

Nur Ausgabe. LAN-IP-Adresse
gatewayIpAddress

string

Nur Ausgabe. Gateway-IP-Adresse.
transmissionBitRateMbps

string (int64 format)

Nur Ausgabe. Die Bitrate wird in Megabit pro Sekunde gemessen.
receivingBitRateMbps

string (int64 format)

Nur Ausgabe. Die Bitrate wird in Megabit pro Sekunde gemessen.
transmissionPowerDbm

integer

Nur Ausgabe. Übertragungsleistung 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.
ipv6Address[]

string

Nur Ausgabe. IPv6-Adressen, die diesem Netzwerk zugewiesen sind, sofern vorhanden. Jede Adresse ist ein String in der standardmäßigen IPv6-Textdarstellung (z.B. „2001:db8::1“).
gatewayIpv6Address

string

Nur Ausgabe. Das Gateway-IPv6 für diese Schnittstelle, sofern erkannt
metered

boolean

Nur Ausgabe. Gibt an, ob das Netzwerk als getaktet erkannt wurde.

NetworkType

Arten von Netzwerkverbindungen

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

NetworkDiagnosticsReport

Ergebnisse von Netzwerktests, um den Zustand der Netzwerkverbindung des Geräts zu ermitteln, 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 für die Erfassung der Diagnosedaten.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 Status des Betriebssystemupdates.

  • 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 ReportDeviceOsUpdateStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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. Eine neue Plattformversion des Betriebssystem-Images wird heruntergeladen und angewendet. Wird nur festgelegt, wenn der Updatestatus OS_IMAGE_DOWNLOAD_IN_PROGRESS oder OS_UPDATE_NEED_REBOOT ist. Hinweis: In einigen Sonderfällen kann dies eine Dummy-IP-Adresse (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 der ausstehenden aktualisierten Kiosk-App.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten erfolgreichen Aktualisierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 Aktualisierungsprüfung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

UpdateState

Status des Betriebssystem-Updates

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 Das Betriebssystem wird auf das Gerät heruntergeladen.
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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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. Gibt an, ob der ePrivacy-Bildschirm unterstützt wird.
displayDevices[]

object (DisplayDevice)

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

object (TouchScreenInfo)

Nur Ausgabe. Informationen zum internen Touchscreen 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,
  "serialNumber": integer,
  "edidVersion": string
}
Felder
displayName

string

Nur Ausgabe. Anzeigename des Geräts.
displayWidthMm

integer

Nur Ausgabe. Breite des Displays in Millimetern.
displayHeightMm

integer

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

boolean

Nur Ausgabe. Ist das Display intern oder nicht?
manufacturerId

string

Nur Ausgabe. Dreistellige Hersteller-ID.
modelId

integer

Nur Ausgabe. Produktcode des Herstellers.
manufactureYear

integer

Nur Ausgabe. Herstellungsjahr.
serialNumber

integer

Nur Ausgabe. Seriennummer
edidVersion

string

Nur Ausgabe. EDID-Version

TouchScreenInfo

Informationen zum 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 Geräte mit internem Touchscreen.

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 Berührungspunkte, die auf dem Gerät unterstützt werden.
stylusCapable

boolean

Nur Ausgabe. Gibt an, ob das Touchscreen-Gerät mit einem Eingabestift bedient werden kann.

GraphicsStatusReport

Informationen zum Grafiksubsystem.

  • 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.
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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,
  "serialNumber": integer,
  "edidVersion": string
}
Felder
deviceId

string (int64 format)

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

integer

Nur Ausgabe. 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 die Anzeige intern ist.
displayName

string

Nur Ausgabe. Anzeigename des Geräts.
serialNumber

integer

Nur Ausgabe. Seriennummer
edidVersion

string

Nur Ausgabe. EDID-Version

BatteryInfo

Informationen zum Akku.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • 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 (mAh).
designMinVoltage

integer

Nur Ausgabe. Minimale Ausgangsspannung (mV) ausgelegt
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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • 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 Stichprobe auf dem Gerät erfasst wurde

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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. Beispieldaten für den Akku, sortiert in absteigender Reihenfolge nach reportTime.
batteryHealth

enum (BatteryHealth)

Nur Ausgabe. Akkuzustand
fullChargeCapacity

string (int64 format)

Nur Ausgabe. Akkukapazität bei vollem Akku (mAh).
cycleCount

integer

Nur Ausgabe. Anzahl der Ladezyklen.

BatterySampleReport

Stichprobenerhebung für Akkudaten.

  • 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 ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 (mAh).
temperature

integer

Nur Ausgabe. Temperatur in Grad Celsius.
dischargeRate

integer

Nur Ausgabe. Die Akkuentladerate 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: Entladen

BatteryHealth

Gibt den aktuellen Zustand des Akkus an.

  • Dieser Status ist kein Hinweis auf einen defekten Akku. Er wird berechnet, indem die aktuelle Kapazität bei voller Ladung durch die Nennkapazität geteilt wird.
  • Der Hersteller ist für die Definition der Akkuintegrität und der Garantiebedingungen verantwortlich.
Enums
BATTERY_HEALTH_UNSPECIFIED Systemstatus unbekannt.
BATTERY_HEALTH_NORMAL Der Akku ist in gutem Zustand. Die Kapazität bei vollständiger Ladung / die Nennkapazität ist > 80 %.
BATTERY_REPLACE_SOON Der Akku ist mäßig beschädigt und sollte bald getauscht werden. Die Kapazität bei vollständiger Ladung liegt bei 75–80 % der Nennkapazität.
BATTERY_REPLACE_NOW Der Akku ist nicht mehr in gutem Zustand und sollte ersetzt werden. Die Kapazität bei vollständiger Ladung / die 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 Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_STORAGE_INFO
JSON-Darstellung 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Felder
volume[]

object (DiskVolume)

Informationen zu Datenträgervolumes
availableDiskBytes

string (int64 format)

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

string (int64 format)

Der gesamte Speicherplatz für die Speicherung von Nutzerdaten auf dem Gerät in Byte.

DiskVolume

Informationen zu Datenträgervolumes

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

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 Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • 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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 Speichermediums.

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. Datenträgervolumes
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. Zählt die Zeit, in der das Laufwerk und die Warteschlange ausgelastet waren. Im Gegensatz zu den Feldern oben 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, die seit dem letzten Booten mit dem Verwerfen verbracht wurde. Beim Verwerfen werden Daten in leere Blöcke geschrieben, die nicht mehr verwendet werden. Wird ab Kernel 4.18 unterstützt.

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

ThunderboltInfo

Informationen zum Thunderbolt-Bus.

  • Dieses Feld enthält Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceSecurityStatus gesteuert.
  • Häufigkeit der Datenerhebung: Beim Start des Geräts
  • Standardmäßige Häufigkeit der Datenberichterstellung: Beim Gerätestart
    • Richtlinienkonform: Nein
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_BUS_DEVICE_INFO
JSON-Darstellung 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Felder
securityLevel

enum (ThunderboltSecurityLevel)

Sicherheitsstufe des Thunderbolt-Busses.

ThunderboltSecurityLevel

Sicherheitsstufe 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 an das Gerät eine Challenge gesendet, die mit der erwarteten Challenge übereinstimmen sollte, die auf einem zufälligen Schlüssel basiert, der in das Sysfs-Attribut „key“ geschrieben wurde.
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-Verbindungen nach dem Dock werden entfernt.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIE-Tunneling ist deaktiviert.

BootPerformanceReport

Bericht zur Startleistung eines Geräts.

  • 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 ReportDeviceBootMode gesteuert.
  • Häufigkeit der Datenerhebung: Bei jedem Startvorgang
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: Ja
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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 bis zum Hochfahren.

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

string (Timestamp format)

Der Zeitstempel, der angibt, wann die Stromversorgung wiederhergestellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 der Bericht erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 wird nicht angegeben.
USER_REQUEST Vom Nutzer initiiert.
SYSTEM_UPDATE Systemupdate initiiert.
LOW_BATTERY Das Gerät wurde aufgrund eines niedrigen Akkustands heruntergefahren.
OTHER Das Gerät wurde aus anderen Gründen heruntergefahren.

HeartbeatStatusReport

Heartbeat-Statusbericht eines Geräts.

  • Für Kioske verfügbar
  • Dieses Feld enthält den Onlinestatus eines Geräts (online/offline/unbekannt) und wird nur eingefügt, wenn sich der Status geändert hat (z. B. „Online“ –> „Offline“).
  • Die Daten für dieses Feld werden über die Richtlinie HeartbeatEnabled gesteuert. Weitere Informationen
  • Herzfrequenz: 2 Minuten
    • 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 erfassten Daten lokal gespeichert und gemeldet, sobald das Gerät wieder online ist: N/A
  • Nur für verbundene Nutzer gemeldet: N/A
  • 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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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

Bundesland

Der 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

Statusbericht einer Kiosk-App auf einem Gerät.

  • Für Kioske verfügbar
  • Dieses Feld enthält die App-ID und die Versionsnummer der App, die auf einem Kioskgerät ausgeführt wird, 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 Hochladen
  • Standardmäßige Häufigkeit der Datenberichterstellung: 3 Stunden
    • Richtlinienkonform: Ja
  • Cache: Wenn das Gerät offline ist, werden die erfassten Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Nein
  • Nur für verbundene Nutzer gemeldet: N/A
  • Erforderliche detaillierte Berechtigung: 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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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

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

RuntimeCountersReport

Laufzeitzähler, die von der CPU abgerufen werden. Derzeit wird die Telemetrie für Laufzeitzähler nur von Intel vPro PSR auf Gen 14+ unterstützt.

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

string (Timestamp format)

Zeitstempel, der angibt, wann der Bericht erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Gesamtlaufzeit über die gesamte Lebensdauer. Derzeit immer 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)

Die Anzahl der Male, die das Gerät in den Ruhemodus gewechselt ist. Derzeit über den PSR abgerufen, Anzahl von S0 –> S3.
enterHibernationCount

string (int64 format)

Anzahl der Male, die das Gerät in den Ruhezustand gewechselt hat. Derzeit über den PSR abgerufen, Anzahl von S0 –> S4.
enterPoweroffCount

string (int64 format)

Die Anzahl der Male, die das Gerät in den Aus-Zustand gewechselt ist. Derzeit über den PSR abgerufen, Anzahl von S0 –> S5.

Methoden

get

 Telemetriegerät abrufen

list

 Alle Telemetriegeräte auflisten.