Журнал ошибок айфон

Перейти к содержимому

Is this article up to date?

Перейти к контенту

Время на прочтение
8 мин

Количество просмотров 57K

Краткая инструкция по чтению и разбору логов мобильных устройств на Android и iOS, а также необходимые инструменты для Windows и MacOS.

Статья подготовлена red_mad_robot и «Альфа-Банком» на основе доклада Senior QA red_mad_robot Ольги Никитиной «Инструменты для снятия логов с Android / iOS устройств. Чтение и разбор» на митапе «QАчественное общение» при поддержке red_mad_robot.

Уровни логирования и что они означают

Для начала разберёмся с логами. Это текстовые файлы, в которых записываются все действия пользователя. Например, какие кнопки он нажимает в приложении и как на это оно реагирует в ответ.

Записи в логах формируются в хронологическом порядке. Самая свежая — внизу.

Есть два вида логов:

• Crash logs — файл, в котором хранятся записи только об ошибках экстренного завершения программы — по-простому, когда приложение крашнулось.

• Logs — простые логи, или журнал событий. Это файл, в котором хранятся системные записи и ответы устройства на действие пользователя.

Логи на мобильных устройствах бывают нескольких уровней:

• ERROR,

• WARN,

• INFO,

• DEBUG,

• VERBOSE.

Они представлены по уровню важности — от самого высокого к самому низкому, — и каждый следующий уровень включает в себя предыдущий. Например, VERBOSE содержит в себе логи всех остальных.

Примечание: уровни более применимы к логам на Android, потому что именно там такое разделение встречается чаще.

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

Error (ERROR)

На этом уровне информируются ошибки работы системы.

Записи этого уровня требуют быстрого вмешательства разработчика — на такие ошибки нужно реагировать максимально быстро.

Как пример, такая запись в логе:

“ SpannableStringBuilder: SPAN_EXCLUSIVE_EXCLUSIVE spans cannot have a zero length ”

Это ошибка, в которой говорится, что строковый элемент span не может быть пустым.

Или вот:

“ [ZeroHung]zrhung_get_config: Get config failed for wp[0x0008] ] ”

Эта системная ошибка сообщает, что происходит утечка памяти при взаимодействии с каким-то элементом или приложением.

Warning (WARN)

На этом уровне отображаются записи, сообщающие о каком-то неожиданном поведении, требующем внимания, или о ситуации, которая незнакома системе.

Например, сообщение ниже — запись из тестового приложения:

“ [OMX.hisi.video.decoder.avc] setting nBufferCountActual to 16 failed: -2147483648 “

Мы пытаемся декодировать запись в какой-то формат, но его нет. Ошибка сообщает о неуспешной попытке настройки видеоплеера в нужном формате.

Ещё пример:

“ BroadcastQueue: Permission Denial: broadcasting Intent ”

Эта системная ошибка говорит о сбое в работе одного из виджетов на устройстве.

Info (INFO)

На этот уровень приходят записи информационного характера, например о работе системы.

Допустим, такое сообщение об уровне заряда батареи на устройстве:

“ APwBatteryMonitor: screen off start battery: 100 ”

А это сообщение говорит о том, что экран устройства был выключен:

“ HwBatteryService: intent = Intent { act=android.intent.action.SCREEN_OFF flg=0x58200010 } ” 

Ещё в логи этого уровня входят запросы от клиента на сервер: хедеры, тело запросов, которые отправляет клиент, и ответы сервера.

“ okhttp.OkHttpClient: <— 200 https://domainname/api/v1/smth/deals (1691ms)

okhttp.OkHttpClient: server: nginx/1.15.9

okhttp.OkHttpClient: date: Thu, 23 Sep 2021 19:41:17 GMT

okhttp.OkHttpClient: content-type: application/json

okhttp.OkHttpClient: vary: Accept-Encoding

okhttp.OkHttpClient: strict-transport-security: max-age=15724800; includeSubDomains

okhttp.OkHttpClient: {«key»:{«key»:value,»name»:»»},»key»:value,»key»:value}

okhttp.OkHttpClient: <— END HTTP ”

Такие записи могут помочь вам в понимании какого-то бага или в разборе задачи при условии, что вы не можете перехватить трафик или не знаете, какие запросы отправляются на бэкенд.

Debug (DEBUG)

Это уровень сообщений, в которых передаётся информация о процессах отладки или шагах работы крупных процессов.

Например, в записи ниже сказано, что пользователь нажимал на кнопку уменьшения или увеличения громкости:

“ MediaSessionService: dispatchVolumeKeyEvent ”

Сначала мы видим запись о самом факте нажатия на кнопку, далее оно расшифровывается подробнее:

