1. Install the TOAST SDK 2. TOAST 콘솔에서 Log & Crash Search를 활성화합니다. 3. Log & Crash Search에서 AppKey를 확인합니다.
Log & Crash Search에서 발급받은 AppKey를 ProjectKey로 설정합니다.
...
#include "toast/ToastLogger.h"
using namespace toast::logger;
...
ToastLogger* logger = GetToastLogger();
ToastLoggerConfiguration* loggerConf = GetToastLoggerConfiguration();
...
loggerConf->setProjectKey(appkey);
loggerConf->setProjectVersion(version);
...
if (_logger != NULL)
{
_logger->initialize(loggerConf);
}
ToastSDK에 사용자 아이디를 설정할 수 있습니다. 설정한 UserID는 ToastSDK의 각 모듈에서 공통으로 사용됩니다. ToastLogger의 로그 전송 API를 호출할 때마다 설정한 사용자 아이디를 로그와 함께 서버로 전송합니다.
ToastLogger* _logger = GetToastLogger();
_logger->setUserId("userId");
_logger->initialize(loggerConf);
_logger->getUserId();
TOAST Logger는 5가지 레벨의 로그 전송 함수를 제공합니다.
// 일반 로그
_logger->log(level, message, _userFieldMap);
// DEBUG 레벨 로그
_logger->debug(level, message, _userFieldMap);
// INFO 레벨 로그
_logger->info(level, message, _userFieldMap);
// WARN 레벨 로그
_logger->warn(String message);
// ERROR 레벨 로그
_logger->error(String message);
// FATAL 레벨 로그
_logger->fatal(String message);
ToastLoggerUserFields* _userFieldMap = CreateToastLoggerUserFields();
_userFieldMap->insert(key, value);
if (_userFieldMap != NULL)
{
if (_userFieldMap->size() > 0)
{
_logger->log(level, message, _userFieldMap);
}
else
{
_logger->log(level, message);
}
}
ToastLoggerUserFields는 아래와 같은 함수를 지원합니다.
사용자 정의 필드는 "Log & Crash Search 콘솔" > "Log Search 탭"에 "선택한 필드"로 노출되는 값과 동일합니다.
즉, Log & Crash Search의 커스텀 파라미터와 동일한 것으로 "field"값의 상세한 제약 사항은 커스텀 필드의 제약사항에서 확인할 수 있습니다.
_logger->addUserField("nickname", "randy");
_logger->removeUserField("nickname");
_logger->cleareUserField();
크래시 리포터(CrashRepoter.exe)는 크래시 정보를 로그로 전송하는 기능을 제공합니다. 크래시 발생 시에 크래시 리포터를 통해서 크래시 정보를 로그로 전송합니다. ToastLogger 초기화 시에 크래시 리포터 사용 여부를 설정할 수 있습니다. 크래시 리포터 다이얼로그 박스 사용 여부 및 커스텀 메시지를 설정할 수 있습니다.
...
#include "toast/ToastLogger.h"
using namespace toast::logger;
...
ToastLogger* logger = GetToastLogger();
ToastLoggerConfiguration* loggerConf = GetToastLoggerConfiguration();
...
// 크래시 로그 활성화 여부
loggerConf->enableCrashReporter(true);
// 크래시 리포터 다이얼로그 사용 여부
loggerConf->enableSilenceMode(false);
// 크래시 리포터 다이얼로그에 보일 메시지 정의
// (정의하지 않으면 기본 메시지가 보이게 됩니다.)
loggerConf->setCrashReporterMessage(TOAST_LANGUAGE_KOREAN, "오류가 발생한 상황...\n");
...
if (_logger != NULL)
{
_logger->initialize(loggerConf);
}
void CsampleDlg::OnBnClickedCrash()
{
// TODO: Add your control notification handler code here
int *i = reinterpret_cast<int*>(0x45);
*i = 5;
}
dump_syms sample.pdb > sample.sym
크래시 발생 직후, 추가 정보를 설정할 수 있습니다. setUserField는 크래시 시점과 관계없이 아무 때나 설정할 수 있고, setDataAdapter의 경우 정확히 크래시가 발생한 시점에 추가 정보를 설정할 수 있습니다.
static void setDataAdapter(CrashDataAdapter adapter);
ToastLogger.setDataAdapter(new CrashDataAdapter() {
@Override
public Map<String, Object> getUserFields() {
Map<String, Object> userFields = new HashMap<>();
userFields.put("UserField", "UserValue");
return userFields;
}
});