Aller au contenu principal

Metrics Client

Découvrez les serveurs Metrics à proximité et visualisez les métriques en direct de l'appareil transmises via Bluetooth LE.

Onglet Découverte : recherche des serveurs Metrics à proximité avec statut et contrôles de rafraîchissement.
Lorsqu'aucun serveur n'est trouvé, une liste de vérification aide au dépannage.
Onglet Découverte avec indicateur de recherche et liste des serveurs disponibles.

Vue d'ensemble​

Metrics Client se connecte à un Metrics Server fonctionnant sur un autre appareil et affiche en temps réel les métriques en direct du serveur. Il reçoit l'utilisation CPU, l'activité CPU par cœur, l'identité de l'appareil (nom du serveur, modèle de l'appareil, nom de l'appareil) et les horodatages — le tout transmis via Bluetooth Low Energy.

Table des matières​

Onglets​

Metrics Client dispose de deux onglets. Vous pouvez glisser entre eux ou toucher les titres des onglets.

  • Découverte — rechercher et se connecter aux serveurs à proximité.
  • Metrics — afficher les données en direct du serveur connecté.

Onglet Découverte​

L'onglet Découverte est l'écran d'accueil. Il recherche les périphériques Metrics Server à proximité et vous permet de vous connecter à l'un d'eux.

Carte de statut de découverte​

La carte de statut affiche :

  • Un indicateur de recherche — un point coloré avec une étiquette :
    • Recherche (bleu, avec animation de chargement) — recherche active des périphériques.
    • Inactif (gris) — la recherche est en pause.
  • Serveurs découverts — le nombre de périphériques Metrics Server actuellement visibles.
  • Un bouton Rafraîchir — arrête et relance la recherche BLE pour détecter de nouveaux serveurs.

La recherche démarre automatiquement à l'ouverture de l'outil.

Liste des serveurs disponibles​

Sous la carte de statut, les serveurs découverts sont listés. Seuls les périphériques annonçant le service BLE Metrics Server UUID sont affichés — les autres appareils Bluetooth sont filtrés.

Lorsqu'aucun serveur n'est trouvé, une liste de vérification pour le dépannage est affichée :

  • Un appareil exécute l'outil Metrics Server
  • La permission Réseau local est accordée dans les Réglages
  • Les deux appareils sont sur le même réseau / à portée BLE

Les serveurs qui disparaissent des annonces BLE sont conservés dans la liste pendant une courte période de grâce (3 secondes) pour éviter le scintillement.

Ligne de serveur​

Chaque serveur découvert est affiché sous forme de ligne contenant :

  • Nom du serveur — le nom configuré dans Metrics Server (ex. « iPhone 16 Pro Max (iPhone17,2) »). Les noms affichés sont temporisés sur 1,5 seconde pour éviter un scintillement rapide lors des changements de nom dans l'annonce BLE.
  • RSSI — la puissance du signal en dBm, avec un indicateur de signal à 3 barres codé par couleur :
    • Vert (3 barres) — signal fort (>= -60 dBm)
    • Orange (2 barres) — signal modéré (>= -75 dBm)
    • Rouge (1 barre) — signal faible (< -75 dBm)
  • Disponibilité du service — un point vert ou gris indiquant si le serveur annonce le service Metrics UUID.
  • Un bouton Connecter / Déconnecter :
    • Connecter (bleu) — initie une connexion BLE à ce serveur.
    • Connexion en cours (gris, avec spinner) — connexion en cours.
    • Déconnecter (rouge) — déconnecte du serveur actuel.

Une seule connexion serveur est supportée à la fois. Pendant la connexion à un serveur, les autres lignes sont désactivées.

Onglet Metrics​

Une fois connecté, l'onglet Metrics affiche les données en direct transmises par le serveur. Le client bascule automatiquement sur cet onglet après une connexion réussie.

Carte de statut de connexion​

La carte supérieure affiche :

  • État de la connexion — un point coloré avec une étiquette :
    • Connecté (vert)
    • Déconnecté (rouge)