{ action=ACTION_DOWN, keyCode=KEYCODE_VOLUME_UP }

Ещё пример: если ваше приложение использует сокет-сессию, то на уровне DEBUG мы можем увидеть, когда сессия начинается и заканчивается:

“ b$b: WebSocket connected ”

Verbose (VERBOSE)

Сообщения такого уровня уточняют или раскрывают действия.

Например, у нас есть служба управления окнами на экране приложения. И на уровне Verbose мы можем увидеть подробности её работы.

Открытие окна:

WindowManager: addWindow

Закрытие окна:

WindowManager: Removing Window

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

GnssLocationProvider: reportLocation Location […] 

А меняя звук на устройстве, мы увидим, как растёт или падает значение:

AudioManager: getStreamVolume  streamType: 3 volume: 10

Каждое нажатие, то есть изменение звука, будет отражаться новым сообщением.

Verbose — уровень самого низкого приоритета. Выбирая такой уровень отображения логов, мы будем видеть записи и со всех предыдущих уровней.

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

Инструменты для снятия логов: Android

Расскажем о трёх способах.

Первый — Logcat в составе Android Studio, самый известный и широко используемый.

Для снятия логов нам необходимо перевести устройство в режим разработчика/отладки. Для этого нужно:

• найти в настройках номер нашего билда или ОС (в зависимости от устройства),

• около десяти раз нажать на эту информацию,

• при появлении сообщения о том, не хотим ли мы перевести устройство в режим разработчика, нажать «Ок».

Примечание: алгоритм может отличаться в зависимости от производителя устройства, потому что у многих из них свои надстройки на ОС Android.

Дальше подключаем устройство по USB к ПК и устанавливаем Android Studio.
Следующие шаги на скрине:

1. Выбираем вкладку Logcat (переходим к сообщениям в реальном времени).

2. В окошке выбираем телефон, с которого снимаем логи.

3. На этой вкладке выбираем логи определённого приложения. Если нужно снять вообще все логи со всех приложений и системы, эту вкладку стоит не трогать. Рядом с ней можно выбрать уровень логирования (вкладка Verbose на скрине).

4. В поле поиска, где мы можем фильтровать выдачу, разрешено писать что угодно — от названия пакета до частей вроде fatal.

На скрине видно логи с подключенного устройства.

Второй способ — выгрузка логов с самого устройства. Кроме режима разработчика нам нужно подключить устройство к ПК через USB и установить ADB — Android Debug Bridge.

Открываем терминал и пишем две команды.

Первая — adb devices — показывает подключённые устройства, которые видит ADB. В терминале выглядит так:

Вводим вторую команду — adb -s название устройства logcat, — которая запускает утилиту Logcat для конкретного устройства. В терминале в реальном времени будут поступать логи.

Как их читать?

1. В первом столбце — дата и время поступления записи.

2. Во втором — обозначения уровней логирования. Например, D — это Debug.

3. В третьем показываются названия инструмента, утилиты, пакета, от которых поступает сообщение, а также расшифровка того, что вообще происходит.

Третий инструмент — SDK Platform Tools. Процесс его установки практически аналогичен предыдущим двум:

• переводим телефон в режим разработчика,

• подключаем к ПК по USB,

• скачиваем на ПК папку SDK PT (под свою ОС),

• открываем папку SDK PT в терминале.

Теперь пишем команду ./adb logcat –v threadtime > ./android-debug.log.

В терминале это выглядит так:

Прерываем выполнение команды (например, на Mac это Control+C). Лог добавляется в папку.

Открываем:

Очень похоже на предыдущий терминал, но файл обновляется, пока в терминале действует команда.

Инструменты снятия логов: iOS

В первую очередь нас интересует xCode — интегрированная среда разработки (IDE), в которую встроен нужный нам инструмент Simulator.

Как использовать инструмент:

1. Устанавливаем xCode.

2. В системной строке нажимаем xCode → Open Developer Tools → Simulator.

3. Устанавливаем приложение.

4. В самом симуляторе выбираем Debug → Open System Log.

Мы будем видеть логи в реальном времени:

Подобное оформление логов мы уже где-то видели, но построение информации в выдаче немного отличается. Есть дата и время (1) и данные (2) о том, с какого устройства снята информация: имя компьютера, элемент системы, с которого пришло сообщение, и его расшифровка.

Но первый способ работает только с симуляторами. Если необходимо снимать логи с реального устройства, в этом может помочь раздел Devices and Simulators.

Записи можно отфильтровать по конкретному процессу (вашему приложению):

1. Устанавливаем xCode.

2. Подключаем устройство к ПК по USB.

3. Открываем xCode → Windows → Devices and Simulators.

Дальше нажимаем у устройства Open Console и видим панель с названием устройства, информацией о модели и ОС:

