Metrics Server

Lähetä laitteen reaaliaikaiset mittaritiedot lähistöllä oleville laitteille Bluetooth LE:n kautta.

Metrics Server: tilakortti, jossa on muokattava palvelimen nimi, palvelimen ohjaimet, yhdistettyjen asiakkaiden määrä ja nykyiset mittarit.

Aseta mukautettu palvelimen nimi tai valitse esiasetuksista, kuten markkinointinimi, mallin tunniste tai laitteen nimi.

Nykyiset mittarit -kortti näyttää CPU-käytön, ytimien määrän, laitteen nimen ja reaaliaikaisen käyttöhistorian kaavion.

Yleiskatsaus

Metrics Server muuttaa laitteesi Bluetooth Low Energy (BLE) -laitteeksi, joka lähettää reaaliaikaisia laitetietoja lähistöllä oleville Metrics Client -sovellusta käyttäville laitteille. Yhdistetyt asiakkaat vastaanottavat jatkuvaa tietovirtaa, joka sisältää mm. CPU-käytön, ytimikohtaisen CPU-aktiivisuuden, laitteen tunnistetiedot ja aikaleimat — kaikki lähetetään kerran sekunnissa BLE notify -ominaisuuksien kautta.

Tämä on hyödyllistä, kun haluat seurata yhden laitteen suorituskykyä toisesta laitteesta reaaliajassa ilman Wi-Fi-verkkoa tai muuta infrastruktuuria.

Sisällysluettelo

• Pääosiot
• Metrics Server -tilakortti
• Palvelimen nimi ja esiasetukset
• Palvelimen ohjaimet
• Yhdistetyt asiakkaat
• Nykyiset mittarit
• Lähetettävät tiedot
• Käyttö Metrics Clientin kanssa
• Tekniset tiedot
• Huomautukset ja rajoitukset

Pääosiot

Metrics Server koostuu yhdestä vieritettävästä näkymästä, jossa on neljä korttia:

• Metrics Server — tila ja palvelimen nimen määritys
• Palvelimen ohjaimet — BLE-lähetyksen käynnistys/pysäytys
• Yhdistetyt asiakkaat — tilattujen laitteiden määrä
• Nykyiset mittarit — lähetettävien tietojen reaaliaikainen esikatselu

Metrics Server -tilakortti

Ylin kortti näyttää:

• Käynnissä-osoitin — värillinen piste ja selite:
  • Käynnissä (vihreä) — palvelin mainostaa ja lähettää tietoja aktiivisesti.
  • Pysäytetty (punainen) — palvelin ei mainosta.
• Palvelimen nimi -kenttä — muokattava tekstikenttä, joka määrittää nimen, jonka muut laitteet näkevät BLE-haussa. Katso Palvelimen nimi ja esiasetukset lisätietoja.
• Tila — Aktiivinen tai Ei aktiivinen.
• Bluetooth-tila — Bluetooth-radion nykyinen tila (Päällä, Pois päältä, Ei oikeuksia, Ei tuettu, Nollataan, Tuntematon).
• Yhdistetty — tällä hetkellä mittarivirtaan tilattujen asiakaslaitteiden määrä.
• Virhe — mahdollinen BLE-pinon virheilmoitus (näkyy vain virhetilanteessa).

Palvelimen nimi ja esiasetukset

Palvelimen nimi määrittää, miten tämä laite näkyy Metrics Client -käyttäjille haun aikana. Voit kirjoittaa minkä tahansa mukautetun nimen tai käyttää Esiasetukset-pudotusvalikkoa valitaksesi jonkin valmiista vaihtoehdoista:

Esiasetus	Esimerkki
Markkinointinimi + mallin tunniste	iPhone 16 Pro Max (iPhone17,2)
Vain markkinointinimi	iPhone 16 Pro Max
Vain mallin tunniste	iPhone17,2
Laitteen nimi	Rogerio's iPhone 16ProMax

Oletuksena käytetään Markkinointinimi (Mallin tunniste), jos saatavilla.

Nimen muuttaminen palvelimen ollessa käynnissä käynnistää BLE-mainostuksen automaattisesti uudelleen, jolloin uusi nimi tulee heti voimaan.

Palvelimen ohjaimet

Palvelimen ohjaimet -kortissa on yksi Käynnistä palvelin / Pysäytä palvelin -painike:

• Käynnistä palvelin (vihreä) — aloittaa BLE-mainostuksen ja käynnistää CPU-mittareiden keruun. Palvelin alkaa lähettää tietoja heti, kun asiakas tilaa.
• Pysäytä palvelin (punainen) — pysäyttää BLE-mainostuksen ja lopettaa mittaustiedon keruun.

Painikkeen alla oleva kuvaus kertoo, että palvelin lähettää mittaritietoja yhdistetyille asiakkaille Bluetooth LE:n kautta.

Yhdistetyt asiakkaat

Yhdistetyt asiakkaat -kortti näyttää:

