사용자 지정 핸들러
직접 로그 출력 만들기
사용자 지정 핸들러은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
내장 처리기로 충분하지 않은 경우
텍스트 처리기와 JSON 처리기는 대부분의 요구를 충족하지만, 때로는 색상이 있는 터미널 출력, 메트릭 시스템으로 전송, 비밀 정보 가리기 같은 사용자 지정 출력이 필요합니다. 이때 사용자 지정 처리기를 만듭니다.
처리기 인터페이스
처리기는 네 가지 메서드를 구현합니다:
Enabled(ctx, level) boolHandle(ctx, record) errorWithAttrs(attrs) HandlerWithGroup(name) Handler
type Handler interface {
Enabled(context.Context, slog.Level) bool
Handle(context.Context, slog.Record) error
WithAttrs(attrs []slog.Attr) slog.Handler
WithGroup(name string) slog.Handler
}Enabled가 필터링을 제어합니다
Enabled는 레코드를 만들기 전에 호출됩니다. false를 반환하면 slog가 작업을 완전히 건너뛸 수 있으므로 수준 확인에 사용하십시오.
func (h *MyHandler) Enabled(_ context.Context, l slog.Level) bool {
return l >= slog.LevelInfo
}Handle이 작업을 수행합니다
Handle은 시간, 수준, 메시지, 특성을 포함한 slog.Record를 받습니다. 원하는 방식으로 형식을 지정하고 기록하면 됩니다.
func (h *MyHandler) Handle(_ context.Context, r slog.Record) error {
fmt.Printf("[%s] %s\n", r.Level, r.Message)
return nil
}특성 순회하기
Record는 r.Attrs를 통해 특성을 공개하며, r.Attrs는 각 특성에 대해 사용자의 함수를 호출합니다.
r.Attrs(func(a slog.Attr) bool {
fmt.Printf(" %s=%v\n", a.Key, a.Value)
return true // keep going
})WithAttrs와 WithGroup
이 메서드들은 미리 설정한 특성이나 그룹 접두사를 포함하는 처리기 사본을 반환합니다. logger.With와 slog.Group을 지원합니다. 최소한의 처리기라면 이를 저장하고 다시 적용할 수 있고, 학습 목적이라면 자기 자신을 반환해도 됩니다.
직접 만들지 않고 감싸기
대개 처리기를 완전히 새로 만들 필요는 없습니다. 기존 처리기를 감싸고 상수 특성 추가나 키 가리기처럼 필요한 동작만 재정의하면 됩니다.
type RedactHandler struct{ slog.Handler }
func (h RedactHandler) Handle(ctx context.Context, r slog.Record) error {
// mutate r here, then delegate
return h.Handler.Handle(ctx, r)
}사용 사례: 민감 정보 가리기
민감 정보 제거 처리기는 password나 token 같은 민감한 키를 특성에서 찾아 JSON 처리기로 넘기기 전에 값을 바꿀 수 있습니다.
사용 사례: 라우팅
사용자 지정 처리기는 수준에 따라 라우팅할 수 있습니다. Error 로그는 표준 오류와 경고 웹훅으로 보내고 Info는 표준 출력으로 보낼 수 있습니다. 이렇게 하면 모든 호출 위치에 라우팅 로직을 넣지 않아도 됩니다.
성능 참고 사항
Handle은 자주 실행되는 경로에서 호출될 수 있습니다. 메모리 할당을 피하고, Enabled에서 수준을 확인하며, 버퍼를 재사용하십시오. 표준 처리기가 내부에서 풀링된 버퍼를 사용하는 이유도 여기에 있습니다.
실행 예제: 최소한의 사용자 지정 처리기
이 독립 실행형 프로그램은 수준, 메시지, 특성을 출력하는 작은 처리기를 정의한 다음 이를 통해 로그를 기록합니다.
package main
import (
"context"
"fmt"
"log/slog"
)
type Mini struct{}
func (Mini) Enabled(context.Context, slog.Level) bool { return true }
func (Mini) WithAttrs(a []slog.Attr) slog.Handler { return Mini{} }
func (Mini) WithGroup(string) slog.Handler { return Mini{} }
func (Mini) Handle(_ context.Context, r slog.Record) error {
fmt.Printf("%s: %s", r.Level, r.Message)
r.Attrs(func(a slog.Attr) bool {
fmt.Printf(" %s=%v", a.Key, a.Value)
return true
})
fmt.Println()
return nil
}
func main() {
l := slog.New(Mini{})
l.Info("hello", "user", "ada", "id", 7)
}빠른 확인
사용자 지정 처리기를 제대로 이해했는지 확인해 보십시오.
복습
사용자 지정 처리기를 만드는 방법을 배웠습니다:
Enabled,Handle,WithAttrs,WithGroup을 구현합니다- 성능을 위해
Enabled에서 수준을 확인합니다 r.Attrs로 특성을 순회합니다- 처리기를 처음부터 만드는 것보다 기존 처리기를 감싸는 편이 더 쉬운 경우가 많습니다
AI 튜터와 함께 Go을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“사용자 지정 핸들러” 강의는 무료인가요?
네 — “사용자 지정 핸들러” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 핸들러”에서 뭘 배우나요?
직접 로그 출력 만들기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“사용자 지정 핸들러” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 구조화된 로그를 사용하는 이유
- slog 핸들러
- 로그 수준과 속성
- 사용자 지정 핸들러