본문으로 건너뛰기
Version: 7.0

PlanetKit 초기화 및 로그 설정

애플리케이션에서 LINE Planet의 기능을 사용하기 전에 PlanetKit을 초기화해야 합니다. 여기서는 PlanetKit을 초기화하고 로그를 설정하는 예제 코드를 제공합니다.

초기화​

Configuration 객체를 인자로 PlanetKitManager::Initialize()를 호출해 PlanetKit을 초기화하세요. 이때 반드시 UpdateServerUrl()을 이용해 planet_base_url을 설정해야 합니다.

Note

환경별 planet_base_url 정보는 개발 환경에서 찾을 수 있습니다.

void YourApplication::InitializePlanetKit(bool bLogSizeUnlimited, PlanetKit::ELogLevel eLogLevel, PlanetKit::ELogSizeLimit eLogSizeLimit = PlanetKit::ELogSizeLimit::PLNK_LOG_SIZE_LIMIT_LARGE)
{
    PlanetKit::WString strLogPath(L"your_log_path");
    PlanetKit::ConfigurationPtr pConfiguration = PlanetKit::Configuration::Create(L"./");

    if(bLogSizeUnlimited) {
        pConfiguration->EnableLog(strLogPath, L"your_log_file_name", eLogLevel);
    }
    else {
        pConfiguration->EnableLog(strLogPath, eLogLevel, eLogSizeLimit);
    }

    PlanetKit::PlanetKitManager::Initialize(pConfiguration);

    PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();

    pPlanetKitManager->UpdateServerUrl(planet_base_url);
}

로그 설정​

디버깅이 필요한 경우 초기화 중에 Configuration 클래스의 EnableLog()를 사용하여 로깅을 설정해야 합니다. PlanetKit은 유연한 로그 설정을 위해 두 가지 EnableLog() 메서드를 제공합니다.

Note
  • 기본적으로 로깅은 비활성화되어 있습니다.
  • PlanetKit 5.1부터는 파일로만 로그를 출력할 수 있습니다.

로그 수준​

로그 수준을 설정하여 출력되는 디버그 정보의 수준을 조정할 수 있습니다. ELogLevel enum에서 제공하는 로그 레벨 설정은 다음과 같습니다:

  • PLNK_LOG_SIMPLE: PlanetKit이 간단한 디버그 정보를 출력합니다.
  • PLNK_LOG_DETAILED: PlanetKit이 자세한 디버그 정보를 출력합니다.
Note

LINE Planet 팀에 디버깅을 요청하려면 PLNK_LOG_DETAILED 수준으로 생성된 로그 파일을 전달해 주어야 합니다.

크기 제한이 있는 로깅 설정​

크기 제한에 도달하면 자동 로테이션되는 로깅을 설정하려면 EnableLog(strLogDirectory, eLogLevel, eLogSizeLimit) 메서드를 사용하세요.

  • 로그 파일 이름
    • 로그 파일은 내부 로직에 따라 로테이션이 적용되어 생성됩니다(예: planetkit.log, planetkit.log.1, planetkit.log.2).
  • 로그 레벨
    • eLogLevel 파라미터의 기본값은 PLNK_LOG_SIMPLE입니다.
  • 로그 크기 제한
    • ELogSizeLimit enum에서 제공하는 로그 크기 제한 설정은 다음과 같습니다.
      • PLNK_LOG_SIZE_LIMIT_SMALL: 전체 로그 파일의 크기 제한은 16MB입니다.
      • PLNK_LOG_SIZE_LIMIT_MEDIUM: 전체 로그 파일의 크기 제한은 64MB입니다.
      • PLNK_LOG_SIZE_LIMIT_LARGE: 전체 로그 파일의 크기 제한은 256MB입니다.
    • eLogSizeLimit 파라미터의 기본값은 PLNK_LOG_SIZE_LIMIT_LARGE입니다.

다음은 크기 제한이 있는 로깅을 설정하는 예제 코드입니다.

void YourApplication::InitializePlanetKitWithSizeLimit(PlanetKit::ELogLevel eLogLevel, PlanetKit::ELogSizeLimit eLogSizeLimit = PlanetKit::ELogSizeLimit::PLNK_LOG_SIZE_LIMIT_LARGE)
{
    PlanetKit::WString strLogPath(L"your_log_path");
    PlanetKit::ConfigurationPtr pConfiguration = PlanetKit::Configuration::Create(L"./");

    pConfiguration->EnableLog(strLogPath, eLogLevel, eLogSizeLimit);

    PlanetKit::PlanetKitManager::Initialize(pConfiguration);

    PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();

    pPlanetKitManager->UpdateServerUrl(planet_base_url);
}

크기 제한 없는 로깅 설정​

크기 제한 없는 로깅을 설정하려면 EnableLog(strLogDirectory, strLogFileName, eLogLevel) 메서드를 사용하세요.

  • 로그 파일 이름
    • 시스템이 생성하는 로그 파일의 기본 형식은 타임스탬프가 포함된 planetkitMMDD_HHMMSS.log입니다.
    • 필요에 따라 strLogFileName 파라미터로 사용자 지정 파일 이름을 설정할 수 있습니다.
  • 로그 레벨
    • eLogLevel 파라미터의 기본값은 PLNK_LOG_SIMPLE입니다.

다음은 크기 제한이 없는 로깅을 설정하는 예제 코드입니다.

void YourApplication::InitializePlanetKitWithoutSizeLimit(PlanetKit::ELogLevel eLogLevel)
{
    PlanetKit::WString strLogPath(L"your_log_path");
    PlanetKit::ConfigurationPtr pConfiguration = PlanetKit::Configuration::Create(L"./");

    pConfiguration->EnableLog(strLogPath, L"your_log_file_name", eLogLevel);

    PlanetKit::PlanetKitManager::Initialize(pConfiguration);

    PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();

    pPlanetKitManager->UpdateServerUrl(planet_base_url);
}

관련 예제 코드​

관련 문서​