Guia de registros de eventos do app

Os registros de eventos do app ajudam a solucionar problemas quando uma automação ou exportação não se comporta como esperado. Você pode exportar registros no app e compartilhá-los com o suporte para investigação.

Registros de atividade vs registros de eventos do app

Os registros de atividade são o histórico de execução visível ao usuário de uma única automação. Abra-os na tela de configuração da automação (Ver registros de atividade). Eles mostram execuções agrupadas por hora, com eventos informativos, de aviso e de erro apenas para aquela automação. Você os revisa no app; são armazenados por automação.

Os registros de eventos do app são registros de diagnóstico técnicos de todo o app (automações, exportação manual, consultas ao HealthKit, envios e fluxos relacionados). São armazenados como JSONL e exportados como ZIP para o suporte. Exportar registros de eventos do app não substitui a leitura dos registros de atividade no app — use ambos ao relatar um problema.

O que os registros de eventos do app incluem

Os registros de eventos do app incluem eventos de diagnóstico gerados por fluxos do app, como:

• Execuções de automações
• Exportações manuais
• Atividade do servidor
• Erros de processamento e validação de exportações
• Diagnósticos de consultas e envios ao HealthKit

O ZIP exportado é voltado à solução de problemas. Pode incluir carimbos de data/hora, nomes de eventos e contexto de diagnóstico sem dados de saúde. O pacote também pode incluir:

• Um manifest com metadados do app e do ambiente
• Um instantâneo redigido de automações (configuração sem credenciais ou segredos)
• Campos IAP de instalação original e grandfathering para diagnóstico de compras

Os registros exportados não incluem amostras brutas do HealthKit nem os valores dos seus dados de saúde.

Onde exportar

Há três formas de exportar registros de diagnóstico. Escolha conforme o nível de detalhe necessário.

ZIP de diagnóstico completo (recomendado para suporte por chat)

O pacote completo inclui events.jsonl de todo o app (e um segmento rotacionado, se houver), manifest.json e automations.json redigido.

Exporte por:

1. Ajustes → Avançado → Exportar registros de eventos
2. Automação → Ver registros de atividade → compartilhar (barra de ferramentas) — exporta o mesmo ZIP completo de Avançado, não um arquivo só da automação

Compartilhe o ZIP pelo Mail, AirDrop ou outro destino de compartilhamento.

Somente registros do domínio de automação

Ajustes de automação → Exportar registros de automação exporta apenas linhas relacionadas à automação do registro de eventos do app (filtradas por subsystem). Use isso quando quiser um pacote menor focado em automação. Na maioria dos casos de suporte, use o ZIP de diagnóstico completo em Avançado ou o compartilhamento nos registros de atividade.

Quando exportar registros de eventos do app

Exporte registros quando conseguir reproduzir um problema, por exemplo:

• Automações que não executam de forma confiável
• Falhas repetidas ao enviar para destinos na nuvem
• Falhas inesperadas nas exportações
• Comportamento de conexão com o servidor que você não consegue explicar
• Execuções lentas de automação (verifique também os registros de atividade por avisos de consultas lentas)

Como exportar registros de eventos do app (passo a passo)

ZIP de diagnóstico completo:

1. Abra o Health Auto Export.
2. Vá em Ajustes → Avançado → Exportar registros de eventos, ou abra uma automação → Ver registros de atividade → toque em compartilhar na barra de ferramentas.
3. Compartilhe o ZIP gerado pelo Mail, AirDrop ou outro destino de compartilhamento.

Somente domínio de automação:

1. Abra Ajustes de automação (na área de automações).
2. Toque em Exportar registros de automação.
3. Compartilhe o ZIP gerado.

Antes de compartilhar registros

Inclua o seguinte com a exportação dos registros:

• O que você esperava que acontecesse
• O que aconteceu em vez disso
• Horário aproximado em que o problema ocorreu
• Tipo de automação ou exportação envolvido
• Versão do iOS e modelo do dispositivo
• Capturas de tela dos registros de atividade da automação afetada, quando relevante

Esse contexto ajuda o suporte a correlacionar seu relato com os eventos exportados.

Guias relacionados

• Guia de solução de problemas
• Guia de exportação manual
• Visão geral das automações