Cliente de Métricas
Descubre servidores de métricas cercanos y visualiza métricas del dispositivo en tiempo real transmitidas por Bluetooth LE.
Visión general
El Cliente de Métricas se conecta a un Servidor de Métricas que se ejecuta en otro dispositivo y muestra las métricas en vivo del servidor en tiempo real. Recibe uso de CPU, actividad de CPU por núcleo, identidad del dispositivo (nombre del servidor, modelo del dispositivo, nombre del dispositivo) y marcas de tiempo — todo transmitido por Bluetooth Low Energy.
Tabla de contenido
- Pestañas
- Pestaña Descubrimiento
- Pestaña Métricas
- Cómo usar con el Servidor de Métricas
- Permisos
- Detalles técnicos
- Notas y limitaciones
Pestañas
El Cliente de Métricas tiene dos pestañas. Puedes deslizar entre ellas o tocar los títulos de las pestañas.
- Descubrimiento — buscar y conectarse a servidores cercanos.
- Métricas — ver datos en vivo del servidor conectado.
Pestaña Descubrimiento
La pestaña Descubrimiento es la pantalla inicial. Busca periféricos de Servidor de Métricas cercanos y te permite conectarte a uno.
Tarjeta de estado de descubrimiento
La tarjeta de estado muestra:
- Un indicador de escaneo — un punto de color con una etiqueta:
- Escaneando (azul, con animación de carga) — buscando activamente periféricos.
- Inactivo (gris) — el escaneo está pausado.
- Servidores descubiertos — el recuento de periféricos de Servidor de Métricas actualmente visibles.
- Un botón Actualizar — detiene y reinicia el escaneo BLE para detectar nuevos servidores.
El escaneo comienza automáticamente cuando se abre la herramienta.
Lista de servidores disponibles
Debajo de la tarjeta de estado, se listan los servidores descubiertos. Solo se muestran los periféricos que anuncian el UUID del servicio BLE del Servidor de Métricas — otros dispositivos Bluetooth se filtran.
Cuando no se encuentran servidores, se muestra una lista de verificación para solución de problemas:
- Un dispositivo está ejecutando la herramienta Servidor de Métricas
- El permiso de Red Local está concedido en Ajustes
- Ambos dispositivos están en la misma red / dentro del alcance BLE
Los servidores que desaparecen de los anuncios BLE se mantienen en la lista durante un breve período de gracia (3 segundos) para evitar parpadeos.
Fila de servidor
Cada servidor descubierto se muestra como una fila que contiene:
- Nombre del servidor — el nombre configurado en el Servidor de Métricas (ej. "iPhone 16 Pro Max (iPhone17,2)"). Los nombres mostrados tienen un retardo de 1.5 segundos para evitar parpadeos rápidos cuando el nombre del anuncio BLE cambia.
- RSSI — la intensidad de la señal en dBm, con un indicador de señal de 3 barras codificado por colores:
- Verde (3 barras) — señal fuerte (>= -60 dBm)
- Naranja (2 barras) — señal moderada (>= -75 dBm)
- Rojo (1 barra) — señal débil (< -75 dBm)
- Disponibilidad del servicio — un punto verde o gris indicando si el servidor está anunciando el UUID del servicio de Métricas.
- Un botón Conectar / Desconectar:
- Conectar (azul) — inicia una conexión BLE a este servidor.
- Conectando (gris, con indicador de carga) — conexión en progreso.
- Desconectar (rojo) — desconecta del servidor actual.
Solo se admite una conexión de servidor a la vez. Mientras se conecta a un servidor, las filas de otros servidores están deshabilitadas.
Pestaña Métricas
Cuando está conectado, la pestaña Métricas muestra datos en vivo transmitidos desde el servidor. El cliente cambia automáticamente a esta pestaña tras una conexión exitosa.
Tarjeta de estado de conexión
La tarjeta superior muestra:
- Estado de conexión — un punto de color con una etiqueta:
- Conectado (verde)
- Desconectado (rojo)
Cuando está conectado, aparecen detalles adicionales:
-
Intensidad de la señal — un indicador de 5 barras con una etiqueta de calidad (Excelente, Buena, Regular, Pobre, Muy pobre) y el valor RSSI en bruto en dBm:
Rango RSSI Calidad Barras >= -50 dBm Excelente 5 -51 a -65 dBm Buena 4 -66 a -75 dBm Regular 3 -76 a -85 dBm Pobre 2 Por debajo de -85 dBm Muy pobre 1 -
Historial RSSI — un gráfico de línea continuo de las lecturas de intensidad de señal (hasta 120 muestras), proporcionando una noción visual de la estabilidad de la conexión.
-
Identidad del servidor — tres filas clave-valor mostrando los datos transmitidos por el servidor:
Campo Descripción Nombre del servidor El nombre configurado en el Servidor de Métricas (ej. "iPhone 16 Pro Max (iPhone17,2)"). Modelo del dispositivo El nombre comercial del dispositivo servidor (ej. "iPhone 16 Pro Max"). Dispositivo El nombre del dispositivo asignado por el usuario desde Ajustes de iOS (ej. "iPhone 16ProMax de Rogerio"). -
Mensajes de error — si ocurren errores BLE (fallo de conexión, desconexión, etc.), aparecen como una advertencia roja.
-
Un botón Desconectar (rojo, ancho completo) para terminar la conexión.
Tarjeta de métricas en tiempo real
Cuando se reciben métricas, esta tarjeta muestra:
| Campo | Descripción |
|---|---|
| Uso de CPU | El porcentaje actual de uso general de CPU del dispositivo servidor (ej. 30.0%), mostrado como un número grande. |
| Número de núcleos | El número de núcleos de CPU en el dispositivo servidor (ej. 6). |
| Última actualización | La marca de tiempo del paquete de métricas más reciente, mostrada como una cadena de tiempo. |
Historial de uso de CPU
Un gráfico de línea continuo mostrando el uso de CPU del servidor a lo largo del tiempo. El gráfico mantiene hasta 100 puntos de datos, proporcionando aproximadamente 100 segundos de historial a la tasa de actualización de 1 segundo.
Uso por núcleo
Cuando el servidor proporciona datos de CPU por núcleo, se muestra una vista de Uso por núcleo debajo del gráfico de historial. Esta muestra el porcentaje de uso actual para cada núcleo de CPU individual, coincidiendo con la misma visualización por núcleo usada en la herramienta Monitor de CPU.
Estado sin métricas
Cuando no está conectado o cuando aún no han llegado métricas, la pestaña Métricas muestra un marcador de posición con un icono de gráfico y una indicación para conectarse a un servidor usando la pestaña Descubrimiento.
Cómo usar con el Servidor de Métricas
- En el dispositivo que deseas observar, abre Herramientas > Servidor de Métricas y toca Iniciar servidor.
- En el dispositivo que ejecuta el Cliente de Métricas, abre Herramientas > Cliente de Métricas.
- En la pestaña Descubrimiento, encuentra el servidor y toca Conectar.
- El cliente cambia automáticamente a la pestaña Métricas para mostrar las lecturas en vivo.
Permisos
- Permiso de Bluetooth — requerido para escaneo y conexión BLE. Si el permiso es denegado, habilita el acceso a Bluetooth para Lirum en Ajustes de iOS.
- El permiso de Bluetooth es manejado automáticamente por CoreBluetooth. El aviso del sistema aparece la primera vez que la herramienta se inicializa.
Detalles técnicos
- El cliente actúa como un BLE Central usando
CBCentralManager. Escanea todos los periféricos cercanos y filtra la lista para mostrar solo aquellos que anuncian el UUID del servicio del Servidor de Métricas. - Tras la conexión, el cliente descubre el servicio GATT del Servidor de Métricas y se suscribe tanto a las características de notificación de resumen como de por núcleo.
- Las métricas llegan como cargas binarias aproximadamente una vez por segundo. El cliente decodifica:
- Resumen: nombre del servidor, modelo del dispositivo, nombre del dispositivo, uso general de CPU (Float), número de núcleos (UInt16), marca de tiempo (UInt64 milisegundos).
- Por núcleo: número de núcleos, array de uso por núcleo (Float por núcleo), marca de tiempo (UInt64 milisegundos).
- El cliente soporta tanto los formatos de carga v1 (legado) como v2 (actual) para compatibilidad con versiones anteriores del Servidor de Métricas. v2 añade modelo del dispositivo, nombre del servidor como campos separados, y marcas de tiempo con precisión de milisegundos.
- El RSSI del servidor conectado se consulta cada 2 segundos mediante
readRSSI(). Se mantiene un historial RSSI de hasta 120 muestras para el gráfico de señal. - Suavizado de señal — en la lista de descubrimiento, los valores RSSI se suavizan exponencialmente (alpha = 0.15) para reducir el parpadeo visual en las barras de señal.
- Estabilización de nombres — los nombres mostrados de servidores en la lista de descubrimiento tienen un retardo de 1.5 segundos para prevenir parpadeos cuando los nombres de anuncios BLE cambian rápidamente.
- Período de gracia de desaparición — los servidores que desaparecen de los anuncios BLE se retienen en la lista durante 3 segundos antes de ser eliminados, previniendo que la lista parpadee.
- La restauración de estado de CoreBluetooth está habilitada, permitiendo al cliente recuperar una conexión existente si la app es relanzada por el sistema.
- El historial de métricas está limitado a 100 entradas, correspondiendo aproximadamente a 100 segundos de datos en el intervalo de actualización predeterminado de 1 segundo.
Notas y limitaciones
- Esta herramienta usa Bluetooth LE, no redes Wi-Fi. Ambos dispositivos deben estar dentro del alcance BLE.
- Solo se admite una conexión de servidor a la vez.
- RSSI es un indicador aproximado de la intensidad de la señal y puede fluctuar debido a factores ambientales.
- La transmisión de métricas incluye uso de CPU, uso por núcleo, número de núcleos e identidad del dispositivo. Otras métricas del dispositivo (memoria, almacenamiento, temperaturas) no se transmiten actualmente.
- En visionOS, el Cliente de Métricas no está disponible porque el rol de central BLE no está soportado en esa plataforma.