Java Academy · 강의

매개변수화된 로깅

효율적인 메시지 형식을 다룹니다

매개변수화된 로깅은(는) CoddyKit의 무료 Java Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Java Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

문자열 연결의 문제

로그 메시지를 연결하면 수준이 비활성화되어 있더라도 호출 전에 전체 문자열이 생성됩니다.

DEBUG가 꺼져 있어도 문자열은 무조건 생성되므로 log.debug("id=" + id + " name=" + name)은 CPU를 낭비합니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        String name = "Ada"; int id = 7;
        // Bad: string is built even if DEBUG is disabled
        log.debug("id=" + id + " name=" + name);
    }
}

{}를 사용하는 자리 표시자

SLF4J는 {}를 자리 표시자로 사용합니다. 값을 추가 인수로 전달하십시오.

수준이 활성화된 경우에만 메시지가 조합되므로, 비활성화된 로그 기록에는 비용이 거의 들지 않습니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        String name = "Ada"; int id = 7;
        // Good: no string built unless DEBUG is on
        log.debug("id={} name={}", id, name);
    }
}

여러 자리 표시자

자리 표시자는 순서대로 채워집니다. 첫 번째 {}에는 첫 번째 인수가, 두 번째 자리 표시자에는 두 번째 인수가 들어가는 식입니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        log.info("order {} for user {} totaling {} cents", "A-1", 42, 1599);
    }
}

효율적인 이유

프레임워크는 먼저 수준을 확인합니다. 비활성화되어 있으면 어떤 인수에도 toString()을 호출하지 않고 즉시 반환합니다.

비용이 큰 형식 지정 작업은 메시지가 실제로 출력될 때만 지연하여 수행됩니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    static String describe(Object o) { System.out.println("toString called"); return o.toString(); }
    public static void main(String[] args) {
        // Note: passing describe(...) still evaluates eagerly; pass the raw object instead
        log.trace("value={}", new int[]{1, 2, 3});
    }
}

미리 형식을 지정한 문자열 대신 원시 객체 전달하기

지연 처리의 이점을 얻으려면 형식을 지정하는 메서드 호출이 아니라 원시 객체를 전달하십시오.

log.debug("{}", buildReport())처럼 작성하면 buildReport()가 여전히 즉시 실행됩니다. 로거가 직접 형식을 지정할 수 있는 인수를 전달하십시오.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        Object user = new Object();
        // Logger calls user.toString() only if DEBUG is enabled
        log.debug("current user: {}", user);
    }
}

비용이 큰 작업을 위한 지연 공급자

형식 지정에 실제로 많은 비용이 들 때는 Supplier를 사용하는 SLF4J 2.x 플루언트 API로 작업을 지연하십시오.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    static String heavyReport() { return "...expensive..."; }
    public static void main(String[] args) {
        log.atDebug()
           .setMessage("report: {}")
           .addArgument(() -> heavyReport())
           .log();
    }
}

리터럴 중괄호 이스케이프하기

메시지에 리터럴 {}를 넣어야 한다면 백슬래시로 이스케이프하십시오. \\{}.

이런 경우는 드물지만 JSON과 비슷한 텍스트를 기록할 때 유용합니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        // Logs a literal {} then the value
        log.info("empty object is \\{} and id is {}", 7);
    }
}

예외와 자리 표시자 함께 사용하기

자리 표시자와 마지막에 전달하는 예외를 함께 사용할 수 있습니다. SLF4J는 마지막 인수가 Throwable인지 감지하여 스택 추적을 출력합니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        int id = 99;
        try {
            throw new RuntimeException("db down");
        } catch (Exception e) {
            log.error("failed processing record {}", id, e);
        }
    }
}

인수를 너무 많이 사용하지 않기

자리 표시자의 개수와 인수의 개수가 일치하지 않으면 SLF4J가 최선을 다해 처리하지만 출력이 이상해질 수 있습니다.

두 개수를 항상 맞추십시오. 값이 몇 개를 넘는다면 구조화된 컨텍스트(MDC)를 대신 사용하는 방법을 고려하십시오.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        // Two placeholders, two arguments: correct
        log.info("user {} did {}", "ada", "login");
    }
}

MDC로 컨텍스트 추가하기

요청 ID처럼 여러 줄에서 공유하는 값은 모든 메시지에 반복해서 넣지 말고 MDC에 넣으십시오.

그러면 패턴 레이아웃이 모든 줄에 MDC 값을 자동으로 출력할 수 있습니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        MDC.put("requestId", "req-1234");
        try {
            log.info("handling request");
            log.info("request done");
        } finally {
            MDC.clear();
        }
    }
}

모범 사례 요약

효율적인 로그 기록을 위한 규칙입니다.

항상 {} 자리 표시자를 사용하고, + 문자열 연결은 사용하지 마십시오.
미리 만든 문자열이 아니라 원시 객체를 전달하십시오.
정말 비용이 큰 작업에는 공급자 또는 isXEnabled()를 사용하십시오.
여러 기능에 걸친 컨텍스트에는 MDC를 사용하십시오.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        log.info("processed {} items in {} ms", 1000, 42);
    }
}

빠른 확인

매개변수화된 로그 기록에 대한 지식을 확인해 보십시오.

복습

매개변수화된 로그 기록을 배웠습니다.

추가 인수와 함께 {} 자리 표시자를 사용합니다.
메시지는 수준이 켜져 있을 때만 지연하여 생성됩니다.
원시 객체를 전달하고, 비용이 큰 작업에는 공급자를 사용합니다.
공유 컨텍스트 값에는 MDC를 사용합니다.

다음으로 Logback 백엔드 설정을 살펴봅니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    private static final Logger log = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        log.info("Parameterized logging recap: {}", "done");
    }
}

자주 묻는 질문

“매개변수화된 로깅” 강의는 무료인가요?

네 — “매개변수화된 로깅” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Java Academy 강의 전체를 잠금 해제할 수 있습니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“매개변수화된 로깅”에서 뭘 배우나요?

효율적인 메시지 형식을 다룹니다 브라우저에서 직접 실행하는 실습 코드로 Java Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Java Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Java Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“매개변수화된 로깅” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Java Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Java Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Java Academy(으)로 돌아가기