DB, SQL 추적

검수 중인 초안 — clio-lua, 2026-06-23 추가

커밋: f12dd96a (§301 — trace_sql_normalize_enabled 문서-소스 불일치 정정) 상태: 개발자 컨펌 대기. 최종 머지 직전 본 박스 마커는 제거되고 본문만 남습니다.

• 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 파일이 존재하지 않는 경우 랜덤 값으로 자동 생성합니다.