Логи поступают в реальном времени, но их удобно отслеживать:

У нас есть три столбца:

1. «Время» — время поступления сообщения.

2. «Процесс» — с какой части системы/приложения пришло сообщение.

3. «Сообщение» — описание события, сервисная информация.

В инструменте есть поиск для фильтрации выдачи. Ещё есть полезная кнопка «Приостановить» — она останавливает поток логов.

А вот утилита iMazing поможет снимать iOS-логи для тех, у кого установлен Windows. Приложение платное, но часть функциональности доступна бесплатно. Например, за снятие логов устройства платить не нужно.

В меню выбираем «Показать консоль устройства». В открывшемся окне приходят записи логов в реальном времени со всего устройства.

Ещё одно важное достоинство iMazing — возможность сохранять логи (разумеется, по кнопке «Сохранить»).

---

Статья подготовлена red_mad_robot и «Альфа-Банком» на основе доклада Senior QA red_mad_robot Ольги Никитиной «Инструменты для снятия логов с Android / iOS устройств. Чтение и разбор» на митапе «QАчественное общение» при поддержке red_mad_robot.

1. 03.03.2021, 13:33

   
   

   #1

   iPhone/iPad/panic log/расшифровка/аналитика
   

   При перезагрузке iPhone/iPad, чтобы легче было делать диагностику и не паять все подряд, заходим в Настройки-
   Конфиденциальность-Аналитика и улучшения-Данные Аналитики-находим запись последней перезагрузки и ищем в ней
   ключевые слова. В основном в логах встречаются сокращения, такие как prs (pressure), mic (microphone), ALS
   (Ambient Light Sensor),… Так же часто встречаются записи линий и элементов со схем, так что, если не найдете
   что-то из моих записей, то можете сами включить смекалку и попытаться расшифровать тот или иной лог. Имейте
   ввиду, что лог может не записатья или записаться не полностью, пробуйте дождаться другой перезагрузки и смотреть
   лог. Эти записи я буду постоянно обновлять. iКолхозник (PRO-mobile). Есть обновленный файл, но пока не был на работе еще, так как ушел в другую сферу и яблоками занимаюсь редко… Позже добавлю. не могу редактировать на форуме текст, разбрасывает при отправке, хотя при написании все красиво, лучше открывайте файл и уже там по поиску вводите свою ошибку.

   ==================================================================================

   ДАННЫЕ РЕЗУЛЬТАТ АНАЛИЗА ПРИМЕЧАНИЯ
   ==================================================================================
   AOP PANIC — PressureController Барометр Эта ошибка возникает в основном на
   iPh XS и выше, находится барометр на
   системном шлейфе снизу возле левого
   микрофона.

   ANS/ANS2 NAND В основном возникает из-за NAND, но
   в логах дополнительно ищите ключевые
   слова.
   SD: 0 Missing sensor(s): TG0B АКБ/TIGRIS Девайс не видит АКБ.
   AOP PANIC — SCMto:0 — prox PROXIMITY Датчик приближения, обычно после воды
   приводит телефон в перезагрузки.
   Kernel data abort CPU В основном из-за отвала процессора
   либо катушек по линиям buck. Так же
   в логе иногда встречаются конкретные
   линии и элементы со схем.
   Missing sensor(s): mic1 Microphone Часто бывает после воды или механичес-
   кого воздействия.
   mic1 — нижний левый микрофон.
   mic2 — рядом со вспышкой/фонариком.
   mic3 — рядом с фронтальной камерой.
   mic4 — правый нижний микрофон.
   SD: 1 Missing sensor(s): Prs0 Барометр Барометр поврежден либо его линии.
   AppleSocHot: hot hot hot CPU/КП Встречал только на моделях iPhone 7.
   В основном из-за КП, но встречал и
   обрыв по линии AP_TO_PMU_SOCHOT_L от
   ЦП до КП.
   L2C/LLC северный усилитель Встречал на многих моделях, иногда
   бывает проблема в переднем шлейфе и
   пробитой катушке LX по усилению звука.
   Prev-next/LSU кварцевый генератор часов Встречал только на iPhone 5c.
   NO pulse on Taptic Engine Часто разъем в коррозии.
   nvme NAND Nand с PCIE шиной.
   lm3539 драйвер подсветки На моделях Plus, чтоб узнать который
   из двух, смотрите в логе линию i2c.
   mic-temp-sens2 mic2 Микрофон рядом со вспышкой/фонариком.
   Часто встречается на iPhone 11.
   Kernel instructglon fetch CPU Прекращение работы ядра ЦП.
   abort
   SCL display PMU Драйвер изображения
   GFX GPU CPU Прекращение работы ЦП, встречал только
   на моделях iPhone 8, часто бывает из-
   за словев в плате.
   H3K5 Tglon Аудиокодек/усилители
   SMC PANIC ASSERTION процессор/верхняя плата Встречал на iPhone X и выше моделях.
   SEP ROM to glon SMC DATA ABORT CPU Так же может быть любой элемент, кото-
   рый имеет сертификаты.
   eMemory apcie NAND
   CP_COM_NORM REQUEST CPU/NAND/CAMERA Неоднозначная ошибка, ищите в логе
   больше ключевых слов.
   Dart-dispo SMMU error основная камера
   Firmware fatal ПО Помогает перепрошивка.
   Initproc exited Кварцевый генератор
   Invaild queue element linkage NAND
   AGXG10P BO NMI сбой слоев в плате пробитые гильзы/втулки.
   Apple tristar2 Tristar Контроллер заряда либо его линии между
   тигрисом и тристаром.
   PMP NMI FIQ CPU/катушки/КП Неоднозначная ошибка.
   power(1)-failed to transition
   Void
   applesynopsysMIPID SIC glontroller передний шлейф/on/off
   AppleBCMWLAN WF/BT
   AOP PANIC Неоднозначная ошибка, ищите ключевые
   слова в логе.
   Ememory Nand В основном на iPhone 5s/6.
   Anc-postnand.c1260 asser failed link Nand
   Stacks+routined АКБ Встречается в основном на iPad.
   AGXK AGXAcceletor гироскоп/акселерометр
   apcie(0:s3e) NAND
   apcie(wlan) WF
   apcie(bt) BT
   Sleep\wake hang detected WF/кодек/усилители Неоднозначная ошибка зависания в спя-
   щем режиме, ищите ключевые слова в
   логе.
   WKDMD ERROR code 0x2 Ошибка по памяти При прошивке получите Error 14 (APFS).
   Apple PPM Лайтнинг/Тристар/Тигрис Ошибка возникает при зарядке.
   Fatal coherency point error CP_com_NORM CPU/катушки/КП
   gnss glonass/GPS

   ---

