Por que meus dados de saúde não estão chegando?

A maioria dos problemas com o app Life Dashboard se resume a quatro coisas: o celular encerra o app em segundo plano, o app do relógio não grava no Conexão Saúde (Health Connect), falta uma permissão, ou o celular não alcança o endereço para onde envia. Esta página passa por elas na ordem em que vale a pena conferir. O primeiro lugar para olhar é sempre a aba Logs do app: ela mostra cada sincronização e cada entrega com a resposta do servidor, e um toque em uma linha mostra os detalhes.

Por Owen Vogelaar, que mantém o Life Dashboard 9 min de leitura

Perguntar nas Discussions

A sincronização para quando o app está fechado

Se o app só sincroniza quando você o abre, o celular está encerrando as tarefas dele em segundo plano para economizar bateria. Samsung, Xiaomi, OnePlus, Huawei e outras marcas fazem isso, muitas vezes sem avisar. Mude estas configurações uma vez, logo depois de instalar:

  • Samsung: Configurações > Apps > Life Dashboard > Bateria, defina como Sem restrições. Depois, Configurações > Bateria (em algumas versões, dentro de Assistência do aparelho) > Limites de uso em segundo plano > Apps nunca em suspensão, e adicione o Life Dashboard.
  • Xiaomi, Redmi e POCO: ative o início automático para o Life Dashboard (nas versões mais novas, Background autostart nas permissões do app) e defina a economia de bateria dele como Sem restrições. Travar o app na tela de apps recentes, com um toque longo e o cadeado, também evita que ele seja limpo.
  • Pixel e outros celulares próximos do Android puro: Configurações > Apps > Life Dashboard > Uso da bateria pelo app, defina como Sem restrições.
  • OnePlus, Oppo, Huawei e outras marcas: defina o uso de bateria do app como Sem restrições (em algumas marcas a opção aparece como No restrictions) em Configurações > Apps > Life Dashboard, e procure um gerenciador separado de início automático ou de inicialização. Os menus mudam de lugar entre as versões; o dontkillmyapp.com mantém os passos atuais por marca.

Depois confira se a leitura em segundo plano continua permitida no Conexão Saúde (veja a próxima seção): sem ela, só o Sincronizar agora funciona. Mesmo com todas as configurações certas, o Android roda uma tarefa em segundo plano no máximo a cada 15 minutos, e pode esperar mais quando o celular fica parado. A aba Logs mostra quando as sincronizações de fato rodaram.

O Conexão Saúde está vazio ou o app não consegue lê-lo

  1. O Conexão Saúde está no celular. No Android 14 e mais recentes ele faz parte das configurações do sistema; procure por "Conexão Saúde" nas configurações (na Samsung fica em Segurança e privacidade). No Android 9 a 13, a aba Saúde do app oferece instalar ou atualizar. O Android 8 não tem suporte a ele; o tempo de tela continua funcionando ali.
  2. O app do seu relógio grava nele. Essa é uma configuração do outro app. No Samsung Health fica em Configurações > Conexão Saúde; no Garmin Connect fica em Settings > Connected Apps > Health Connect, no Android 14 ou mais recente. Os guias da Samsung, da Garmin e da Fitbit trazem os detalhes. Abrir app, na linha Acesso ao Conexão Saúde em O que enviar na aba Saúde, abre o Conexão Saúde, para você ver se os dados estão mesmo lá.
  3. O app pode ler os dados. Toque em Permitir na linha Acesso ao Conexão Saúde em O que enviar na aba Saúde. O Conexão Saúde pede acesso de leitura por tipo de dado e também a leitura em segundo plano; as sincronizações agendadas precisam dessa segunda permissão. Um tipo com cadeado em O que enviar ainda não tem permissão: desative e ative de novo para o pedido aparecer outra vez.
  4. O histórico mais antigo precisa de mais uma permissão. O Conexão Saúde só deixa um app ler dados de até 30 dias antes do primeiro acesso dele. Para ir além, a página do backfill (o envio de todo o histórico de uma vez) pede o acesso ao histórico.

