web: 'web-api.apptracer.ru' // основной хост sdk: 'sdk-api.apptracer.ru' // для отправки событий plugin: 'plugin-api.apptracer.ru' // для загрузки символов
Уровень логирования (серьезности) ошибки, используется для классификации ошибок.
| Уровень | Описание |
|---|---|
NONE | Уровень не указан – к ошибке будет применён один из стандартных типов (CRASH, NON_FATAL и т.п.) |
CRASH | Стандартный тип ошибки. Критическая ошибка, которая привела к сбою приложения или системе. Учитывается при расчёте crash-free. |
FATAL | Критическая ошибка, которая привела к остановке работы приложения. Учитывается при расчёте crash-free. |
ALERT | Предупреждение о потенциальной проблеме, которая требует вмешательства. |
CRITICAL | Критическая ошибка, которая может привести к серьезным проблемам, но не обязательно к остановке приложения. |
ERROR | Ошибка, которая привела к неправильной работе приложения, но не остановила его работу. |
WARNING | Предупреждение о потенциальных проблемах или отклонениях от нормальной работы приложения. |
NOTICE | События, которые требуют внимания, но не обязательно указывают на проблему. |
INFO | Общая информация о работе системы. |
DEBUG | Отладочная информация. |
NON_FATAL | Стандартный тип ошибки. |
| Параметр | Тип | Описание |
|---|---|---|
type | CrashFilterType | Тип фильтра. |
values | List<CrashFilterValue> | Список значений для фильтра. |
CrashFilterCompositeValue implements CrashFilterValue:
| Параметр | Тип |
|---|---|
value | String |
filters | List<CrashQueryFilter> |
CrashFilterStringValue implements CrashFilterValue:
| Параметр | Тип |
|---|---|
value | String |
COMPARE: «Сравнение»COMPONENT: «Компонент»CRASH_VARIANT_ID: «ID варианта события»DEVICE: «Устройство»EXCLUSION: «Параметры для исключения»EXCLUSION_KEYS: «Ключи для исключения»EXCLUSION_KEYS_VAL: «Ключи для исключения (значение)»EXCLUSION_STRINGS: «Строки для исключения»FRESH: «Новые события»FRESH_VERSION_NAME: «Версия, в которой впервые появились сбои»FRESH_VERSION_CODE: «Код/номер версии, в которой впервые появились сбои»HOST_PACKAGE_NAME: «Имя пакета хочт-приложения» (для библиотек)IN_BACKGROUND: «В фоне»ISSUE_KEY: «IssueKey»KEY_KEY: «Ключи»KEY_VAL: «Ключи (значение)»LOG_LEVEL: «LogLevel ошибки» (будет заменён на Severity)MODULE: «Модуль» (deprecated, используйте COMPONENT)OS_VERSION: «OS»PROP_KEY: «Данные»PROP_VAL: «Данные (значение)»RAW: «Пользовательский»SDK_VERSION: «SDK»STATUS: «Статус»USER_ID «ID пользователя»VENDOR: «Устройства»VERSION_NAME: «Название версии»VERSION_CODE: «Код/номер версии»LAST_FIVE_MINUTES – последние 5 минут.LAST_FIFTEEN_MINUTES – последние 15 минут.LAST_THIRTY_MINUTES – последние 30 минут.LAST_HOUR – последний час.LAST_THREE_HOURS – последние 3 часа.LAST_SIX_HOURS – последние 6 часов.LAST_TWELVE_HOURS – последние 12 часов.LAST_24H – последние 24 часа.DAY – текущий день.TWO_DAYS – последние 2 дня.WEEK – последние 7 дней.MONTH – последние 30 дней.SIXTY_DAYS – последние 60 дней.NINETY_DAYS – последние 90 дней.RANGE – кастомный период.Включает данные о группе ошибки – эти данные отображаются в таблице отчётов на странице Сбои.
| Параметр | Тип | Описание |
|---|---|---|
alert | Boolean | Наличие уведомления о всплеске или регрессе. |
commentDataBean | [CommentDataBean] | Комментарии, оставленные для этой группы событий. |
component | String | Компонент приложения, в котором произошел сбой. |
count | Long | Количество событий. |
crashId | String | id группы событий. |
customDisplayType | String | Тип дисплея устройства |
id | String | id конкретного события. |
leftCount | Long | Количество значений в группе А при наличии сравнения. |
message | String | Сообщение к событию. |
rightCount | Long | Количество значений в группе B при наличии сравнения. |
stacktrace | String | Стектрейс события. |
stacktraceBean | [StacktraceBean] | Форматированный стектрейс события. |
subtitle | String | Подзаголовок события. Отображается в таблице событий. |
title | String | Заголовок события. Отображается в таблице событий. |
type | String | Тип события. |
users | Long | Количество устройств, на которых зафиксировано событие. |
versions | String | Диапазон версий, на которых было зафиксировано событие. |
Включает данные об интересующей ошибке – эти данные отображаются во вкладке крэша.
| Параметр | Тип | Описание |
|---|---|---|
alert | Boolean | Наличие уведомления о всплеске или регрессе. |
background | boolean | Указывает, находится ли приложение в фоновом режиме. |
buildUuid | String | UUID сборки приложения. |
count | Long | Количество событий. |
component | String | Компонент приложения, в котором произошел сбой. |
commentDataBean | [CommentDataBean] | Комментарии, оставленные для этой группы событий. |
crashId | String | id группы событий. |
customData | Map<String, String> | Кастомные ключ-значение свойства. |
customDisplayType | String | Тип дисплея устройства |
deviceId | String | Идентификатор устройства. Максимальная длина – 256 символов. |
device | String | Название устройства. Максимальная длина – 256 символов. |
firstTimestamp | Long | Первая точка времени, в которую было обнаружено событие |
id | String | id конкретного события. |
inBackground | boolean | Указывает, находится ли приложение в фоновом режиме. |
isRooted | boolean | Указывает, имеет ли пользователь root-права на устройстве. |
keys | List<String> | Кастомные метки в формате "ключ=значение". |
osVersion | String | Версия операционной системы устройства. Максимальная длина – 256 символов. |
section | String | Раздел приложения, в котором произошел сбой. |
subtitle | String | Подзаголовок события. Отображается в таблице событий. |
stacktrace | String | Стектрейс события. |
stacktraceBean | [StacktraceBean] | Форматированный стектрейс события. |
status | String | Статус группы событий.FIXED – исправлен.REGRESSED – регресс на новой версии.MUTED – отключены уведомления.NO_STATUS – обычное событие. |
statusVkId | Long | VkId пользователя, установившего статус. |
title | String | Заголовок события. Отображается в таблице событий. |
type | String | Тип события. |
users | Long | Количество устройств, на которых зафиксировано событие. |
versionCode | Long | Версия кода приложения. |
versionName | String | Версия приложения. Максимальная длина – 256 символов. |
vendor | String | Производитель устройства. Максимальная длина – 256 символов. |
versions | String | Диапазон версий, на которых было зафиксировано событие. |
Используется для загрузки событий в сервис. Включает информацию о состоянии приложения в момент сбоя.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
buildUuid | String | Нет | UUID сборки приложения. |
component | String | Нет | Компонент приложения, в котором произошел сбой. |
count | Long | Да | Количество событий. |
deviceId | String | Да | Идентификатор устройства. Максимальная длина – 256 символов. |
dropFirstSymbols | Integer | Нет | Параметр для обрезки первых символов (если требуется). |
environment | String | Нет | Окружение приложения, в котором произошел сбой. |
hostedLibrariesInfo | List<LibraryBean> | Нет | Информация о библиотеках, встроенных в приложение. |
id | String | Да | id конкретного события. |
inBackground | boolean | Нет | Указывает, находится ли приложение в фоновом режиме. |
isRooted | boolean | Нет | Указывает, имеет ли пользователь root-права на устройстве. |
libraryInfo | LibraryBean | Нет | Информация о библиотеке из самого приложения. |
module | String | Нет | Модуль, максимальная длина – 256 символов. |
osVersion | String | Нет | Версия операционной системы устройства. Максимальная длина – 256 символов. |
packageName | String | Нет | Имя пакета приложения. |
properties | Map<String, String> | Нет | Кастомные ключ-значение свойства. |
tags | List<String> | Нет | Кастомные метки в формате "ключ=значение". |
versionCode | Long | Да | Версия кода приложения. |
versionName | String | Да | Версия приложения. Максимальная длина – 256 символов. |
vendor | String | Нет | Производитель устройства. Максимальная длина – 256 символов. |
Используется для загрузки событий в сервис. Включает информацию о библиотеках.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
buildUuid | String | Нет | UUID сборки приложения. |
packageName | String | Нет | Имя пакета приложения. |
versionName | String | Да | Версия приложения. Максимальная длина – 256 символов. |
Метод возвращает данные конкретного события внутри группы крэшей.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
compareFilter | [groupA: String,groupB: String] | Нет | Пара текстовых значений, по которым происходит сравнение событий. Значения соответствуют значениям ключей (задаются через SDK платформы). |
count | int | Нет | Количество событий, которое будет выведено на экран. По умолчанию 30, максимум – 100. |
crashId | String | Да | id группы событий (указывается в пути запроса) |
exclusions | List<String> | Да | id событий, которые следуюет исключить из запроса |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих выбранные фильтры (Filter Type). |
forward | boolean | Нет | Определяет порядок выборки событий. По умолчанию true. |
id | String | Да | id конкретного события |
marker | String | Нет | Строковое значение, указывающее на то, с какого элемента следует подгружать дополнительные события. |
modules | [String] | Нет | Список названий модулей (задаются при помощи SDK для платформы). |
sort | [name: String,asc: boolean] | Нет | Тип сортировки событий в формате «имя параметра сортировки – порядок сортировки». По умолчанию сортировка производится по количеству устройств в порядке возрастания. |
text | String | Нет | Текстовая строка, по которой будут отфильтрованы события. Имеет ограничение в 256 символов. Равносильно фильтру с типом RAW в списке filters. |
type | String | Нет | Тип событий. Может быть CRASH, ANR, NON_FATAL, NATIVE, MEMORY_LEAK, METRIC_KIT. По умолчанию null. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на отчёт, с которого началась выгрузка. |
count | int | Количество полученных отчётов. |
hasMore | boolean | Указывает на наличие еще незагруженных отчётов. |
items | [CrashBean] | Список отчётов о крэшах. |
marker | String | Строковое значение, указывающее на последний загруженный отчёт. |
markerNotFound | Boolean | Указание на то, был ли найден предыдущий маркер. |
totalCount | Long | Общее количество отчётов в указанный период. |
Метод возвращает данные, которые отображаются на графике Аудитория – информацию о количестве активных устройств и проценте пользователей, для которых не было зафиксировано крэшей, в каждый момент времени.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
date | Date | Да | Начало временного промежутка, за который нужно отбразить данные, в формате "DD.MM.YYYY HH:MM:SS". По-умолчанию имеет значение null и используется в качестве параметра dateTo. Если в period указан RANGE, используется в качестве dateFrom. |
dateTo | Date | Да | Конец временного промежутка, за который нужно отбразить данные, в формате "DD.MM.YYYY HH:MM:SS". По-умолчанию имеет значение null. |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих выбранные фильтры (см. Filter Type) |
frequency | Integer | Нет | Частота, с которой формируется выборка данных. Чем выше значение параметра, тем более полный набор данных будет получен. |
period | String | Да | Задает временной промежуток стандартного формата (Period). |
timeSeriesSeconds | Integer | Нет | Частота полученных измерений в секундах |
versionCodes | [Long] | Нет | Список versionCode, для которых нужно получить данные. Этот параметр задается при установке фильтра Версии. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на отчёт, с которого началась выгрузка. |
count | int | Количество полученных значений. Соответсвует количеству точек на графике Аудитория. |
hasMore | boolean | Указывает на наличие еще незагруженных отчётов. |
items | [timestamp: long,percent: BigDecimal,total: Long] | Список «crashFree и количество устройств» в каждый момент времени. |
marker | String | Строковое значение, указывающее на последний загруженный отчёт. |
markerNotFound | Boolean | Указание на то, был ли найден предыдущий маркер. |
overallPercent | BigDecimal | Общее значение crashFree. |
overallTotal | Long | Общее количество активных устройств. |
totalCount | Long | Общее количество отчётов в указанный период. |
Метод возвращает данные, которые отображаются на графике Тренды – информацию о количестве зафиксированных событий в каждый момент времени.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
crashId | String | Нет | id группы событий – вернутся данные только для неё. |
date | Date | Да | Начало временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null и используется в качестве параметра dateTo. Если в period указан RANGE, используется в качестве dateFrom. |
dateTo | Date | Да | Конец временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null. |
exclusions | List<String> | Нет | Список исключения |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих выбранные фильтры (Filter Type). |
frequency | Integer | Нет | Частота, с которой формируется выборка данных. Чем выше значение параметра, тем более полный набор данных будет получен. |
period | String | Да | Задает временной промежуток стандартного формата (Period). |
text | String | Нет | Текстовая строка, по которой будут отфильтрованы события. Имеет ограничение в 256 символов. Равносильно фильтру с типом RAW в списке filters. |
timeSeriesSeconds | Integer | Нет | Частота полученных измерений в секундах |
type | String | Нет | Тип событий. Может быть CRASH, ANR, NON_FATAL, NATIVE, MEMORY_LEAK, METRIC_KIT. По умолчанию null. |
types | [String] | Нет | Список типов событий. По умолчанию null. |
modules | [String] | Нет | Список названий модулей (задаются при помощи SDK для платформы). |
versionCode | Long | Нет | versionCode – задается при установке фильтра Версии. |
versionCodes | [Long] | Нет | Список versionCode, для которых нужно получить данные. Этот параметр задается при установке фильтра Версии. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на отчёт, с которого началась выгрузка. |
count | int | Количество полученных значений. Со ответствует количеству точек на графике Тренды. |
count | int | Количество полученных отчётов. |
hasMore | boolean | Указывает на наличие еще незагруженных отчётов. |
items | [timestamp: long,count: long] | Список значений количества событий в каждый момент времени. |
marker | String | Строковое значение, указывающее на последний загруженный отчёт. |
totalCount | Long | Общее количество активных устройств. |
totalCount | Long | Общее количество отчётов в указанный период. |
users | Long | Общее количество активных устройств. |
Возвращает список аггрегированных отчётов о событиях за указанный период.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
date | Date | Да | Начало временн ого промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null и используется в качестве параметра dateTo. Если в period указан RANGE, используется в качестве dateFrom. |
dateTo | Date | Да | Конец временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null. |
forward | boolean | Нет | Определяет порядок выборки событий. По умолчанию true. |
marker | String | Нет | Строковое значение, указывающее на то, с какого элемента следует подгружать дополнительные события. |
modules | [String] | Нет | Список названий модулей (задаются при помощи SDK для платформы). |
period | String | Да | Задает временной промежуток стандартного формата (Period). |
sort | [name: String,asc: boolean] | Нет | Тип сортировки событий в формате «имя параметра сортировки – порядок сортировки». По умолчанию сортировка производится по количес тву устройств в порядке возрастания. |
text | String | Нет | Текстовая строка, по которой будут отфильтрованы события. Имеет ограничение в 256 символов. Равносильно фильтру с типом RAW в списке filters. |
type | String | Нет | Тип событий. Может быть CRASH, ANR, NON_FATAL, NATIVE, MEMORY_LEAK, METRIC_KIT. По умолчанию null. |
types | [String] | Нет | Список типов событий. По умолчанию null. |
versionCode | Long | Нет | versionCode – задается при установке фильтра Версии. |
versionCodes | [Long] | Нет | Список versionCode, для которых нужно получить данные. Этот параметр задается при установке фильтра Версии. |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих выбранные фильтры (Filter Type). |
compareFilter | [groupA: String,groupB: String] | Нет | Пара текстовых значений, по которым происходит сравнение событий. Значения соответствуют значениям ключей (задаются через SDK платформы). |
count | int | Нет | Количество событий, которое будет выведено на экран. По умолчанию 30, максимум – 100. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на отчёт, с которого началась выгрузка. |
count | int | Количество полученных отчётов. |
hasMore | boolean | Указывает на наличие еще незагруженных отчётов. |
items | [AggCrashBean] | Список агрегированных отчётов. |
marker | String | Строковое значение, указывающее на последний загруженный отчёт. |
totalCount | Long | Общее количество отчётов в указанный период. |
Возвращает список аггрегированных отчётов о событиях c указанием его вариантов за указанный период.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
date | Date | Да | Начало временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null и используется в качестве параметра dateTo. Если в period указан RANGE, используется в качестве dateFrom. |
dateTo | Date | Да | Конец временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null. |
forward | boolean | Нет | Определяет порядок выборки событий. По умолчанию true. |
marker | String | Нет | Строковое значение, указывающее на то, с какого элемента следует подгружать дополнительные события. |
modules | [String] | Нет | Список названий модулей (задаются при помощи SDK для платформы). |
period | String | Да | Задает временной промежуток ста ндартного формата (Period). |
sort | [name: String,asc: boolean] | Нет | Тип сортировки событий в формате «имя параметра сортировки – порядок сортировки». По умолчанию сортировка производится по количеству устройств в порядке возрастания. |
text | String | Нет | Текстовая строка, по которой будут отфильтрованы события. Имеет ограничение в 256 символов. Равносильно фильтру с типом RAW в списке filters. |
type | String | Нет | Тип событий. Может быть CRASH, ANR, NON_FATAL, NATIVE, MEMORY_LEAK, METRIC_KIT. По умолчанию null. |
types | [String] | Нет | Список типов событий. По умолчанию null. |
versionCode | Long | Нет | versionCode – задается при установке фильтра Версии. |
versionCodes | [Long] | Нет | Список versionCode, для которых нужно получить данные. Этот параметр задается при установке фильтра Версии. |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих выбранные фильтры (Filter Type). |
compareFilter | [groupA: String,groupB: String] | Нет | Пара текстовых значений, по которым происходит сравнение событий. Значения соответствуют значениям ключей (задаются через SDK платформы). |
count | int | Нет | Количество событий, которое будет выведено на экран. По умолчанию 30, максимум – 100. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на отчёт, с которого началась выгрузка. |
count | int | Количество полученных отчётов. |
hasMore | boolean | Указывает на наличие еще незагруженных отчётов. |
items | [AggCrashBean] | Список агрегированных отчётов. |
marker | String | Строковое значение, указывающее на последний загруженный отчёт. |
totalCount | Long | Общее количество отчётов в указанный период. |
Возвращает список значений для выбранного фильтра.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
count | Integer | Нет | Количество значений, которое будет выведено на экран. |
crashId | String | Нет | id группы событий |
date | Date | Да | Начало временного промежутка, за который нужно отобразить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null и используется в качестве параметра dateTo. Если в period указан RANGE, используется в качестве dateFrom. |
dateTo | Date | Да | Конец временного промежутка, за который нужно отобра зить данные, в формате "DD.MM.YYYY HH:MM:SS". По умолчанию имеет значение null. |
findValue | String | Нет | Строка для поиска по значениям фильтра. |
filters | [type: String,custom: boolean,values: [{...}]] | Нет | Список сущностей, описывающих уже выбранные фильтры (Filter Type). |
filterType | String | Да | Фильтр, для которого необходимо получить значения. Подробнее в (Filter Type). |
forward | boolean | Нет | Определяет порядок выборки событий. По умолчанию true. |
marker | String | Нет | Строковое значение, указывающее на то, с какого элемента следует подгружать дополнительные события. |
parentFilters | [CrashQueryFilter] | Нет | Все «родительские» фильтры, которые есть для текущего фильтра. Количество зависит от уровня вложенности. |
parentFilterType | String | Нет | Тип «родительского» фильтра, если фильтр имеет подзначения (например, KEY_KEY - KEY_VAL). Подробнее в (Filter Type) |
parentFilterValue | String | Нет | Значение «родительского» фильтра, если фильтр имеет подзначения (например, KEY_KEY - KEY_VAL). Подробнее в (Filter Type) |
period | String | Да | Задает временной промежуток стандартного формата (Period). |
sort | [name: String,asc: boolean] | Нет | Тип сортировки событий в формате «имя параметра сортировки – порядок сортировки». |
text | String | Нет | Текстовая строка, по которой будут отфильтрованы значения. Имеет ограничение в 256 символов. Равносильно фильтру с типом RAW в списке filters. |
type | String | Нет | Тип событий. Может быть CRASH, ANR, NON_FATAL, NATIVE, MEMORY_LEAK, METRIC_KIT. По умолчанию null. |
types | [String] | Нет | Список типов событий. По умолчанию null. |
versionCode | Long | Нет | versionCode – задается при установке фильтра Версии. |
versionCodes | [Long] | Нет | Список versionCode, для которых нужно получить данные. Этот параметр задается при установке фильтра Версии. |
userId | String | Нет | ID пользователя, для которого следует вывести значения. |
Возвращаемое значение:
| Параметр | Тип | Описание |
|---|---|---|
bmarker | String | Строковое значение, указывающее на запись, с которой началась выгрузка. |
count | int | Количество полученных значений. |
hasMore | boolean | Указывает на наличие еще значений. |
items | [CrashFilterOptionBean] | Список значений. |
marker | String | Строковое значение, указывающее на последний загруженный элемент. |
totalCount | Long | Общее количество значений в указанный период. |
| Параметр | Тип | Описание |
|---|---|---|
count | long | Количество значений |
name | String | Название фильтра |
emptyOption | Boolean | Указывает на отсутствие значений |
При возникновении вопросов обращайтесь в чат поддержки.