Дополнительные возможности

Tracer SDK ожидает информацию о версии приложения, которая будет отправляться вместе с ошибками

Параметр	Какую информацию предоставляет
"version_name"	Название версии приложения
"version_code"	Версия приложения

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

tracer_log(const tracer_str_char* message)

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

Параметр	Тип	Описание
message	const tracer_str_char*	Сообщение для записи в лог (UTF-8)

Для логирования событий в вашем app.cpp:

#include "tracer.h"

int main() {
    // Инициализация
    const char* app_key = "your-app-key";
    const tracer_path_char* storage_dir = "/path/to/crash/storage";
    tracer_init(app_key, storage_dir);
    
    tracer_log("App started successfully.");
    tracer_log("User logged in.");
    return 0;
}

Ваши логи, предшествующие наступлению события, будут приложены к описанию этого события в соответствующем разделе в описании события:

tracer_enable_logging_to_console()

Эта функция включает запись логов в консоль. Может быть вызвана до инициализации библиотеки.

В вашем app.cpp:

#include "tracer.h"

int main() {
    // Инициализация
    const char* app_key = "your-app-key";
    const tracer_path_char* storage_dir = "/path/to/crash/storage";
    tracer_init(app_key, storage_dir);

    tracer_enable_logging_to_console();
    tracer_log("Logging to console enabled.");
    // Основной код приложения
    return 0;
}

tracer_set_key(const tracer_str_char* key, const tracer_str_char* value)

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

Параметр	Тип	Описание
key	const tracer_str_char*	Ключ для метаданных (UTF-8 строка)
value	const tracer_str_char*	Значение для ключа (UTF-8 строка)

Для установки ключаей в вашем app.cpp:

#include "tracer.h"

int main() {
    // Инициализация
    const char* app_key = "your-app-key";
    const tracer_path_char* storage_dir = "/path/to/crash/storage";
    tracer_init(app_key, storage_dir);
    
    tracer_set_key("user_id", "12345");
    tracer_set_key("session_id", "abcde");
    return 0;
}

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