REST Resource: customers.telemetry.devices

Ressource: TelemetryDevice

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

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

string

Nur Ausgabe. Ressourcenname des Geräts.
customer

string

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

string

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

string

Nur Ausgabe. Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der 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 für das Gerät.
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. Die erfassten Arbeitsspeicherstatusberichte werden regelmäßig absteigend nach reportTime sortiert.
networkInfo

object (NetworkInfo)

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

object (NetworkStatusReport)

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

object (NetworkDiagnosticsReport)

Nur Ausgabe. Regelmäßig erhobene Netzwerkdiagnosen
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 Speicherspezifikationen für das Gerät.
storageStatusReport[]

object (StorageStatusReport)

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

object (ThunderboltInfo)

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

object (AudioStatusReport)

Nur Ausgabe. 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 werden, in absteigender Reihenfolge nach reportTime sortiert.
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. Laufzeitzähler melden die erfasste Geräte-Lebensdauerlaufzeit sowie die Anzahl der Übergänge von S0->S3, S0->S4 und S0->S5, d. h. in den Ruhemodus, dem Ruhezustand und dem Ausschalten.

CpuInfo

CPU-Spezifikationen für das Gerät

  • Dieses Feld enthält statische Geräteinformationen, die sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceCpuInfo gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardmäßige Häufigkeit für 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.
  • 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: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_CPU_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel in Millisekunden, der angibt, wann die Daten für diesen Bericht erhoben wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
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. Stichproben pro CPU-Kern in Celsius.

  • 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
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceMemoryInfo gesteuert.
  • Häufigkeit der Datenerhebung:
    • totalRamBytes – nur beim Hochladen
    • 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. RAM insgesamt in Byte.
availableRamBytes

string (int64 format)

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

object (TotalMemoryEncryptionInfo)

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

TotalMemoryEncryptionInfo

Informationen zur Speicherverschlüsselung eines Geräts.

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

enum (MemoryEncryptionState)

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

string (int64 format)

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

string (int64 format)

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

enum (MemoryEncryptionAlgorithm)

Arbeitsspeicherverschlü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 Speicherverschlüsselungsalgorithmus ist nicht festgelegt.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Der verwendete Algorithmus zur Arbeitsspeicherverschlüsselung 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.
  • Daten für dieses Feld werden über folgende Richtlinie gesteuert: ReportDeviceMemoryInfo
  • 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 verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_MEMORY_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel in Millisekunden, der angibt, wann die Daten für diesen Bericht erhoben wurden.

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

string (Duration format)

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

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

string (int64 format)

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

integer

Nur Ausgabe. Anzahl der Seitenfehler während dieser Sammlung

NetworkInfo

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 Datenerfassung: beim Gerätestart
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für 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.
  • Daten für dieses Feld werden über die Richtlinie ReportNetworkDeviceConfiguration gesteuert.
  • Häufigkeit der Datenerfassung: beim Gerätestart
  • Standardhäufigkeit der Datenberichte: Beim Starten des Geräts
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer gemeldet: –
JSON-Darstellung 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Felder
type

enum (NetworkDeviceType)

Nur Ausgabe. Netzwerkgerätetyp.
macAddress

string

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

string

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

string

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

string

Nur Ausgabe. Die ID der integrierten Schaltung, 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
  • Standardmäßige Häufigkeit für Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für verknüpfte Nutzer erfasst: Ja
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
Felder
reportTime

string (Timestamp format)

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

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

string (Duration format)

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

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

integer

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

string

Nur Ausgabe. LAN-IP-Adresse.
gatewayIpAddress

string

Nur Ausgabe. Gateway-IP-Adresse.
transmissionBitRateMbps

string (int64 format)

Nur Ausgabe. Ü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. Anleitung für die 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.

  • Detaillierte Berechtigung erforderlich: 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.

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

object (HttpsLatencyRoutineData)

Nur Ausgabe. HTTPS-Latenztestdaten.

OsUpdateStatus

Enthält Informationen zum aktuellen 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
  • Standardmäßige Häufigkeit für 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 verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_OS_REPORT
JSON-Darstellung 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Felder
updateState

enum (UpdateState)

Nur Ausgabe. Aktueller Status des Betriebssystemupdates.
newPlatformVersion

string

Nur Ausgabe. Neue Plattformversion des 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.

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

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Updateprüfung.

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

string (Timestamp format)

Nur Ausgabe. Zeitstempel des letzten Neustarts.

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

UpdateState

Status des Betriebssystemupdates

Enums
UPDATE_STATE_UNSPECIFIED Status nicht angegeben.
OS_IMAGE_DOWNLOAD_NOT_STARTED Der Download des Betriebssystems wurde 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 Geräteinformationen, die statisch sind und sich im Laufe der Zeit nicht ändern.
  • Daten für dieses Feld werden über die Richtlinie ReportDeviceGraphicsStatus gesteuert.
  • Häufigkeit der Datenerhebung: nur beim Upload
  • Standardmäßige Häufigkeit für 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 verknüpfte Nutzer gemeldet: –
  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_GRAPHICS_INFO
JSON-Darstellung 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Felder
adapterInfo

