Metrics Client
Finden Sie nahegelegene Metrics Server und sehen Sie sich Live-Gerätekennzahlen an, die über Bluetooth LE gestreamt werden.
Überblick
Metrics Client verbindet sich mit einem Metrics Server, der auf einem anderen Gerät läuft, und zeigt die Live-Metriken des Servers in Echtzeit an. Es werden CPU-Auslastung, CPU-Aktivität pro Kern, Geräteidentität (Servername, Gerätemodell, Gerätename) und Zeitstempel empfangen – alles wird über Bluetooth Low Energy gestreamt.
Inhaltsverzeichnis
- Tabs
- Discovery-Tab
- Metrics-Tab
- Verwendung mit Metrics Server
- Berechtigungen
- Technische Details
- Hinweise und Einschränkungen
Tabs
Metrics Client verfügt über zwei Tabs. Sie können zwischen ihnen wischen oder die Tab-Titel antippen.
- Discovery — scannt nach und verbindet mit nahegelegenen Servern.
- Metrics — zeigt Live-Daten vom verbundenen Server an.
Discovery-Tab
Der Discovery-Tab ist die Startansicht. Hier werden nahegelegene Metrics Server-Peripheriegeräte gesucht und Sie können eine Verbindung herstellen.
Discovery-Statuskarte
Die Statuskarte zeigt:
- Einen Scan-Indikator — ein farbiger Punkt mit Beschriftung:
- Scanning (blau, mit Ladeanimation) — aktives Scannen nach Peripheriegeräten.
- Idle (grau) — Scannen ist pausiert.
- Gefundene Server — die Anzahl aktuell sichtbarer Metrics Server-Peripheriegeräte.
- Einen Aktualisieren-Button — stoppt und startet den BLE-Scan neu, um neue Server zu erfassen.
Das Scannen startet automatisch beim Öffnen des Tools.
Liste verfügbarer Server
Unterhalb der Statuskarte werden gefundene Server aufgelistet. Es werden nur Peripheriegeräte angezeigt, die die Metrics Server BLE-Service-UUID bewerben – andere Bluetooth-Geräte werden herausgefiltert.
Wenn keine Server gefunden werden, erscheint eine Fehlerbehebungs-Checkliste:
- Ein Gerät führt das Metrics Server-Tool aus
- Lokale Netzwerkberechtigung ist in den Einstellungen erteilt
- Beide Geräte befinden sich im selben Netzwerk / innerhalb der BLE-Reichweite
Server, die nicht mehr in BLE-Werbung erscheinen, bleiben für eine kurze Karenzzeit (3 Sekunden) in der Liste, um Flackern zu vermeiden.
Server-Zeile
Jeder gefundene Server wird als Zeile angezeigt mit:
- Servername — der im Metrics Server konfigurierte Name (z. B. „iPhone 16 Pro Max (iPhone17,2)“). Anzeigenamen werden für 1,5 Sekunden entprellt, um schnelles Flackern bei Namensänderungen in der BLE-Werbung zu vermeiden.
- RSSI — die Signalstärke in dBm, mit einem farbcodierten 3-Balken-Signalindikator:
- Grün (3 Balken) — starkes Signal (>= -60 dBm)
- Orange (2 Balken) — mittleres Signal (>= -75 dBm)
- Rot (1 Balken) — schwaches Signal (< -75 dBm)
- Service-Verfügbarkeit — ein grüner oder grauer Punkt, der anzeigt, ob der Server die Metrics-Service-UUID bewirbt.
- Ein Connect- / Disconnect-Button:
- Connect (blau) — startet eine BLE-Verbindung zu diesem Server.
- Connecting (grau, mit Ladespinner) — Verbindung wird hergestellt.
- Disconnect (rot) — trennt die Verbindung zum aktuellen Server.
Es wird jeweils nur eine Serververbindung unterstützt. Während der Verbindung zu einem Server sind andere Server-Zeilen deaktiviert.
Metrics-Tab
Bei bestehender Verbindung zeigt der Metrics-Tab Live-Daten, die vom Server gestreamt werden. Nach erfolgreicher Verbindung wechselt der Client automatisch zu diesem Tab.
Verbindungsstatuskarte
Die obere Karte zeigt:
- Verbindungsstatus — ein farbiger Punkt mit Beschriftung:
- Connected (grün)
- Disconnected (rot)
Bei bestehender Verbindung erscheinen zusätzliche Details:
-
Signalstärke — ein 5-Balken-Indikator mit Qualitätslabel (Excellent, Good, Fair, Poor, Very Poor) und dem Rohwert des RSSI in dBm:
RSSI-Bereich Qualität Balken >= -50 dBm Excellent 5 -51 bis -65 dBm Good 4 -66 bis -75 dBm Fair 3 -76 bis -85 dBm Poor 2 Unter -85 dBm Very Poor 1 -
RSSI-Verlauf — ein rollierendes Liniendiagramm der Signalstärkemessungen (bis zu 120 Stichproben), das einen visuellen Eindruck der Verbindungsstabilität vermittelt.
-
Server-Identität — drei Schlüssel-Wert-Zeilen mit den vom Server übertragenen Daten:
Feld Beschreibung Servername Der im Metrics Server konfigurierte Name (z. B. „iPhone 16 Pro Max (iPhone17,2)“). Gerätemodell Der Marketingname des Servergeräts (z. B. „iPhone 16 Pro Max“). Gerät Der vom Benutzer vergebene Gerätename aus den iOS-Einstellungen (z. B. „Rogerios iPhone 16ProMax“). -
Fehlermeldungen — bei BLE-Fehlern (Verbindungsfehler, Trennung usw.) erscheint eine rote Warnung.
-
Ein Disconnect-Button (rot, volle Breite) zum Beenden der Verbindung.
Echtzeit-Metriken-Karte
Wenn Metriken empfangen werden, zeigt diese Karte:
| Feld | Beschreibung |
|---|---|
| CPU Usage | Die aktuelle Gesamt-CPU-Auslastung des Servergeräts in Prozent (z. B. 30.0%), als große Zahl dargestellt. |
| Core Count | Die Anzahl der CPU-Kerne des Servergeräts (z. B. 6). |
| Last Update | Der Zeitstempel des zuletzt empfangenen Metrikpakets, als Zeitstring angezeigt. |
CPU-Auslastungsverlauf
Ein rollierendes Liniendiagramm, das die CPU-Auslastung des Servers im Zeitverlauf zeigt. Das Diagramm speichert bis zu 100 Datenpunkte, was bei einer Aktualisierungsrate von 1 Sekunde etwa 100 Sekunden Verlauf entspricht.
Pro-Kern-Auslastung
Wenn der Server CPU-Daten pro Kern bereitstellt, wird unterhalb des Verlaufsdiagramms eine Pro-Kern-Auslastung-Ansicht angezeigt. Diese zeigt die aktuelle Auslastung für jeden einzelnen CPU-Kern, entsprechend der Visualisierung im CPU Monitor-Tool.
Kein Metrik-Zustand
Wenn keine Verbindung besteht oder noch keine Metriken empfangen wurden, zeigt der Metrics-Tab einen Platzhalter mit einem Diagramm-Icon und einer Aufforderung, über den Discovery-Tab eine Verbindung zu einem Server herzustellen.
Verwendung mit Metrics Server
- Öffnen Sie auf dem zu beobachtenden Gerät Tools > Metrics Server und tippen Sie auf Start Server.
- Öffnen Sie auf dem Gerät mit Metrics Client Tools > Metrics Client.
- Suchen Sie im Discovery-Tab den Server und tippen Sie auf Connect.
- Der Client wechselt automatisch zum Metrics-Tab und zeigt die Live-Werte an.
Berechtigungen
- Bluetooth-Berechtigung — erforderlich für BLE-Scan und Verbindung. Wenn die Berechtigung verweigert wurde, aktivieren Sie den Bluetooth-Zugriff für Lirum in den iOS-Einstellungen.
- Die Bluetooth-Berechtigung wird automatisch von CoreBluetooth verwaltet. Die Systemabfrage erscheint beim ersten Start des Tools.
Technische Details
- Der Client agiert als BLE Central mit
CBCentralManager. Es werden alle nahegelegenen Peripheriegeräte gescannt und die Liste auf solche gefiltert, die die Metrics Server-Service-UUID bewerben. - Nach Verbindungsaufbau entdeckt der Client den Metrics Server GATT-Service und abonniert sowohl die summary- als auch die per-core-Notify-Charakteristiken.
- Metriken werden etwa einmal pro Sekunde als Binärdaten empfangen. Der Client dekodiert:
- Summary: Servername, Gerätemodell, Gerätename, Gesamt-CPU-Auslastung (Float), Kernanzahl (UInt16), Zeitstempel (UInt64 Millisekunden).
- Per-core: Kernanzahl, Pro-Kern-Auslastungsarray (Float pro Kern), Zeitstempel (UInt64 Millisekunden).
- Der Client unterstützt sowohl v1 (Legacy) als auch v2 (aktuell) Payload-Formate für Abwärtskompatibilität mit älteren Metrics Server-Versionen. v2 ergänzt Gerätemodell, Servername als separate Felder und Zeitstempel mit Millisekunden-Genauigkeit.
- RSSI des verbundenen Servers wird alle 2 Sekunden über
readRSSI()abgefragt. Ein Verlauf von bis zu 120 Stichproben wird für das Signaldiagramm gespeichert. - Signalsmoothing — in der Discovery-Liste werden RSSI-Werte exponentiell geglättet (Alpha = 0,15), um visuelles Flackern der Signalbalken zu reduzieren.
- Namensstabilisierung — Server-Anzeigenamen in der Discovery-Liste werden für 1,5 Sekunden entprellt, um Flackern bei schnellen Namensänderungen in der BLE-Werbung zu verhindern.
- Verschwinde-Karenzzeit — Server, die aus der BLE-Werbung verschwinden, bleiben für 3 Sekunden in der Liste, bevor sie entfernt werden, um Flackern zu vermeiden.
- CoreBluetooth-Zustandswiederherstellung ist aktiviert, sodass der Client eine bestehende Verbindung wiederherstellen kann, wenn die App vom System neu gestartet wird.
- Der Metrikverlauf ist auf 100 Einträge begrenzt, was bei der Standardaktualisierungsrate von 1 Sekunde etwa 100 Sekunden Daten entspricht.
Hinweise und Einschränkungen
- Dieses Tool verwendet Bluetooth LE, nicht WLAN. Beide Geräte müssen sich innerhalb der BLE-Reichweite befinden.
- Es wird jeweils nur eine Serververbindung unterstützt.
- RSSI ist ein ungefährer Indikator für die Signalstärke und kann durch Umgebungsfaktoren schwanken.
- Der Metrik-Stream umfasst CPU-Auslastung, Pro-Kern-Auslastung, Kernanzahl und Geräteidentität. Weitere Gerätemetriken (Speicher, Speicherplatz, Temperatur) werden derzeit nicht übertragen.
- Unter visionOS ist Metrics Client nicht verfügbar, da die BLE-Central-Rolle auf dieser Plattform nicht unterstützt wird.