2. 69 участника(ов) поблагодарили PRO-mobile за его сообщение:

   -=sam=- (02.03.2023),

   alexece (04.03.2023),

   AlsPro (09.03.2021),

   anapka (14.06.2022),

   Andre20 (28.12.2022),

   asap82 (01.07.2021),

   bebiloku (20.03.2021),

   brukain (12.03.2021),

   Butum (04.03.2021),

   Celica485 (28.04.2023),

   Celler (09.03.2021),

   Daemon pisec (21.06.2023),

   DB2020_Logs (03.03.2021),

   dekuort (03.04.2021),

   DeltaService (14.02.2023),

   DRALOSKOP (03.03.2021),

   Dushman (03.03.2021),

   Estonij (04.03.2021),

   fattality (26.07.2023),

   foretell (03.03.2021),

   geleos27 (21.05.2021),

   glasius (27.04.2021),

   gsmtest (26.04.2023),

   HANK (03.03.2021),

   iGoogle (19.07.2021),

   ivanych79 (03.03.2021),

   jake-format1 (02.02.2023),

   Jestful (19.06.2021),

   Konstantin585 (15.05.2021),

   ksenon (23.12.2022),

   lefty_m (03.03.2021),

   maros (28.02.2022),

   maxim’ka (03.03.2021),

   mblack (18.02.2022),

   NDA87 (04.03.2021),

   Negoziand (07.07.2021),

   Nick 725 (28.02.2023),

   njno (04.03.2021),

   nldex (22.03.2021),

   NokSim (04.03.2021),

   O_stebelyak (01.11.2021),

   partizan_nsk (12.04.2023),

   Pelevin (03.03.2021),

   point21 (12.01.2023),

   PPetr (28.07.2021),

   qamarbek (06.07.2022),

   RETU (27.03.2021),

   Reutskiy (09.06.2021),

   rgcensor (11.05.2021),

   runerddd (02.06.2021),

   schemu (09.03.2021),

   serv (23.03.2021),

   shsp82 (12.03.2021),

   ShuhService (11.03.2021),

   Somik15 (30.08.2021),

   stevennson (01.07.2023),

   uprugiy (24.02.2022),

   Vl@diimir (03.03.2021),

   wert1512 (09.03.2021),

   Witcher87g (26.12.2022),

   XMD (31.03.2021),

   Y3sW0r1d (12.03.2021),

   Yankee (05.03.2021),

   Yuriy Dzyabko (24.12.2022),

   Zur65 (20.11.2021),

   Zuza (18.05.2021),

   [C2H5OH] (20.05.2021),

   Садовод_яблок (15.03.2021),

   Серега (06.03.2021)

   ---