Metrics Client
Find nærliggende Metrics Servers og se live enhedsdata streamet over Bluetooth LE.
Oversigt
Metrics Client forbinder til en Metrics Server, der kører på en anden enhed, og viser serverens live-målinger i realtid. Den modtager CPU-forbrug, CPU-aktivitet pr. kerne, enhedsidentitet (servernavn, enhedsmodel, enhedsnavn) og tidsstempler — alt sammen streamet over Bluetooth Low Energy.
Indholdsfortegnelse
- Faneblade
- Discovery-faneblad
- Metrics-faneblad
- Sådan bruges med Metrics Server
- Tilladelser
- Tekniske detaljer
- Noter og begrænsninger
Faneblade
Metrics Client har to faneblade. Du kan swipe mellem dem eller trykke på fanebladstitlerne.
- Discovery — scan efter og forbind til nærliggende servere.
- Metrics — se live-data fra den tilsluttede server.
Discovery-faneblad
Discovery-fanebladet er startsiden. Det scanner efter nærliggende Metrics Server-perifere enheder og lader dig oprette forbindelse til én.
Discovery-statuskort
Statuskortet viser:
- En scanningsindikator — en farvet prik med en etiket:
- Scanning (blå, med indlæsningsanimation) — aktiv scanning efter perifere enheder.
- Inaktiv (grå) — scanning er sat på pause.
- Fundne servere — antallet af Metrics Server-perifere enheder, der aktuelt er synlige.
- En Opdater-knap — stopper og genstarter BLE-scanningen for at finde nye servere.
Scanning starter automatisk, når værktøjet åbnes.
Liste over tilgængelige servere
Under statuskortet vises de fundne servere. Kun perifere enheder, der annoncerer Metrics Server BLE-service-UUID, vises — andre Bluetooth-enheder filtreres fra.
Når ingen servere findes, vises en fejlfindingstjekliste:
- En enhed kører Metrics Server-værktøjet
- Lokalnetværkstilladelse er givet i Indstillinger
- Begge enheder er på samme netværk / inden for BLE-rækkevidde
Servere, der forsvinder fra BLE-annonceringer, forbliver på listen i en kort nådeperiode (3 sekunder) for at undgå flimmer.
Serverrække
Hver fundet server vises som en række, der indeholder:
- Servernavn — navnet konfigureret i Metrics Server (f.eks. "iPhone 16 Pro Max (iPhone17,2)"). Visningsnavne stabiliseres i 1,5 sekunder for at undgå hurtig flimmer, når BLE-annonceringsnavnet ændres.
- RSSI — signalstyrken i dBm, med en farvekodet 3-bars signalindikator:
- Grøn (3 barer) — stærkt signal (>= -60 dBm)
- Orange (2 barer) — moderat signal (>= -75 dBm)
- Rød (1 bar) — svagt signal (< -75 dBm)
- Service-tilgængelighed — en grøn eller grå prik, der angiver, om serveren annoncerer Metrics service-UUID.
- En Forbind / Afbryd-knap:
- Forbind (blå) — starter en BLE-forbindelse til denne server.
- Forbinder (grå, med indlæsningsikon) — forbindelse pågår.
- Afbryd (rød) — afbryder forbindelsen til den aktuelle server.
Kun én serverforbindelse understøttes ad gangen. Mens der forbindes til én server, er andre serverrækker deaktiveret.
Metrics-faneblad
Når der er oprettet forbindelse, viser Metrics-fanebladet live-data streamet fra serveren. Klienten skifter automatisk til dette faneblad ved en vellykket forbindelse.
Forbindelsesstatuskort
Det øverste kort viser:
- Forbindelsestilstand — en farvet prik med en etiket:
- Forbundet (grøn)
- Afbundet (rød)
Når der er forbindelse, vises yderligere detaljer:
-
Signalstyrke — en 5-bars indikator med en kvalitetsbetegnelse (Fremragende, God, Rimelig, Dårlig, Meget dårlig) og den rå RSSI-værdi i dBm:
RSSI-interval Kvalitet Barer >= -50 dBm Fremragende 5 -51 til -65 dBm God 4 -66 til -75 dBm Rimelig 3 -76 til -85 dBm Dårlig 2 Under -85 dBm Meget dårlig 1 -
RSSI-historik — en rullende linjegraf over signalstyrkemålinger (op til 120 prøver), der giver et visuelt indtryk af forbindelsesstabilitet.
-
Serveridentitet — tre nøgleværdi-rækker, der viser data sendt af serveren:
Felt Beskrivelse Servernavn Navnet konfigureret i Metrics Server (f.eks. "iPhone 16 Pro Max (iPhone17,2)"). Enhedsmodel Serverenhedens markedsføringsnavn (f.eks. "iPhone 16 Pro Max"). Enhed Det brugerdefinerede enhedsnavn fra iOS-indstillinger (f.eks. "Rogerio's iPhone 16ProMax"). -
Fejlmeddelelser — hvis der opstår BLE-fejl (forbindelsesfejl, afbrydelse osv.), vises de som en rød advarsel.
-
En Afbryd-knap (rød, fuld bredde) til at afslutte forbindelsen.
Realtids-metricskort
Når metrics modtages, viser dette kort:
| Felt | Beskrivelse |
|---|---|
| CPU-forbrug | Serverenhedens aktuelle samlede CPU-forbrug i procent (f.eks. 30,0%), vist som et stort tal. |
| Antal kerner | Antallet af CPU-kerner på serverenheden (f.eks. 6). |
| Sidste opdatering | Tidsstemplet for den seneste metrics-pakke, vist som et klokkeslæt. |
CPU-forbrugshistorik
En rullende linjegraf viser serverens CPU-forbrug over tid. Grafen indeholder op til 100 datapunkter, hvilket svarer til cirka 100 sekunders historik ved 1-sekunds opdateringsinterval.
Forbrug pr. kerne
Når serveren leverer CPU-data pr. kerne, vises en Forbrug pr. kerne-visning under historikgrafen. Denne viser det aktuelle forbrug i procent for hver enkelt CPU-kerne, svarende til den pr.-kerne-visualisering, der bruges i CPU Monitor-værktøjet.
Ingen metrics-tilstand
Når der ikke er forbindelse, eller der endnu ikke er modtaget metrics, viser Metrics-fanebladet en pladsholder med et diagramikon og en prompt om at oprette forbindelse til en server via Discovery-fanebladet.
Sådan bruges med Metrics Server
- På den enhed, du vil overvåge, åbn Værktøjer > Metrics Server og tryk på Start Server.
- På enheden med Metrics Client, åbn Værktøjer > Metrics Client.
- I Discovery-fanebladet, find serveren og tryk på Forbind.
- Klienten skifter automatisk til Metrics-fanebladet for at vise live-målinger.
Tilladelser
- Bluetooth-tilladelse — påkrævet for BLE-scanning og forbindelse. Hvis tilladelsen nægtes, skal du aktivere Bluetooth-adgang for Lirum i iOS-indstillinger.
- Bluetooth-tilladelse håndteres automatisk af CoreBluetooth. Systemprompten vises første gang værktøjet initialiseres.
Tekniske detaljer
- Klienten fungerer som en BLE Central ved brug af
CBCentralManager. Den scanner efter alle nærliggende perifere enheder og filtrerer listen, så kun dem, der annoncerer Metrics Server service-UUID, vises. - Ved forbindelse opdager klienten Metrics Server GATT-servicen og abonnerer på både summary- og per-core-notifikationskarakteristika.
- Metrics modtages som binære payloads cirka én gang i sekundet. Klienten dekoder:
- Summary: servernavn, enhedsmodel, enhedsnavn, samlet CPU-forbrug (Float), antal kerner (UInt16), tidsstempel (UInt64 millisekunder).
- Per-core: antal kerner, forbrug pr. kerne-array (Float pr. kerne), tidsstempel (UInt64 millisekunder).
- Klienten understøtter både v1 (ældre) og v2 (nuværende) payload-formater for bagudkompatibilitet med ældre Metrics Server-versioner. v2 tilføjer enhedsmodel, servernavn som separate felter og millisekund-præcise tidsstempler.
- RSSI for den tilsluttede server aflæses hvert 2. sekund via
readRSSI(). En RSSI-historik på op til 120 prøver opretholdes til signalgrafen. - Signaludjævning — i discovery-listen udjævnes RSSI-værdier eksponentielt (alpha = 0,15) for at reducere visuel støj i signalbarerne.
- Navnestabilisering — servervisningsnavne i discovery-listen stabiliseres i 1,5 sekunder for at forhindre flimmer, når BLE-annonceringsnavne ændres hurtigt.
- Nådeperiode ved forsvinden — servere, der forsvinder fra BLE-annonceringer, forbliver på listen i 3 sekunder, før de fjernes, for at forhindre flimmer.
- CoreBluetooth-tilstandsgenoprettelse er aktiveret, så klienten kan gendanne en eksisterende forbindelse, hvis appen genstartes af systemet.
- Metrics-historik er begrænset til 100 poster, svarende til cirka 100 sekunders data ved standard 1-sekunds opdateringsinterval.
Noter og begrænsninger
- Dette værktøj bruger Bluetooth LE, ikke Wi-Fi-netværk. Begge enheder skal være inden for BLE-rækkevidde.
- Kun én serverforbindelse understøttes ad gangen.
- RSSI er en omtrentlig indikator for signalstyrke og kan variere på grund af miljømæssige forhold.
- Metrics-strømmen inkluderer CPU-forbrug, forbrug pr. kerne, antal kerner og enhedsidentitet. Andre enhedsdata (hukommelse, lager, temperatur) overføres ikke i øjeblikket.
- På visionOS er Metrics Client ikke tilgængelig, da BLE central-rollen ikke understøttes på denne platform.