Обзор журналирования

AIBudsLogSDK предоставляет общую для процесса точку входа журналирования, которой пользуются модули AIBuds SDK и приложения. Активный LogService записывает сообщения, экспортирует сохранённые журналы и удаляет устаревшие записи.

Возможности

📄️Способы вывода

Настройка уровня журналирования AIBuds и места вывода

📄️Экспорт журналов

Экспорт сохранённых журналов AIBuds в один файл или файлы ограниченного размера

📄️Удаление устаревших журналов

Удаление сохранённых журналов по сроку хранения или граничной дате

Реализация с помощью AI

Разработка с AI

Реализуйте этот сценарий с AI

Используйте официальный навык «Управление журналами AIBuds» и адаптируйте сценарий к приложению.

Прочитайте и выполните инструкции https://docs-aibuds.github.io/ru/skills/manage-aibuds-logs. Используйте этот навык, чтобы реализовать «Управление журналами AIBuds» в данном iOS-проекте и проверить результат.

Открыть официальный навык↗

Модель журналирования

LogConfiguration управляет следующими параметрами:

Параметр	По умолчанию	Назначение
level	.info	Минимальная важность сообщений, записываемых стандартным журналом.
destination	.xlfacility	Активное место вывода.
logsDirectory	.aibuds/logs	Каталог файлов относительно Documents.
maxFileSize	10 000 000 байт	Максимальный размер одного файла журнала.
logFileMaxAge	3 дня	Срок хранения, используемый при очистке журналов.

LogDestination поддерживает .console, .oslogger, .file и .xlfacility. Одновременно активно только одно место вывода.

Порядок интеграции

1. Настройте уровень, место вывода, хранилище и срок хранения на раннем этапе запуска приложения.
2. Если используется .xlfacility, установите плагин AIBudsXLFacility до записи журналов.
3. Записывайте сообщения через AIBudsLogSDK.logService либо предоставьте этот сервис модулям AIBuds.
4. Экспортируйте или очищайте журналы через активный LogService.

Важные особенности

• Вывод в консоль и OS Logger не поддерживает экспорт.
• Файловый вывод и XLFacility поддерживают экспорт и очистку по сроку хранения.
• Если собственный сервис не установлен, AIBudsLogSDK.logService возвращает встроенный DefaultLogger.
• Если выбрать .xlfacility, не настроив плагин, ошибка выводится в консоль, а сохранение и экспорт через XLFacility недоступны.