Metrics Client
Scopri i Metrics Server nelle vicinanze e visualizza in tempo reale le metriche del dispositivo trasmesse tramite Bluetooth LE.
Panoramica
Metrics Client si connette a un Metrics Server in esecuzione su un altro dispositivo e visualizza in tempo reale le metriche trasmesse dal server. Riceve utilizzo CPU, attività CPU per core, identità del dispositivo (nome server, modello dispositivo, nome dispositivo) e timestamp — tutto trasmesso tramite Bluetooth Low Energy.
Indice
- Schede
- Scheda Discovery
- Scheda Metrics
- Come utilizzare con Metrics Server
- Autorizzazioni
- Dettagli tecnici
- Note e limitazioni
Schede
Metrics Client dispone di due schede. Puoi scorrere tra di esse o toccare i titoli delle schede.
- Discovery — esegue la scansione e si connette ai server nelle vicinanze.
- Metrics — visualizza i dati in tempo reale dal server connesso.
Scheda Discovery
La scheda Discovery è la schermata iniziale. Esegue la scansione dei Metrics Server periferici nelle vicinanze e consente di connettersi a uno di essi.
Scheda stato Discovery
La scheda di stato mostra:
- Un indicatore di scansione — un punto colorato con etichetta:
- Scanning (blu, con animazione di caricamento) — scansione attiva delle periferiche.
- Idle (grigio) — scansione in pausa.
- Discovered Servers — il numero di periferiche Metrics Server attualmente visibili.
- Un pulsante Refresh — interrompe e riavvia la scansione BLE per rilevare nuovi server.
La scansione inizia automaticamente all'apertura dello strumento.
Elenco server disponibili
Sotto la scheda di stato vengono elencati i server scoperti. Vengono mostrati solo le periferiche che pubblicizzano il service UUID BLE di Metrics Server — gli altri dispositivi Bluetooth vengono filtrati.
Quando non vengono trovati server, viene visualizzata una checklist di risoluzione dei problemi:
- Un dispositivo sta eseguendo lo strumento Metrics Server
- L'autorizzazione Rete locale è concessa nelle Impostazioni
- Entrambi i dispositivi sono sulla stessa rete / entro il raggio BLE
I server che scompaiono dagli annunci BLE vengono mantenuti nell'elenco per un breve periodo di tolleranza (3 secondi) per evitare sfarfallii.
Riga server
Ogni server scoperto viene visualizzato come una riga contenente:
- Nome server — il nome configurato in Metrics Server (es. "iPhone 16 Pro Max (iPhone17,2)"). I nomi visualizzati sono stabilizzati per 1,5 secondi per evitare sfarfallii rapidi quando il nome dell'annuncio BLE cambia.
- RSSI — la potenza del segnale in dBm, con un indicatore a 3 barre colorate:
- Verde (3 barre) — segnale forte (>= -60 dBm)
- Arancione (2 barre) — segnale moderato (>= -75 dBm)
- Rosso (1 barra) — segnale debole (< -75 dBm)
- Disponibilità servizio — un punto verde o grigio che indica se il server sta pubblicizzando il service UUID di Metrics.
- Un pulsante Connect / Disconnect:
- Connect (blu) — avvia la connessione BLE a questo server.
- Connecting (grigio, con spinner di caricamento) — connessione in corso.
- Disconnect (rosso) — disconnette dal server attuale.
È supportata una sola connessione server alla volta. Durante la connessione a un server, le altre righe server sono disabilitate.
Scheda Metrics
Quando connesso, la scheda Metrics mostra i dati in tempo reale trasmessi dal server. Il client passa automaticamente a questa scheda dopo una connessione riuscita.
Scheda stato connessione
La scheda superiore mostra:
- Stato connessione — un punto colorato con etichetta:
- Connected (verde)
- Disconnected (rosso)
Quando connesso, vengono visualizzati dettagli aggiuntivi:
-
Potenza segnale — un indicatore a 5 barre con etichetta di qualità (Eccellente, Buona, Discreta, Scarsa, Molto scarsa) e valore RSSI grezzo in dBm:
Intervallo RSSI Qualità Barre >= -50 dBm Eccellente 5 -51 a -65 dBm Buona 4 -66 a -75 dBm Discreta 3 -76 a -85 dBm Scarsa 2 Sotto -85 dBm Molto scarsa 1 -
Storico RSSI — un grafico a linee in tempo reale delle letture della potenza del segnale (fino a 120 campioni), che offre una percezione visiva della stabilità della connessione.
-
Identità server — tre righe chiave-valore che mostrano i dati trasmessi dal server:
Campo Descrizione Server Name Il nome configurato in Metrics Server (es. "iPhone 16 Pro Max (iPhone17,2)"). Device Model Il nome commerciale del dispositivo server (es. "iPhone 16 Pro Max"). Device Il nome dispositivo assegnato dall'utente nelle Impostazioni iOS (es. "iPhone 16ProMax di Rogerio"). -
Messaggi di errore — eventuali errori BLE (fallimento connessione, disconnessione, ecc.) vengono mostrati come avvisi rossi.
-
Un pulsante Disconnect (rosso, a tutta larghezza) per terminare la connessione.
Scheda metriche in tempo reale
Quando vengono ricevute metriche, questa scheda mostra:
| Campo | Descrizione |
|---|---|
| CPU Usage | Percentuale di utilizzo CPU attuale del dispositivo server (es. 30.0%), visualizzata come numero grande. |
| Core Count | Numero di core CPU del dispositivo server (es. 6). |
| Last Update | Timestamp del pacchetto metriche più recente, mostrato come stringa oraria. |
Storico utilizzo CPU
Un grafico a linee in tempo reale che mostra l'utilizzo CPU del server nel tempo. Il grafico mantiene fino a 100 punti dati, fornendo circa 100 secondi di storico con aggiornamento a 1 secondo.
Utilizzo per core
Quando il server fornisce dati CPU per core, viene mostrata una vista Utilizzo per core sotto il grafico storico. Questa visualizza la percentuale di utilizzo attuale per ciascun core CPU, con la stessa visualizzazione per core usata nello strumento CPU Monitor.
Stato senza metriche
Quando non connesso o quando non sono ancora arrivate metriche, la scheda Metrics mostra un segnaposto con un'icona grafico e un invito a connettersi a un server tramite la scheda Discovery.
Come utilizzare con Metrics Server
- Sul dispositivo che vuoi monitorare, apri Strumenti > Metrics Server e tocca Start Server.
- Sul dispositivo che esegue Metrics Client, apri Strumenti > Metrics Client.
- Nella scheda Discovery, trova il server e tocca Connect.
- Il client passa automaticamente alla scheda Metrics per mostrare le letture in tempo reale.
Autorizzazioni
- Autorizzazione Bluetooth — necessaria per la scansione e la connessione BLE. Se l'autorizzazione è negata, abilita l'accesso Bluetooth per Lirum nelle Impostazioni iOS.
- L'autorizzazione Bluetooth è gestita automaticamente da CoreBluetooth. La richiesta di sistema appare al primo avvio dello strumento.
Dettagli tecnici
- Il client agisce come BLE Central utilizzando
CBCentralManager. Esegue la scansione di tutte le periferiche nelle vicinanze e filtra l'elenco mostrando solo quelle che pubblicizzano il service UUID di Metrics Server. - Alla connessione, il client scopre il servizio GATT di Metrics Server e si sottoscrive alle caratteristiche notify summary e per-core.
- Le metriche arrivano come payload binari circa una volta al secondo. Il client decodifica:
- Summary: nome server, modello dispositivo, nome dispositivo, utilizzo CPU totale (Float), numero core (UInt16), timestamp (UInt64 millisecondi).
- Per-core: numero core, array utilizzo per core (Float per core), timestamp (UInt64 millisecondi).
- Il client supporta sia il formato payload v1 (legacy) che v2 (attuale) per compatibilità con versioni precedenti di Metrics Server. v2 aggiunge modello dispositivo, nome server come campi separati e timestamp con precisione al millisecondo.
- RSSI per il server connesso viene interrogato ogni 2 secondi tramite
readRSSI(). Uno storico RSSI fino a 120 campioni viene mantenuto per il grafico del segnale. - Smussamento segnale — nell'elenco discovery, i valori RSSI sono smussati esponenzialmente (alpha = 0,15) per ridurre il jitter visivo nelle barre del segnale.
- Stabilizzazione nome — i nomi server visualizzati nell'elenco discovery sono stabilizzati per 1,5 secondi per prevenire sfarfallii quando i nomi degli annunci BLE cambiano rapidamente.
- Periodo di tolleranza scomparsa — i server che scompaiono dagli annunci BLE vengono mantenuti nell'elenco per 3 secondi prima di essere rimossi, evitando sfarfallii nell'elenco.
- Ripristino stato CoreBluetooth è abilitato, consentendo al client di recuperare una connessione esistente se l'app viene riavviata dal sistema.
- Lo storico delle metriche è limitato a 100 voci, corrispondenti a circa 100 secondi di dati con intervallo di aggiornamento predefinito di 1 secondo.
Note e limitazioni
- Questo strumento utilizza Bluetooth LE, non la rete Wi-Fi. Entrambi i dispositivi devono essere entro il raggio BLE.
- È supportata una sola connessione server alla volta.
- RSSI è un indicatore approssimativo della potenza del segnale e può variare a causa di fattori ambientali.
- Il flusso delle metriche include utilizzo CPU, utilizzo per core, numero core e identità dispositivo. Altre metriche (memoria, archiviazione, temperatura) non sono attualmente trasmesse.
- Su visionOS, Metrics Client non è disponibile perché il ruolo centrale BLE non è supportato su quella piattaforma.