Siirry pääsisältöön

Metrics Client

Etsi lähistöllä olevat Metrics Serverit ja tarkastele laitteiden reaaliaikaisia mittaustietoja Bluetooth LE -yhteyden kautta.

Discovery-välilehti: etsii lähistöllä olevia Metrics Servereitä, näyttää tilan ja päivityspainikkeet.
Kun palvelimia ei löydy, vianmäärityslista auttaa ongelmanratkaisussa.
Discovery-välilehti, jossa näkyy skannausilmaisin ja lista saatavilla olevista palvelimista.

Yleiskatsaus

Metrics Client yhdistää toiseen laitteeseen, jossa on käynnissä Metrics Server, ja näyttää palvelimen reaaliaikaiset mittaustiedot. Se vastaanottaa tiedot CPU-käytöstä, ydinkohtaisesta CPU-aktiivisuudesta, laitteen tunnistetiedoista (palvelimen nimi, laitemalli, laitteen nimi) ja aikaleimoista — kaikki siirretään Bluetooth Low Energy -yhteyden kautta.

Sisällysluettelo

Välilehdet

Metrics Clientissa on kaksi välilehteä. Voit vaihtaa niiden välillä pyyhkäisemällä tai napauttamalla välilehtien otsikoita.

  • Discovery — etsi ja yhdistä lähistöllä oleviin palvelimiin.
  • Metrics — tarkastele yhdistetyn palvelimen reaaliaikaisia tietoja.

Discovery-välilehti

Discovery-välilehti on aloitusnäkymä. Se etsii lähistöllä olevia Metrics Server -laitteita ja mahdollistaa yhdistämisen niihin.

Discovery-tilakortti

Tilakortti näyttää:

  • Skannausilmaisin — värillinen piste ja selite:
    • Scanning (sininen, latausanimaatio) — etsii aktiivisesti laitteita.
    • Idle (harmaa) — skannaus on tauolla.
  • Löydetyt palvelimet — tällä hetkellä näkyvissä olevien Metrics Server -laitteiden määrä.
  • Päivitä-painike — pysäyttää ja käynnistää BLE-skannauksen uudelleen uusien palvelimien löytämiseksi.

Skannaus käynnistyy automaattisesti, kun työkalu avataan.

Saatavilla olevat palvelimet -lista

Tilakortin alla näytetään löydetyt palvelimet. Vain ne laitteet, jotka mainostavat Metrics Serverin BLE-palvelun UUID:ta, näytetään — muut Bluetooth-laitteet suodatetaan pois.

Kun palvelimia ei löydy, näytetään vianmäärityslista:

  • Laitteessa on käynnissä Metrics Server -työkalu
  • Paikallisverkon lupa on myönnetty Asetuksissa
  • Molemmat laitteet ovat samassa verkossa / BLE-kantaman sisällä

Palvelimet, jotka katoavat BLE-mainoksista, säilytetään listalla lyhyen armovaiheen ajan (3 sekuntia) välkynnän estämiseksi.

Palvelinrivi

Jokainen löydetty palvelin näytetään rivinä, joka sisältää:

  • Palvelimen nimi — Metrics Serverissä määritetty nimi (esim. "iPhone 16 Pro Max (iPhone17,2)"). Näyttönimiä viivästetään 1,5 sekuntia välkynnän estämiseksi, kun BLE-mainoksen nimi muuttuu nopeasti.
  • RSSI — signaalin voimakkuus dBm-yksiköissä, värikoodattu 3-palkkisella signaali-ilmaisimella:
    • Vihreä (3 palkkia) — vahva signaali (>= -60 dBm)
    • Oranssi (2 palkkia) — kohtalainen signaali (>= -75 dBm)
    • Punainen (1 palkki) — heikko signaali (< -75 dBm)
  • Palvelun saatavuus — vihreä tai harmaa piste, joka ilmaisee, mainostaako palvelin Metrics-palvelun UUID:ta.
  • Yhdistä / Katkaise -painike:
    • Connect (sininen) — aloittaa BLE-yhteyden tähän palvelimeen.
    • Connecting (harmaa, latausikoni) — yhteys muodostumassa.
    • Disconnect (punainen) — katkaisee yhteyden nykyiseen palvelimeen.