Sincronizar agora diz "Nenhum dado novo"

Cada sincronização envia só o que há de novo desde a anterior, e a primeira de todas lê os últimos 7 dias. Prévia do payload em O que enviar na aba Saúde mostra o que a próxima sincronização enviaria. Para dados mais antigos, rode um backfill. Confira também se o relógio sincronizou com o celular: o Garmin Connect grava no Conexão Saúde depois que o relógio sincroniza, e o Samsung Health quando o relógio se conecta ou quando você abre o Samsung Health.

Valores noturnos como VFC, frequência respiratória e sono muitas vezes chegam horas depois de você acordar. Os apps de relógio só gravam a noite no Conexão Saúde quando sincronizam de manhã. O app envia esses dados na primeira sincronização depois disso; nada se perde.

Nenhum sensor no Home Assistant

  • Com a integração: Configurações > Dispositivos e serviços > Life Dashboard, depois o dispositivo do celular. Um sensor aparece quando o celular já enviou aquele tipo. Os IDs das entidades começam com o nome do celular, como sensor.owens_pixel_steps_today. Os sensores de tempo de tela por app são criados desativados: mostre as entidades desativadas do dispositivo e ative os apps que você quer.
  • O histórico não fica nos sensores, e sim nas estatísticas de longo prazo. Adicione um cartão Gráfico de estatísticas e escolha na lista as estatísticas do celular.
  • Com MQTT: Configurações > Dispositivos e serviços > MQTT, dispositivo Life Dashboard Companion.
  • Nada mesmo: confira a aba Logs. Uma entrega com falha significa que o celular não alcançou o Home Assistant; veja a próxima seção.

O celular não alcança o Home Assistant

O celular envia para o endereço que está no código de pareamento, então esse endereço precisa funcionar a partir do celular.

  • homeassistant.local falha com frequência no Android, que não resolve nomes .local de forma confiável. Use o endereço IP do Home Assistant no lugar, como http://192.168.1.10:8123; ele está em Configurações > Sistema > Rede.
  • Um endereço da rede de casa só funciona no Wi-Fi de casa. As sincronizações fora de casa falham, o celular guarda os dados, e a primeira sincronização de volta em casa os envia. Uma notificação sobre sincronizações com falha enquanto você está fora é isso.
  • Um endereço público, como uma URL do Home Assistant Cloud ou o seu próprio domínio https://, funciona em qualquer lugar.
  • "O HTTP sem criptografia está desativado": o endereço começa com http://. Ative Permitir webhooks com HTTP sem criptografia em Mais > Avançado para um servidor na sua própria rede ou VPN; os dados então trafegam sem criptografia nessa rede.
  • Um erro de certificado em https://: o seu servidor usa um certificado da sua própria CA, ou um autoassinado. Em Mais > Avançado > Certificados do servidor (app 1.27.0 e mais recentes), confie nos certificados de CA instalados no celular para aquele host, ou leia o certificado do servidor, confira a impressão digital dele e confie exatamente naquele. Não existe opção que ignore erros de certificado.

Para mudar o endereço depois, abra Reconfigurar na integração, no Home Assistant, mude o endereço ali e escaneie o novo código.

O pareamento não funciona

  • Escanear abre uma página da web em vez do app. O Android confere o link de pareamento com a assinatura do app na hora da instalação. A página tem um botão Open in the app que sempre funciona, e escanear de dentro do app, com Escanear um código de pareamento, nunca depende dessa conferência.
  • "Este código foi feito por uma versão mais nova". A integração é mais nova que o app. Atualize o app e escaneie de novo.
  • O pareamento funciona, mas nada chega. O endereço no código não é alcançável a partir do celular: veja a seção acima.