object (GraphicsAdapterInfo)

Nur Ausgabe. Informationen zum Grafikadapter (GPU).
eprivacySupported

boolean

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

object (DisplayDevice)

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

object (TouchScreenInfo)

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

GraphicsAdapterInfo

Informationen 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ätename 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. Aus drei Buchstaben bestehende Hersteller-ID.
modelId

integer

Nur Ausgabe. Produktcode des Herstellers.
manufactureYear

integer

Nur Ausgabe. Herstellungsjahr.

TouchScreenInfo

Informationen auf dem Touchscreen des Geräts

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

string

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

boolean

Nur Ausgabe. Ob das Touchscreen-Gerät 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.

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

object (DisplayInfo)

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

DisplayInfo

Informationen 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. Auflösungsbreite 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ätename anzeigen.

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 Upload
  • Standardmäßige Häufigkeit für 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_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. Akkutechnologie Beispiel: Li-Ionen

BatteryStatusReport

Statusdaten für den Akku.

  • Dieses Feld enthält Telemetriedaten und ändert sich im Laufe der Zeit, wenn das Gerät verwendet wird.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDevicePowerStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardmäßige Häufigkeit für 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_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

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

string

Nur Ausgabe. Seriennummer des Akkus.
sample[]

object (BatterySampleReport)

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

enum (BatteryHealth)

Nur Ausgabe. Akkuzustand
fullChargeCapacity

string (int64 format)

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

integer

Nur Ausgabe. Anzahl der Ladezyklen.

BatterySampleReport

Stichprobendaten für Akku.

  • Dieses Feld enthält 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
  • Standardmäßige Häufigkeit für 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

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

string (int64 format)

Nur Ausgabe. Akkuspannung (Millivolt)
remainingCapacity

string (int64 format)

Nur Ausgabe. Verbleibende Akkukapazität (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 Akkuzustand 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.
  • Der Hersteller legt die Integrität des Akkus und die Garantierichtlinien fest.
Enums
BATTERY_HEALTH_UNSPECIFIED Zustand unbekannt.
BATTERY_HEALTH_NORMAL Akku ist fehlerfrei, volle Ladekapazität / Designkapazität über 80%
BATTERY_REPLACE_SOON Akku ist einigermaßen fehlerhaft und wird empfohlen, bald gewechselt zu werden, volle Ladekapazität / Designkapazität 75–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
  • Standardmäßige Häufigkeit für 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
  • Standardmäßige Häufigkeit für 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

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

object (DiskInfo)

Nur Ausgabe. 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. Laufwerkstatus
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. Zählt, wie lange das Laufwerk und die Warteschlange ausgelastet waren. Im Gegensatz zu den oben genannten Feldern werden parallele Anfragen also nicht mehrfach gezählt.

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

string (Duration format)

Nur Ausgabe. Zeit 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.
  • Die 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 Telemetriedaten und ändert sich im Laufe der Zeit, 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 für Datenberichte: 3 Stunden
    • Richtliniengesteuert: Ja
  • Cache: Wenn das Gerät offline ist, werden die erhobenen Daten lokal gespeichert und gemeldet, wenn das Gerät das nächste Mal online ist: Ja
  • Nur für 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)

Gesamtzeit für den Start.

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

string (Timestamp format)

Der Zeitstempel, zu dem die Stromversorgung wiederhergestellt wurde.

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

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

enum (ShutdownReason)

Der Grund für das Herunterfahren.
reportTime

string (Timestamp format)

Zeitstempel für die Erstellung des Berichts.

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

ShutdownReason

Der Grund für das Herunterfahren.

Enums
SHUTDOWN_REASON_UNSPECIFIED Der Grund für das Herunterfahren ist nicht angegeben.
USER_REQUEST Vom Nutzer initiiert.
SYSTEM_UPDATE Systemupdate initiiert.
LOW_BATTERY Herunterfahren aufgrund eines niedrigen Akkustands
OTHER Herunterfahren aus anderen Gründen

HeartbeatStatusReport

Heartbeat-Statusbericht eines Geräts.

  • Für Kioske verfügbar
  • 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 gesteuert. 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: –
  • Detaillierte Berechtigung erforderlich: 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

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

enum (State)

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

Status

Gerätestatus

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

KioskAppStatusReport

Statusbericht zu Kiosk-Apps auf einem Gerät

  • 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.
  • Die Daten für dieses Feld werden über die Richtlinie ReportDeviceSessionStatus gesteuert.
  • Häufigkeit der Datenerhebung: Nur beim Upload
  • Standardmäßige Häufigkeit für 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

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

string

Die 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 Telemetriedaten der Laufzeitzähler nur von Intel vPro PSR ab Generation 14 unterstützt.

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

string (Timestamp format)

Zeitstempel, der angibt, wann die Daten erfasst wurden.

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

string (Duration format)

Laufzeit insgesamt. Derzeit immer die S0-Laufzeit von Intel vPro PSR.

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

string (int64 format)

Anzahl der Male, die das Gerät in den Ruhemodus gewechselt ist. Derzeit über PSR abgerufen, Anzahl von S0->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.