Vain yksi palvelinyhteys on tuettu kerrallaan. Kun yhdistetään yhteen palvelimeen, muut palvelinrivit ovat poissa käytöstä.


Metrics-välilehti

Kun yhteys on muodostettu, Metrics-välilehti näyttää palvelimelta reaaliajassa saapuvat tiedot. Asiakasohjelma siirtyy automaattisesti tälle välilehdelle onnistuneen yhteyden jälkeen.

Yhteystilakortti

Yläosan kortti näyttää:

  • Yhteystila — värillinen piste ja selite:
    • Connected (vihreä)
    • Disconnected (punainen)

Kun yhteys on muodostettu, näkyviin tulee lisätietoja:

  • Signaalin voimakkuus — 5-palkkinen ilmaisin, laatuluokitus (Erinomainen, Hyvä, Kohtalainen, Heikko, Erittäin heikko) ja RSSI-arvo dBm-yksiköissä:

    RSSI-alueLaatuPalkit
    >= -50 dBmErinomainen5
    -51 – -65 dBmHyvä4
    -66 – -75 dBmKohtalainen3
    -76 – -85 dBmHeikko2
    Alle -85 dBmErittäin heikko1
  • RSSI-historia — vierivä viivakaavio signaalin voimakkuudesta (enintään 120 näytettä), joka antaa visuaalisen kuvan yhteyden vakaudesta.

  • Palvelimen tunnistetiedot — kolme avain-arvo -riviä, jotka näyttävät palvelimen lähettämät tiedot:

    KenttäKuvaus
    Server NameMetrics Serverissä määritetty nimi (esim. "iPhone 16 Pro Max (iPhone17,2)").
    Device ModelPalvelinlaitteen markkinointinimi (esim. "iPhone 16 Pro Max").
    DeviceiOS:n asetuksissa käyttäjän antama laitteen nimi (esim. "Rogerio's iPhone 16ProMax").
  • Virheilmoitukset — mahdolliset BLE-virheet (yhteysvirhe, katkaisu jne.) näytetään punaisena varoituksena.

  • Katkaise-painike (punainen, koko rivin levyinen) yhteyden lopettamiseksi.

Reaaliaikaiset mittaustiedot -kortti

Kun mittaustietoja vastaanotetaan, tämä kortti näyttää:

KenttäKuvaus
CPU UsagePalvelinlaitteen tämänhetkinen kokonais-CPU-käyttöprosentti (esim. 30,0 %), näytetään suurena lukuna.
Core CountPalvelinlaitteen CPU-ytimien määrä (esim. 6).
Last UpdateViimeisimmän mittauspaketin aikaleima, näytetään kellonaikana.

CPU-käytön historia

Vierivä viivakaavio, joka näyttää palvelimen CPU-käytön ajan kuluessa. Kaavio tallentaa enintään 100 tietopistettä, mikä vastaa noin 100 sekunnin historiaa 1 sekunnin päivitysvälillä.

Ydinkohtainen käyttö

Kun palvelin lähettää ydinkohtaisia CPU-tietoja, Ydinkohtainen käyttö -näkymä näytetään historiakaavion alla. Tämä näyttää kunkin CPU-ytimen tämänhetkisen käyttöprosentin, samaan tapaan kuin CPU Monitor -työkalussa.

Ei mittaustietoja -tila

Kun yhteyttä ei ole tai mittaustietoja ei ole vielä saapunut, Metrics-välilehdellä näytetään paikkamerkki, jossa on kaavioikoni ja kehotus yhdistää palvelimeen Discovery-välilehden kautta.


