Abseil Code Review · 59/79

Abseil LOG·VLOG·CHECK 분석

2026년 6월 12일 · Hawk · 3분 읽기

#absl::log의 위치

Google은 오랜 기간 glog 를 사용해 왔다. Abseil의 absl/log/는 glog의 후속이며 인터페이스가 거의 동일하다.

1
#include "absl/log/log.h"
2
#include "absl/log/check.h"
3

4
LOG(INFO) << "user " << user_id << " logged in";
5
LOG(WARNING) << "slow query: " << elapsed;
6
LOG(ERROR) << "failed to send: " << status;
7

8
CHECK(ptr != nullptr) << "ptr must be set";
9
CHECK_EQ(actual, expected) << "mismatch";

스트림 인터페이스(operator<<)가 표준이다. 인자가 absl::AlphaNum 호환이면(거의 모든 primitive·string·absl::Time 등) 자동 변환.

#Severity 레벨

매크로	의미	보통 동작
`LOG(INFO)`	정보	stderr/파일
`LOG(WARNING)`	경고	stderr/파일
`LOG(ERROR)`	에러	stderr/파일 + alert
`LOG(FATAL)`	치명	로그 후 abort
`LOG(QFATAL)`	조용한 fatal	stack trace 없이 종료
`LOG(DFATAL)`	debug=FATAL, release=ERROR	개발 중에만 abort

FATAL은 반드시 종료. 절대 호출 후 코드가 실행되지 않는다고 가정한다(noreturn 표시).

#초기화 — InitializeLog

main에서 한 번 호출.

1
#include "absl/log/initialize.h"
2

3
int main(int argc, char** argv) {
4
    absl::ParseCommandLine(argc, argv);
5
    absl::InitializeLog();
6
    // ... 이후 LOG 사용 가능
7
}

호출 전에는 LOG가 안전히 raw fallback으로 동작(stderr에 단순 출력)한다. 그러나 sink·level 설정이 적용되지 않으므로 production 코드는 초기화를 잊지 말 것.

#출력 포맷

기본 출력은 다음과 같은 한 줄이다.

1
I20260525 13:00:00.123456 12345 file.cc:42] user 123 logged in

I — severity 첫 글자 (I/W/E/F)
타임스탬프 — UTC, ms 정밀도
thread id
소스 파일 + 라인
본문

--log_format/--stderrthreshold 같은 flag로 조절 가능.

#VLOG — verbose level

INFO보다 자세한 정보를 조건부 로 남긴다.

1
VLOG(1) << "step 1 details";
2
VLOG(2) << "step 1 inner detail";
3
VLOG(3) << "raw payload: " << payload;

--v=2 같은 flag로 활성화. 2 이하 레벨만 출력. 비활성 상태에서는 인자 평가도 안 일어남 (if (VLOG_IS_ON(2)) 등가).

1
VLOG(2) << "expensive: " << ComputeDump();   // ComputeDump 호출 안 됨 — --v < 2

이 lazy evaluation 덕에 production에서 자유롭게 VLOG를 뿌려도 비용 없음.

#CHECK — runtime assertion

assert보다 강한 invariant. release 빌드에서도 활성화.

1
CHECK(ptr != nullptr) << "ptr required";
2
CHECK_EQ(a, b) << "expected a == b, got " << a << " vs " << b;
3
CHECK_NE(x, 0);
4
CHECK_LT(idx, size);
5
CHECK_GE(count, 0);

실패 시 LOG(FATAL) → stack trace + abort. 메시지는 실패 직전에만 평가되어 lazy.

1
CHECK(x.IsValid()) << "x=" << x.DebugDump();   // DebugDump는 실패 시에만 호출

#DCHECK — debug 한정

CHECK의 debug-only 버전. release 빌드에서는 완전히 사라진다.

1
DCHECK(invariant) << "...";    // -DNDEBUG에서 no-op
2
DCHECK_EQ(size, expected);

성능에 민감한 hot path에서 비싼 invariant 검증에 적합.

#QCHECK — quiet check

QFATAL의 짝. 실패 시 stack trace 없이 종료.

1
QCHECK(absl::ParseFlag(input, &v, &err)) << "bad input: " << err;

flag·configuration 검증처럼 사용자 입력 에러는 stack trace가 노이즈가 되므로 QCHECK가 깔끔하다.

#LOG_EVERY_N / LOG_FIRST_N

쏟아지는 로그를 제한.

1
LOG_EVERY_N(WARNING, 100) << "rare event";   // 100번에 한 번
2
LOG_FIRST_N(INFO, 5) << "first 5 only";      // 처음 5번만
3
LOG_EVERY_N_SEC(INFO, 10) << "every 10s";    // 10초에 한 번

내부적으로 thread-local counter. 멀티스레드에서는 정확한 N마다가 아니라 근사. 디버그 dump 용도면 충분.

#매크로의 효율

LOG(INFO)는 if (Enabled(INFO)) 검사를 인라인으로 한다. 비활성 severity면 분기 한 번 이면 끝나고 메시지 인자 평가도 일어나지 않는다.

1
LOG(VERBOSE) << ExpensiveDump();   // VERBOSE 비활성이면 ExpensiveDump 호출 안 됨

#작은 예시 — 요청 핸들러

1
absl::Status HandleRequest(const Request& req) {
2
    VLOG(1) << "request: " << req.DebugString();
3

4
    CHECK(!req.user_id().empty()) << "user_id required";
5

6
    auto user = LookupUser(req.user_id());
7
    if (!user.ok()) {
8
        LOG(WARNING) << "lookup failed for " << req.user_id() << ": " << user.status();
9
        return user.status();
10
    }
11

12
    auto resp = Process(*user, req);
13
    if (!resp.ok()) {
14
        LOG(ERROR) << "process failed: " << resp.status();
15
        return resp.status();
16
    }
17

18
    LOG_EVERY_N(INFO, 1000) << "processed " << req.user_id();
19
    return absl::OkStatus();
20
}

#회피 패턴

1
// 회피 — std::cerr / printf
2
std::cerr << "error: " << status << "\n";   // ❌ thread-unsafe interleaving
3
printf("%s\n", msg.c_str());                // ❌ format 안 맞을 수 있음
4

5
// Good
6
LOG(ERROR) << "error: " << status;

1
// 회피 — LOG가 비싼 경우에도 항상 평가
2
LOG(INFO) << "dump: " << ExpensiveDump();   // INFO 비활성이면 낭비
3

4
// Good — VLOG로 lazy
5
VLOG(1) << "dump: " << ExpensiveDump();

1
// 회피 — CHECK 대신 if + return
2
if (!ptr) return absl::InternalError("null");   // ⚠️ invariant 위반인데 복구?
3

4
// Good — invariant이면 CHECK
5
CHECK(ptr != nullptr) << "internal invariant";