Lorsque connecté, des détails supplémentaires apparaissent :

  • Force du signal — un indicateur à 5 barres avec une étiquette de qualité (Excellent, Bon, Moyen, Faible, Très faible) et la valeur brute RSSI en dBm :

    Plage RSSIQualitéBarres
    >= -50 dBmExcellent5
    -51 à -65 dBmBon4
    -66 à -75 dBmMoyen3
    -76 à -85 dBmFaible2
    En dessous de -85 dBmTrès faible1

  • Historique RSSI — un graphique linéaire déroulant des lectures de la force du signal (jusqu'à 120 échantillons), offrant une vue visuelle de la stabilité de la connexion.

  • Identité du serveur — trois lignes clé-valeur montrant les données transmises par le serveur :

    ChampDescription
    Nom du serveurLe nom configuré dans Metrics Server (ex. « iPhone 16 Pro Max (iPhone17,2) »).
    Modèle de l'appareilLe nom marketing de l'appareil serveur (ex. « iPhone 16 Pro Max »).
    AppareilLe nom d'appareil assigné par l'utilisateur dans les Réglages iOS (ex. « iPhone 16ProMax de Rogerio »).

  • Messages d'erreur — en cas d'erreurs BLE (échec de connexion, déconnexion, etc.), elles apparaissent en rouge.

  • Un bouton Déconnecter (rouge, pleine largeur) pour terminer la connexion.

Carte des métriques en temps réel​

Lorsque des métriques sont reçues, cette carte affiche :

ChampDescription
Utilisation CPULe pourcentage d'utilisation CPU global actuel de l'appareil serveur (ex. 30,0 %), affiché en grand.
Nombre de cœursLe nombre de cœurs CPU de l'appareil serveur (ex. 6).
Dernière mise à jourL'horodatage du dernier paquet de métriques, affiché sous forme d'heure.

Historique d'utilisation CPU​

Un graphique linéaire déroulant montrant l'utilisation CPU du serveur dans le temps. Le graphique conserve jusqu'à 100 points de données, soit environ 100 secondes d'historique avec une mise à jour chaque seconde.

Utilisation par cœur​

Lorsque le serveur fournit des données CPU par cœur, une vue Utilisation par cœur est affichée sous le graphique d'historique. Elle montre le pourcentage d'utilisation actuel pour chaque cœur CPU individuel, utilisant la même visualisation par cœur que l'outil CPU Monitor.

État sans métriques​

Lorsqu'aucune connexion n'est établie ou qu'aucune métrique n'est encore arrivée, l'onglet Metrics affiche un espace réservé avec une icône de graphique et une invite à se connecter à un serveur via l'onglet Découverte.

Comment utiliser avec Metrics Server​

  1. Sur l'appareil que vous souhaitez observer, ouvrez Outils > Metrics Server et touchez Démarrer le serveur.
  2. Sur l'appareil exécutant Metrics Client, ouvrez Outils > Metrics Client.
  3. Dans l'onglet Découverte, trouvez le serveur et touchez Connecter.
  4. Le client bascule automatiquement sur l'onglet Metrics pour afficher les lectures en direct.

Permissions​

  • Permission Bluetooth — requise pour la recherche et la connexion BLE. Si la permission est refusée, activez l'accès Bluetooth pour Lirum dans les Réglages iOS.
  • La permission Bluetooth est gérée automatiquement par CoreBluetooth. L'invite système apparaît lors de la première initialisation de l'outil.

Détails techniques​

  • Le client agit en tant que Central BLE utilisant CBCentralManager. Il scanne tous les périphériques à proximité et filtre la liste pour n'afficher que ceux annonçant le service Metrics Server UUID.
  • Lors de la connexion, le client découvre le service GATT Metrics Server et s'abonne aux caractéristiques summary et per-core en notification.
  • Les métriques arrivent sous forme de charges binaires environ une fois par seconde. Le client décode :
    • Summary : nom du serveur, modèle de l'appareil, nom de l'appareil, utilisation CPU globale (Float), nombre de cœurs (UInt16), horodatage (UInt64 en millisecondes).
    • Per-core : nombre de cœurs, tableau d'utilisation par cœur (Float par cœur), horodatage (UInt64 en millisecondes).
  • Le client supporte les formats de charge v1 (héritage) et v2 (actuel) pour compatibilité avec les anciennes versions de Metrics Server. La v2 ajoute le modèle de l'appareil, le nom du serveur en champs séparés, et des horodatages à la milliseconde.
  • Le RSSI du serveur connecté est relevé toutes les 2 secondes via readRSSI(). Un historique RSSI jusqu'à 120 échantillons est conservé pour le graphique de signal.
  • Lissage du signal — dans la liste de découverte, les valeurs RSSI sont lissées exponentiellement (alpha = 0,15) pour réduire les fluctuations visuelles des barres de signal.
  • Stabilisation du nom — les noms affichés des serveurs dans la liste de découverte sont temporisés sur 1,5 seconde pour éviter le scintillement lors de changements rapides des noms d'annonce BLE.
  • Période de grâce de disparition — les serveurs qui disparaissent des annonces BLE sont conservés dans la liste pendant 3 secondes avant suppression, évitant le scintillement de la liste.
  • La restauration d'état CoreBluetooth est activée, permettant au client de récupérer une connexion existante si l'app est relancée par le système.
  • L'historique des métriques est limité à 100 entrées, correspondant à environ 100 secondes de données avec l'intervalle de mise à jour par défaut d'une seconde.

Notes et limitations​

  • Cet outil utilise Bluetooth LE, pas le réseau Wi-Fi. Les deux appareils doivent être à portée BLE.
  • Une seule connexion serveur est supportée à la fois.
  • Le RSSI est un indicateur approximatif de la force du signal et peut fluctuer selon l'environnement.
  • Le flux de métriques inclut l'utilisation CPU, l'utilisation par cœur, le nombre de cœurs et l'identité de l'appareil. D'autres métriques (mémoire, stockage, thermiques) ne sont pas transmises actuellement.
  • Sur visionOS, Metrics Client n'est pas disponible car le rôle central BLE n'est pas supporté sur cette plateforme.
Dernière mise à jour le par Rogerio Hirooka