Guia de registos de eventos da app

Os registos de eventos da app ajudam a resolver problemas quando uma automatização ou exportação não se comporta como esperado. Pode exportar registos a partir da app e partilhá-los com o suporte para investigação.

Registos de atividade vs registos de eventos da app

Os registos de atividade são o histórico de execução visível ao utilizador de uma única automatização. Abra-os no ecrã de configuração da automatização (Ver registos de atividade). Mostram execuções agrupadas por hora, com eventos informativos, de aviso e de erro apenas para essa automatização. Revê-os na app; são armazenados por automatização.

Os registos de eventos da app são registos de diagnóstico técnicos de toda a app (automatizações, exportação manual, consultas HealthKit, carregamentos e fluxos relacionados). São armazenados como JSONL e exportados como ZIP para o suporte. Exportar registos de eventos da app não substitui a leitura dos registos de atividade na app — use ambos ao reportar um problema.

O que os registos de eventos da app incluem

Os registos de eventos da app incluem eventos de diagnóstico gerados por fluxos da app, como:

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

O ZIP exportado destina-se à resoluçã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 da app e do ambiente
• Uma instantânea redigida de automatizações (configuração sem credenciais nem segredos)
• Campos IAP de instalação original e grandfathering para diagnóstico de compras

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

Onde exportar

Existem três formas de exportar registos de diagnóstico. Escolha consoante o nível de detalhe necessário.

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

O pacote completo inclui events.jsonl de toda a app (e um segmento rodado, se existir), manifest.json e automations.json redigido.

Exporte a partir de:

1. Definições → Avançadas → Exportar registos de eventos
2. Automatização → Ver registos de atividade → partilhar (barra de ferramentas) — exporta o mesmo ZIP completo que Avançadas, não um ficheiro apenas de uma automatização

Partilhe o ZIP por Mail, AirDrop ou outro destino de partilha.

Apenas registos do domínio de automatização

Definições de automatização → Exportar registos de automatização exporta apenas linhas relacionadas com automatização do registo de eventos da app (filtradas por subsystem). Use isto quando quiser um pacote mais pequeno focado em automatização. Na maioria dos casos de suporte, use o ZIP de diagnóstico completo a partir de Avançadas ou da partilha nos registos de atividade.

Quando exportar registos de eventos da app

Exporte registos quando conseguir reproduzir um problema, por exemplo:

• Automatizações que não executam de forma fiável
• Falhas repetidas ao carregar para destinos na nuvem
• Falhas inesperadas nas exportações
• Comportamento de ligação ao servidor que não consegue explicar
• Execuções lentas de automatização (verifique também os registos de atividade por avisos de consultas lentas)

Como exportar registos de eventos da app (passo a passo)

ZIP de diagnóstico completo:

1. Abra o Health Auto Export.
2. Vá a Definições → Avançadas → Exportar registos de eventos, ou abra uma automatização → Ver registos de atividade → toque em partilhar na barra de ferramentas.
3. Partilhe o ZIP gerado por Mail, AirDrop ou outro destino de partilha.

Apenas domínio de automatização:

1. Abra Definições de automatização (a partir da área de automatizações).
2. Toque em Exportar registos de automatização.
3. Partilhe o ZIP gerado.

Antes de partilhar registos

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

• O que esperava que acontecesse
• O que aconteceu em vez disso
• Hora aproximada em que o problema ocorreu
• Tipo de automatização ou exportação envolvido
• Versão do iOS e modelo do dispositivo
• Capturas de ecrã dos registos de atividade da automatização afetada, quando relevante

Este contexto ajuda o suporte a correlacionar o seu relatório com os eventos exportados.

Guias relacionados

• Guia de resolução de problemas
• Guia de exportação manual
• Visão geral das automatizações