Käyttö Metrics Serverin kanssa

  1. Laitteessa, jota haluat tarkkailla, avaa Työkalut > Metrics Server ja napauta Start Server.
  2. Laitteessa, jossa on Metrics Client, avaa Työkalut > Metrics Client.
  3. Discovery-välilehdellä etsi palvelin ja napauta Connect.
  4. Asiakasohjelma siirtyy automaattisesti Metrics-välilehdelle näyttämään reaaliaikaiset tiedot.

Luvat

  • Bluetooth-lupa — vaaditaan BLE-skannaukseen ja yhteyden muodostamiseen. Jos lupa on evätty, ota Bluetooth-käyttöoikeus käyttöön Lirumille iOS:n asetuksissa.
  • Bluetooth-lupa hallitaan automaattisesti CoreBluetoothin kautta. Järjestelmän lupaikkuna avautuu, kun työkalu alustetaan ensimmäistä kertaa.

Tekniset tiedot

  • Asiakas toimii BLE Central -roolissa käyttäen CBCentralManager-luokkaa. Se etsii kaikki lähistöllä olevat laitteet ja suodattaa listan näyttämään vain ne, jotka mainostavat Metrics Serverin palvelu-UUID:ta.
  • Yhdistettäessä asiakas etsii Metrics Serverin GATT-palvelun ja tilaa sekä summary- että per-core-ilmoitusominaisuudet.
  • Mittaustiedot saapuvat binäärimuodossa noin kerran sekunnissa. Asiakas purkaa seuraavat tiedot:
    • Summary: palvelimen nimi, laitemalli, laitteen nimi, kokonais-CPU-käyttö (Float), ytimien määrä (UInt16), aikaleima (UInt64 millisekunteina).
    • Per-core: ytimien määrä, ydinkohtainen käyttötaulukko (Float per ydin), aikaleima (UInt64 millisekunteina).
  • Asiakas tukee sekä v1 (vanha) että v2 (nykyinen) tietomuotoja taaksepäin yhteensopivuuden vuoksi vanhempien Metrics Server -versioiden kanssa. v2 lisää laitemallin, palvelimen nimen erillisinä kenttinä ja millisekuntitarkkuuden aikaleimoihin.
  • RSSI yhdistetylle palvelimelle luetaan 2 sekunnin välein readRSSI()-kutsulla. RSSI-historiaan tallennetaan enintään 120 näytettä signaalikaaviota varten.
  • Signaalin tasoitus — Discovery-listassa RSSI-arvot tasoitetaan eksponentiaalisesti (alpha = 0,15) visuaalisen välkynnän vähentämiseksi signaalipalkkien näytössä.
  • Nimen vakautus — palvelimien näyttönimet Discovery-listassa viivästetään 1,5 sekunnilla välkynnän estämiseksi, kun BLE-mainoksen nimi muuttuu nopeasti.
  • Armovaihe katoamiselle — palvelimet, jotka katoavat BLE-mainoksista, säilytetään listalla 3 sekunnin ajan ennen poistamista, jotta lista ei välky.
  • CoreBluetoothin tilan palautus on käytössä, joten asiakas voi palauttaa olemassa olevan yhteyden, jos sovellus käynnistetään uudelleen järjestelmän toimesta.
  • Mittaushistoria on rajattu 100 tietueeseen, mikä vastaa noin 100 sekuntia tietoa oletuspäivitysvälillä.

Huomautukset ja rajoitukset

  • Tämä työkalu käyttää Bluetooth LE -yhteyttä, ei Wi-Fi-verkkoa. Molempien laitteiden on oltava BLE-kantaman sisällä.
  • Vain yksi palvelinyhteys on tuettu kerrallaan.
  • RSSI on likimääräinen signaalin voimakkuuden mittari ja voi vaihdella ympäristötekijöiden vuoksi.
  • Mittausvirrassa on mukana CPU-käyttö, ydinkohtainen käyttö, ytimien määrä ja laitteen tunnistetiedot. Muita laitetietoja (muisti, tallennustila, lämpötila) ei tällä hetkellä välitetä.
  • visionOS-alustalla Metrics Client ei ole saatavilla, koska BLE Central -roolia ei tueta kyseisellä alustalla.