• Tällä hetkellä tilattujen asiakaslaitteiden määrän (näkyy suurena numerona).
• Kun asiakkaita ei ole yhdistetty: paikkamerkki, jossa on kuvake ja viesti palvelimen käynnistämisestä sekä Metrics Clientin käytöstä toisella laitteella.
• Kun asiakkaita on yhdistetty: vahvistusviesti, jossa näkyy määrä (esim. ”1 asiakas vastaanottaa mittaritietoja”).

Palvelin lähettää tietoja vain, kun vähintään yksi asiakas on tilannut. Kun asiakkaita ei ole yhdistetty, sisäinen ajastin pysäytetään resurssien säästämiseksi.

Nykyiset mittarit

Nykyiset mittarit -kortti näyttää reaaliaikaisen esikatselun lähetettävistä tiedoista:

Kenttä	Kuvaus
CPU-käyttö	Tämän laitteen nykyinen kokonais-CPU-käyttöprosentti (esim. 30,0%).
Ytimien määrä	Tämän laitteen CPU-ytimien määrä (esim. 6).
Laite	Käyttäjän määrittämä laitteen nimi (esim. "Rogerio's iPhone 16ProMax").

Näiden kenttien alla Käyttöhistoria-viivakaavio näyttää CPU-käytön kehityksen ajan myötä, tarjoten visuaalisen kuvan kuormituksen vaihtelusta.

Lähetettävät tiedot

Palvelin lähettää kaksi BLE notify -ominaisuutta kerran sekunnissa kaikille tilanneille asiakkaille:

Yhteenveto-ominaisuus

Sisältää seuraavat kentät tiiviissä binäärimuodossa:

Kenttä	Tyyppi	Kuvaus
Palvelimen nimi	Merkkijono (enint. 32 merkkiä)	Muokattava nimi, joka näkyy tilakortissa.
Laitemalli	Merkkijono (enint. 32 merkkiä)	Laitteen markkinointinimi (esim. "iPhone 16 Pro Max").
Laitteen nimi	Merkkijono (enint. 32 merkkiä)	Käyttäjän määrittämä laitteen nimi iOS-asetuksista.
CPU-käyttö	Float (32-bittinen)	Kokonais-CPU-käyttö prosentteina (0–100).
Ytimien määrä	UInt16	CPU-ytimien määrä.
Aikaleima	UInt64	Millisekunteina Unix-epookista.

Ydinkohtainen ominaisuus

Sisältää ytimikohtaiset CPU-käyttötiedot:

Kenttä	Tyyppi	Kuvaus
Ytimien määrä	UInt8	Ytimien määrä (enintään 32).
Ydinkäytöt	Float[]	Yksi 32-bittinen float per ydin, kuvaa kyseisen ytimen käyttöprosenttia.
Aikaleima	UInt64	Millisekunteina Unix-epookista.

Käyttö Metrics Clientin kanssa

1. Laitteella, jota haluat tarkkailla, avaa Työkalut > Metrics Server ja napauta Käynnistä palvelin.
2. Toisella laitteella avaa Työkalut > Metrics Client.
3. Haku-välilehdellä etsi palvelin listasta ja napauta Yhdistä.
4. Asiakas siirtyy automaattisesti Mittarit-välilehdelle näyttämään reaaliaikaiset tiedot.

Tekniset tiedot

• Palvelin toimii BLE-perifeerinä käyttäen CBPeripheralManager-luokkaa. Se mainostaa mukautettua GATT-palvelua, jossa on kaksi vain notify-ominaisuutta (yhteenveto ja ydinkohtainen).
• Tiedot lähetetään kerran sekunnissa, kun vähintään yksi asiakas on tilannut. Ajastin pysäytetään, kun asiakkaita ei ole yhdistetty.
• Kaikki monitavuiset numeeriset arvot ovat little-endian-muodossa, kuten Swift tuottaa Applen alustoilla.
• Palvelin hyödyntää CoreBluetooth-tilan palautusta, jolloin mainostustila voidaan palauttaa, jos järjestelmä käynnistää sovelluksen uudelleen.
• BLE-takapaine käsitellään hallitusti — jos lähetysjono on täynnä, päivitykset jonotetaan ja lähetetään, kun järjestelmä ilmoittaa valmiudesta peripheralManagerIsReady(toUpdateSubscribers:)-kutsulla.
• CPU-mittarit kerätään samasta ToolCPUViewModel-luokasta kuin CPU Monitor -työkalussa, mikä takaa yhtenäiset lukemat.

Huomautukset ja rajoitukset

• Tämä työkalu käyttää Bluetooth LE:tä, ei Wi-Fi-verkkoa. Laitteiden on oltava BLE-kantaman sisällä (tyypillisesti 10–30 metriä sisätiloissa).
• BLE:n saatavuus, taustakäyttäytyminen ja yhteyden vakaus vaihtelevat laitteen ja käyttöjärjestelmäversion mukaan.
• visionOS-alustalla Metrics Server ei ole käytettävissä, koska BLE-perifeeriroolia ei tueta.
• Palvelimen nimi on rajoitettu 32 merkkiin BLE-payloadin kokorajoitusten vuoksi.
• Vain CPU:hun liittyvät mittarit lähetetään tällä hetkellä. Muut laitetiedot (muisti, lämpötila jne.) eivät sisälly BLE-virtaan.