Быстрый старт

Регистрация и настройка

Для начала нужно:

  1. Зайти в аккаунт Tracer.
  2. Создать или вступить в организацию.
  3. Добавить андроид проект (нужно быть администратором или владельцем организации).

Подключение зависимостей на Трейсер к проекту

В вашем <project>/settings.gradle.kts добавьте репозитории с плагином трейсера и рантаймом трейсера.

pluginManagement { repositories { // другие репозитории c вашими зависимостями maven { setUrl("https://artifactory-external.vkpartner.ru/artifactory/maven/") } } } dependencyResolutionManagement { repositories { // другие репозитории c вашими зависимостями maven { setUrl("https://artifactory-external.vkpartner.ru/artifactory/maven/") } } }

В вашем <project>/<app-module>/build.gradle.kts

plugins { id("ru.ok.tracer") version("0.2.16") } tracer { create("defaultConfig") { // См. в разделе "Настройки" pluginToken = "PLUGIN_TOKEN" appToken = "APP_TOKEN" // Включает загрузку маппингов для билда. По умолчанию включена uploadMapping = true // Включает загрузку отладочной информации из native-библиотек для обработки нативных крешей // Обрабатывает всё, что попадает в build/intermediates/merged_native_libs // т.е. модули с NDK-кодом, библиотеки из зависимостей, библиотеки из jniLibs, ... // Не загружает отладочную информацию для библиотек, у которых нет отладочной информации // // Без сборщика нативных крешей включать не очень осмысленно // По умолчанию выключено uploadNativeSymbols = true // Передаёт дополнительный путь с native-библиотеками в загрузчик // Отладочная информация с библиотек, содержащихся в нем, "перекрывает" ту, что // собирается из build/intermediates/merged_native_libs // По умолчанию null additionalLibrariesPath = projectDir.toString() + "/aVeryNonstandardLibsDirectory" } // Также можно задавать конфигурацию для каждого flavor, buildType, buildVariant. // Конфигурации наследуют defaultConfig. create("debug") { // Параметры... } create("demoDebug") { // Параметры... } } dependencies { // Плагины независимы друг от друга. Можно подключать только те, // которые необходимы в данный момент. // Сбор и анализ крешей и ANR implementation("ru.ok.tracer:tracer-crash-report:0.2.16") // Сбор и анализ нативных крешей implementation("ru.ok.tracer:tracer-crash-report-native:0.2.16") // Сбор и анализ хипдапмов при OOM implementation("ru.ok.tracer:tracer-heap-dumps:0.2.16") // Анализ потребления дискового места на устройстве implementation("ru.ok.tracer:tracer-disk-usage:0.2.16") // Семплирующий профайлер implementation("ru.ok.tracer:tracer-profiler-sampling:0.2.16") // Систрейс implementation("ru.ok.tracer:tracer-profiler-systrace:0.2.16") }

Включение плагинов трейсера и их конфигурация в проекте

В вашем Application.kt реализуйте интерфейс HasTracerConfiguration

class MyApplication : Application(), HasTracerConfiguration { override val tracerConfiguration: List<TracerConfiguration> get() = listOf( CoreTracerConfiguration.build { // опции ядра трейсера }, CrashReportConfiguration.build { // опции сборщика крэшей }, CrashFreeConfiguration.build { // опции подсчета crash free }, HeapDumpConfiguration.build { // опции сборщика хипдампов при ООМ }, DiskUsageConfiguration.build { // опции анализатора дискового пространства }, SystraceProfilerConfiguration.build { // опции systrace-профайлера в продакшене }, SamplingProfilerConfiguration.build { // опции семплирующего профайлера }, ) }

Проперти HasTracerConfiguration.tracerConfiguration будет запрошена ровно один раз при старте процесса до вызова Application.onCreate но после Application.attachBaseContext. В геттере уже можно обращаться к контексту приложения, но еще рано обращаться к тому, что проинициализируется в onCreate.

Подробное описание опций:

  • CoreTracerConfiguration — далее на этой странице
  • CrashReportConfiguration и CrashFreeConfiguration — на странице Crash и ANR
  • HeapDumpConfiguration — на странице Heap Dumps
  • DiskUsageConfiguration — на странице Disk Usage
  • SystraceProfilerConfiguration — на странице Systrace Profiler
  • SamplingProfilerConfiguration - на странице Sampling Profiler

Описание CoreTracerConfiguration

В том редком случае, когда вы захотите сконфигурировать ядро трейсера в вашем проекте, нужно вернуть CoreTracerConfiguration из HasTracerConfiguration

class MyApplication : Application(), HasTracerConfiguration { override val tracerConfiguration: List<TracerConfiguration> get() = listOf( CoreTracerConfiguration.build { // ваши опции }, ) }

Опции CoreTracerConfiguration.Builder:

ОпцияОписание
setApiUrl или provideApiUrlИзменяет адреса api Tracer-а. Используйте с умом.
setOverrideAppToken или provideOverrideAppTokenПереопределяет appToken из конфигурации gradle-плагина. Используйте с умом.
setDebugUploadОтвечает за включение/выключение загрузки данных в дебажной сборке приложения. По умолчанию загрузка данных выключена.

В CoreTracerConfiguration.Builder также есть устаревшие функции, использование которых не рекомендуется:

ОпцияОписание
setEnabledНе используется и будет удалена в версии 0.3.x. Ядро трейсера всегда включено, но не активно пока нет включенных плагинов
setHost или provideHostУстарела и будет удалена в версии 0.3.x. Используйте setApiUrl и provideApiUrl соответственно
setCustomAppKey или provideCustomAppKeyУстарела и будет удалена в версии 0.3.x. Используйте setOverrideAppToken и provideOverrideAppToken соответственно
setStatHost или provideStatHostНе используется и будет удалена в версии 0.3.x.

Демо приложение

Ознакомиться с примером интеграции можно в нашем демо проекте