DB, SQL 추적

개발팀 전달 사항 (clio-lua, 2026-06-23)

부분 수정 기존 문서에서 아래 draft 구간만 바뀌었습니다.

근거 커밋

• f12dd96a §301 — trace_sql_normalize_enabled 문서-소스 불일치 정정 (by 임재환)

상태 개발자 컨펌 대기. 컨펌 후 이 박스를 지우면 본문만 남습니다.

이번 사이클 변경 구간

• trace_sql_normalize_enabled Boolean

  기본값 true

  SQL 문에서 리터럴 부분을 추출하여 SQL 문을 정규화하는 기능입니다. 리터럴 부분은 "#"으로 표기됩니다.

  노트

  현재 버전에서 SQL 정규화는 항상 활성 상태로 동작하며, 이 옵션으로 비활성화할 수 없습니다. (개발팀 컨펌 필요: 옵션이 코드에서 true로 고정된 상태인지, 옵션 자체가 제거 예정인지 확인)

• profile_sql_param_enabled Boolean

  기본값 false

  트레이스 내역에 SQL 파라미터 정보를 기록하고자 할 때 사용합니다. 파라미터는 별도 보안 키를 입력해야 조회할 수 있습니다.

  노트

  • Go agent v0.4.0 or later: 보안 키는 whatap.conf 파일이 위치한 WHATAP_HOME/security.conf 파일 내에 6자리(paramkey)로 설정합니다.

  • Below Go agent v0.4.0: 보안 키는 whatap.conf 파일이 위치한 WHATAP_HOME/paramkey.txt 파일 내에 6자리로 설정합니다. paramkey.txt 파일이 존재하지 않는 경우 랜덤 값으로 자동 생성합니다.