Números que parecem errados

  • Passos contados duas vezes? Não no Home Assistant. Quando o Samsung Health e a Garmin gravam a mesma caminhada, o Conexão Saúde guarda as duas cópias, mas também calcula um total diário que conta a sobreposição uma vez, e a integração usa esse total. Deixe Totais diários no payload ativado em Mais > Avançado. Passos do Conexão Saúde que parecem errados passa pelas outras causas.
  • O tempo de tela é diferente do Bem-estar digital. O dia do app começa às 04:00 por padrão, os apps usados por um minuto ou menos ficam de fora, e só o tempo com o app na tela conta.
  • Falta um campo, como um nutriente. O app envia todos os campos que o Conexão Saúde tem, mas só quando o app que gravou o registro os preencheu.

No iPhone

  • Um iPhone bloqueado não consegue ler o Apple Health. O iOS mantém os dados do app Saúde criptografados enquanto o iPhone está bloqueado, então uma sincronização nesse momento não lê nada; a próxima sincronização com o iPhone desbloqueado recupera o atraso.
  • Falta um tipo. Confira se ele está ativado em O que enviar. Quando o iOS ainda não perguntou sobre um tipo, a linha Acesso ao app Saúde ali mostra Permitir. O iOS nunca diz a um app se você permitiu a leitura, então um tipo que você recusou simplesmente não envia nada; mude isso no app Saúde, no seu perfil, em Apps, Life Dashboard.
  • Nada chega ao seu servidor. Toque no destino na aba Saúde e depois em Enviar teste. A aba Logs mostra o erro que o servidor ou o iOS devolveu. Para um servidor em casa, permita Rede Local para o Life Dashboard em Ajustes > Privacidade e Segurança.
  • As sincronizações chegam atrasadas. O iOS decide quando um app roda em segundo plano. A Atualização em 2º Plano precisa estar ativada para o app, e o Modo de Pouca Energia a desativa; a aba Saúde avisa quando um dos dois está segurando as sincronizações. Para um horário exato, Precisa de um horário exato? em Quando enviar explica a automação do Atalhos.
  • Há payloads esperando. A aba Saúde mostra quantos estão pendentes, e Tentar agora os envia na hora.
  • "Nenhum dado para sincronizar". Cada sincronização envia só o que há de novo desde a anterior. Prévia do payload em O que enviar mostra os últimos 7 dias como um payload. Para dados mais antigos, toque em Enviar histórico ali.

Life Dashboard

Ainda travado? Pergunte nas Discussions e inclua a linha da aba Logs; o guia de configuração tem a lista completa de problemas conhecidos.

Disponível no Google Play

€ 4,99 uma única vez no Google Play: o jeito fácil, com atualizações automáticas, e ainda apoia o desenvolvimento.

Ou de graça, o mesmo app com a mesma chave de assinatura: APK no GitHub · Obtainium · F‑Droid

Baixar na App Store

€ 6,99 uma única vez na App Store, sem assinatura.

Compilar com o Xcode

Perguntar nas Discussions Lista completa de problemas

Os apps de código aberto que este guia usa, para Android e iPhone. Sem conta e sem nuvem. Mais sobre o app para Android e para iPhone.

Perguntas frequentes

O app gasta muita bateria?

Muito pouca. Entre as sincronizações ele não faz nada: nenhum serviço roda e nenhuma conexão fica aberta. Cada sincronização é uma tarefa curta que o Android inicia na sua agenda, uma vez por hora por padrão. Um backfill gasta mais enquanto roda.

Os dados se perdem quando uma sincronização falha?

Raramente. Um payload que não foi entregue fica no celular e sai na próxima sincronização que alcançar o seu servidor, do mais antigo para o mais novo. A aba Logs mostra cada tentativa. Os dados se perdem em dois casos. O celular guarda até 700 payloads, cerca de uma semana de sincronizações a cada 15 minutos; passando disso, o mais antigo sai, com uma linha em Logs e uma notificação. E um payload que o seu servidor recusa com 400, 413 ou 422 é oferecido de novo a cada sincronização durante uma semana e depois descartado, com uma linha em Logs. Enquanto o seu servidor estiver totalmente fora de alcance, nada é descartado pela idade.

Onde eu pergunto se esta página não ajudar?

Nas Discussions do GitHub, ou abra uma issue com a linha da aba Logs. A lista completa de solução de problemas está no guia de configuração.