Saltar para o conteúdo principal

Metrics Client

Descubra servidores Metrics próximos e visualize métricas do dispositivo em tempo real transmitidas via Bluetooth LE.

Separador Discovery: a pesquisar servidores Metrics próximos com estado e controlos de atualização.
Quando não são encontrados servidores, uma lista de verificação ajuda na resolução de problemas.
Separador Discovery com indicador de pesquisa e lista de servidores disponíveis.

Visão geral​

O Metrics Client liga-se a um Metrics Server a correr noutro dispositivo e apresenta as métricas em tempo real do servidor. Recebe uso da CPU, atividade por núcleo, identidade do dispositivo (nome do servidor, modelo do dispositivo, nome do dispositivo) e carimbos temporais — tudo transmitido via Bluetooth Low Energy.

Índice​

Separadores​

O Metrics Client tem dois separadores. Pode deslizar entre eles ou tocar nos títulos dos separadores.

  • Discovery — pesquisa e liga-se a servidores próximos.
  • Metrics — visualiza dados em direto do servidor ligado.

Separador Discovery​

O separador Discovery é o ecrã inicial. Pesquisa periféricos Metrics Server próximos e permite ligar a um deles.

Cartão de estado de descoberta​

O cartão de estado mostra:

  • Um indicador de pesquisa — um ponto colorido com uma etiqueta:
    • A pesquisar (azul, com animação de carregamento) — a pesquisar ativamente periféricos.
    • Inativo (cinzento) — pesquisa pausada.
  • Servidores descobertos — a contagem de periféricos Metrics Server atualmente visíveis.
  • Um botão Atualizar — para e reinicia a pesquisa BLE para detetar novos servidores.

A pesquisa inicia automaticamente ao abrir a ferramenta.

Lista de servidores disponíveis​

Abaixo do cartão de estado, os servidores descobertos são listados. Apenas periféricos que anunciam o UUID do serviço Metrics Server BLE são mostrados — outros dispositivos Bluetooth são filtrados.

Quando não são encontrados servidores, é exibida uma lista de verificação para resolução de problemas:

  • Um dispositivo está a correr a ferramenta Metrics Server
  • Permissão de Rede Local concedida nas Definições
  • Ambos os dispositivos estão na mesma rede / dentro do alcance BLE

Servidores que desaparecem dos anúncios BLE são mantidos na lista por um curto período de tolerância (3 segundos) para evitar cintilação.

Linha do servidor​

Cada servidor descoberto é apresentado numa linha contendo:

  • Nome do servidor — o nome configurado no Metrics Server (ex. "iPhone 16 Pro Max (iPhone17,2)"). Os nomes apresentados são desacelerados por 1,5 segundos para evitar cintilação rápida quando o nome do anúncio BLE muda.
  • RSSI — a força do sinal em dBm, com um indicador de sinal de 3 barras codificado por cor:
    • Verde (3 barras) — sinal forte (>= -60 dBm)
    • Laranja (2 barras) — sinal moderado (>= -75 dBm)
    • Vermelho (1 barra) — sinal fraco (< -75 dBm)
  • Disponibilidade do serviço — um ponto verde ou cinzento indicando se o servidor está a anunciar o UUID do serviço Metrics.
  • Um botão Ligar / Desligar:
    • Ligar (azul) — inicia uma ligação BLE a este servidor.
    • A ligar (cinzento, com spinner de carregamento) — ligação em progresso.
    • Desligar (vermelho) — desliga do servidor atual.

Só é suportada uma ligação a um servidor de cada vez. Enquanto se liga a um servidor, as outras linhas de servidores estão desativadas.

Separador Metrics​

Quando ligado, o separador Metrics apresenta dados em direto transmitidos pelo servidor. O cliente muda automaticamente para este separador após ligação bem-sucedida.

Cartão de estado da ligação​

O cartão superior mostra:

  • Estado da ligação — um ponto colorido com uma etiqueta:
    • Ligado (verde)
    • Desligado (vermelho)

Quando ligado, aparecem detalhes adicionais:

  • Força do sinal — um indicador de 5 barras com uma etiqueta de qualidade (Excelente, Boa, Razoável, Fraca, Muito Fraca) e o valor bruto do RSSI em dBm:

    Intervalo RSSIQualidadeBarras
    >= -50 dBmExcelente5
    -51 a -65 dBmBoa4
    -66 a -75 dBmRazoável3
    -76 a -85 dBmFraca2
    Abaixo de -85 dBmMuito Fraca1

  • Histórico RSSI — um gráfico de linha contínuo das leituras de força do sinal (até 120 amostras), fornecendo uma perceção visual da estabilidade da ligação.

  • Identidade do servidor — três linhas chave-valor mostrando os dados transmitidos pelo servidor:

    CampoDescrição
    Nome do ServidorO nome configurado no Metrics Server (ex. "iPhone 16 Pro Max (iPhone17,2)").
    Modelo do DispositivoO nome comercial do dispositivo servidor (ex. "iPhone 16 Pro Max").
    DispositivoO nome do dispositivo atribuído pelo utilizador nas Definições iOS (ex. "iPhone 16ProMax do Rogério").

  • Mensagens de erro — se ocorrerem erros BLE (falha de ligação, desligação, etc.), aparecem como aviso vermelho.

  • Um botão Desligar (vermelho, largura total) para terminar a ligação.

