Руководство по журналам событий приложения

Журналы событий приложения помогают устранять неполадки, когда автоматизация или экспорт работают не так, как ожидалось. Вы можете экспортировать журналы из приложения и отправить их в службу поддержки для анализа.

Журналы активности и журналы событий приложения

Журналы активности — это пользовательская история запусков одной автоматизации. Откройте их с экрана настройки автоматизации (Просмотреть журналы активности). В них запуски сгруппированы по времени с информационными, предупреждающими и ошибочными событиями только для этой автоматизации. Вы просматриваете их в приложении; они хранятся отдельно для каждой автоматизации.

Журналы событий приложения — технические диагностические журналы для всего приложения (автоматизации, ручной экспорт, запросы HealthKit, загрузки и связанные процессы). Они хранятся в формате JSONL и экспортируются в ZIP для поддержки. Экспорт журналов событий не заменяет просмотр журналов активности в приложении — при сообщении о проблеме используйте оба варианта.

Что включают журналы событий приложения

Журналы событий включают диагностические события из процессов приложения, например:

• Запуски автоматизаций
• Ручные экспорты
• Активность сервера
• Ошибки обработки и проверки экспортов
• Диагностика запросов HealthKit и загрузок

Экспортированный ZIP предназначен для устранения неполадок. В нём могут быть метки времени, имена событий и диагностический контекст без данных о здоровье. Пакет также может включать:

• Манифест с метаданными приложения и среды
• Редактированный снимок автоматизаций (конфигурация без учётных данных и секретов)
• Поля IAP для исходной установки и grandfathering в диагностике поддержки покупок

Экспортированные журналы не содержат необработанные образцы HealthKit и значения ваших данных о здоровье.

Где экспортировать

Есть три способа экспорта диагностических журналов. Выберите в зависимости от нужной детализации.

Полный диагностический ZIP (рекомендуется для чата с поддержкой)

Полный пакет включает events.jsonl для всего приложения (и ротированный фрагмент, если есть), manifest.json и редактированный automations.json.

Экспорт из:

1. Настройки → Дополнительно → Экспортировать журналы событий
2. Автоматизация → Просмотреть журналы активности → поделиться (панель инструментов) — экспортирует тот же полный ZIP, что и в Дополнительно, а не файл только для одной автоматизации

Поделитесь ZIP через Почту, AirDrop или другое средство обмена.

Только домен автоматизаций

Настройки автоматизации → Экспортировать журналы автоматизации экспортирует только строки, связанные с автоматизациями, из журнала событий (с фильтром по подсистеме). Используйте это, когда нужен меньший пакет, сфокусированный на автоматизациях. В большинстве обращений в поддержку лучше использовать полный диагностический ZIP из Дополнительно или из общего доступа в журналах активности.

Когда экспортировать журналы событий

Экспортируйте журналы, когда можете воспроизвести проблему, например:

• Автоматизации работают ненадёжно
• Повторяющиеся сбои загрузки в облачные сервисы
• Неожиданные сбои экспорта
• Необъяснимое поведение подключения к серверу
• Медленные запуски автоматизаций (также проверьте журналы активности на предупреждения о медленных запросах)

Как экспортировать журналы событий (пошагово)

Полный диагностический ZIP:

1. Откройте Health Auto Export.
2. Перейдите в Настройки → Дополнительно → Экспортировать журналы событий или откройте автоматизацию → Просмотреть журналы активности → нажмите поделиться на панели инструментов.
3. Поделитесь созданным ZIP через Почту, AirDrop или другое средство обмена.

Только домен автоматизаций:

1. Откройте Настройки автоматизации (из раздела автоматизаций).
2. Нажмите Экспортировать журналы автоматизации.
3. Поделитесь созданным ZIP.

Перед отправкой журналов

Укажите вместе с экспортом:

• Что вы ожидали
• Что произошло вместо этого
• Примерное время возникновения проблемы
• Тип автоматизации или экспорта
• Версию iOS и модель устройства
• Снимки экрана журналов активности для затронутой автоматизации, если это уместно

Этот контекст помогает поддержке сопоставить ваше сообщение с экспортированными событиями.

Связанные руководства

• Руководство по устранению неполадок
• Руководство по ручному экспорту
• Обзор автоматизаций