DD
DD(소스 주석에서 "data-driven" 또는 "distributed debugger"로 읽음) 는 CyberGo 조직의 고성능 구조화 로그 라이브러리로, 스레드 안전한 로깅, 유연한 출력 대상 구성, 포괄적인 보안 보호 기능을 제공합니다.
특징
- 구조화 로그 -- 타입 안전한 필드 기록, 선택적 JSON 형식 출력
- 다중 출력 대상 -- 콘솔, 파일, 사용자 정의
io.Writer에 동시 출력 - 파일 로테이션 -- 크기 기반 자동 로테이션, 백업 수량 제한 및 시간 보존 정책 지원
- 민감 데이터 필터링 -- 내장 정규식 패턴으로 비밀번호, 키, Token 등 민감 정보 자동 마스킹
- 필드 검증 -- 필드 키 명명 규칙 검증(snake_case/camelCase 등) 및 Log4Shell 주입 방지
- 감사 로그 -- 비동기 감사 이벤트 기록, HMAC 무결성 서명 및 시퀀스 번호 지원
- 훅 시스템 -- BeforeLog, AfterLog, OnRotate 등 라이프사이클 훅
- 컨텍스트 통합 -- TraceID/SpanID/RequestID용 context 도구 및 ContextExtractor 확장점 제공 (로그 메서드는 ctx 를 받지 않으며, WithFields 로 필드를 전달해야 함)
- 로그 샘플링 -- 고처리량 시나리오에서 선택적 로그 샘플링 전략
- 저할당 최적화 -- 핫 패스의 메모리 할당을 최소화하여 뛰어난 성능 제공
설치
bash
go get github.com/cybergodev/dd빠른 시작
go
package main
import (
"time"
"github.com/cybergodev/dd"
)
func main() {
// 기본 로거 사용
dd.Info("서비스 시작")
// 구조화 로그
dd.InfoWith("요청 처리 완료",
dd.String("method", "GET"),
dd.Int("status", 200),
dd.Duration("elapsed", 150*time.Millisecond),
)
// 커스텀 로거 생성
logger, _ := dd.New(dd.DefaultConfig())
defer logger.Close()
logger.Info("커스텀 로거가 생성되었습니다")
}모듈 탐색
| 모듈 | 설명 |
|---|---|
| 핵심 개념 | Logger 체계, 처리 파이프라인, 인터페이스 계층 |
| 설정 | Config 구조체, 프리셋, 출력 대상 |
| 구조화된 로깅 | 필드 생성자, 체인 호출 |
| 파일 출력 및 로테이션 | FileWriter, BufferedWriter |
| 민감 데이터 필터링 | 자동 마스킹, 보안 등급 |
| 필드 검증 | 명명 규칙 검사, Log4Shell 방지 |
| 로그 샘플링 | 고처리량 로그 감량 전략 |
| 감사 로깅 | 비동기 감사 이벤트, 무결성 서명 |
| 훅 시스템 | 라이프사이클 훅 확장 |
| 오류 처리 | 구조화된 오류, 센티넬 오류, errors.Is |
| 분산 추적 통합 | TraceID/SpanID/RequestID 통합 |
| 마이그레이션 가이드 | log/slog/zap/logrus에서 마이그레이션 |