Cartão de métricas em tempo real​

Quando as métricas são recebidas, este cartão apresenta:

CampoDescrição
Uso da CPUPercentagem atual de uso global da CPU do dispositivo servidor (ex. 30,0%), mostrado como número grande.
Número de núcleosNúmero de núcleos da CPU no dispositivo servidor (ex. 6).
Última atualizaçãoCarimbo temporal do pacote de métricas mais recente, mostrado como string de hora.

Histórico de uso da CPU​

Um gráfico de linha contínuo mostrando o uso da CPU do servidor ao longo do tempo. O gráfico mantém até 100 pontos de dados, correspondendo a cerca de 100 segundos de histórico à taxa de atualização de 1 segundo.

Uso por núcleo​

Quando o servidor fornece dados por núcleo, é apresentada uma vista Uso por núcleo abaixo do gráfico histórico. Esta mostra a percentagem de uso atual para cada núcleo individual da CPU, correspondendo à mesma visualização por núcleo usada na ferramenta CPU Monitor.

Estado sem métricas​

Quando não está ligado ou ainda não chegaram métricas, o separador Metrics mostra um espaço reservado com um ícone de gráfico e um convite para ligar a um servidor usando o separador Discovery.

Como usar com Metrics Server​

  1. No dispositivo que pretende observar, abra Ferramentas > Metrics Server e toque em Iniciar Servidor.
  2. No dispositivo a correr Metrics Client, abra Ferramentas > Metrics Client.
  3. No separador Discovery, encontre o servidor e toque em Ligar.
  4. O cliente muda automaticamente para o separador Metrics para mostrar as leituras em direto.

Permissões​

  • Permissão Bluetooth — necessária para pesquisa e ligação BLE. Se a permissão for negada, ative o acesso Bluetooth para Lirum nas Definições iOS.
  • A permissão Bluetooth é gerida automaticamente pelo CoreBluetooth. O pedido do sistema aparece na primeira inicialização da ferramenta.

Detalhes técnicos​

  • O cliente atua como um Central BLE usando CBCentralManager. Pesquisa todos os periféricos próximos e filtra a lista para mostrar apenas os que anunciam o UUID do serviço Metrics Server.
  • Após ligação, o cliente descobre o serviço GATT Metrics Server e subscreve as características de notificação summary e per-core.
  • As métricas chegam como payloads binários aproximadamente uma vez por segundo. O cliente decodifica:
    • Summary: nome do servidor, modelo do dispositivo, nome do dispositivo, uso global da CPU (Float), número de núcleos (UInt16), carimbo temporal (UInt64 em milissegundos).
    • Per-core: número de núcleos, array de uso por núcleo (Float por núcleo), carimbo temporal (UInt64 em milissegundos).
  • O cliente suporta os formatos de payload v1 (legado) e v2 (atual) para compatibilidade com versões antigas do Metrics Server. A v2 adiciona modelo do dispositivo, nome do servidor como campos separados e carimbos temporais com precisão de milissegundos.
  • O RSSI do servidor ligado é lido a cada 2 segundos via readRSSI(). Mantém-se um histórico de RSSI até 120 amostras para o gráfico de sinal.
  • Suavização do sinal — na lista de descoberta, os valores RSSI são suavizados exponencialmente (alpha = 0,15) para reduzir tremores visuais nas barras de sinal.
  • Estabilização do nome — os nomes apresentados dos servidores na lista de descoberta são desacelerados por 1,5 segundos para evitar cintilação quando os nomes dos anúncios BLE mudam rapidamente.
  • Período de tolerância para desaparecimento — servidores que desaparecem dos anúncios BLE são mantidos na lista por 3 segundos antes de serem removidos, evitando cintilação da lista.
  • A restauração do estado CoreBluetooth está ativada, permitindo ao cliente recuperar uma ligação existente se a app for relançada pelo sistema.
  • O histórico de métricas é limitado a 100 entradas, correspondendo a cerca de 100 segundos de dados ao intervalo padrão de atualização de 1 segundo.

Notas e limitações​

  • Esta ferramenta usa Bluetooth LE, não rede Wi-Fi. Ambos os dispositivos devem estar dentro do alcance BLE.
  • Só é suportada uma ligação a um servidor de cada vez.
  • O RSSI é um indicador aproximado da força do sinal e pode flutuar devido a fatores ambientais.
  • O fluxo de métricas inclui uso da CPU, uso por núcleo, número de núcleos e identidade do dispositivo. Outras métricas do dispositivo (memória, armazenamento, térmicas) não são atualmente transmitidas.
  • No visionOS, o Metrics Client não está disponível porque o papel central BLE não é suportado nessa plataforma.
Última atualização a por Rogerio Hirooka