본문으로 건너뛰기

DB/SQL 설정

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

커밋: 0a3308c1 (2.14.1 릴리스 — SQL 결과 건수 수집) 상태: 개발팀 컨펌 대기. 최종 머지 직전 본 박스 마커는 제거되고 본문만 남습니다.

SQL 결과 건수 수집 PHP agent v2.14.1 or later​

SQL 실행 결과의 건수를 트랜잭션 프로파일의 [결과 건수] 스텝으로 표시합니다. 즉, SELECT 문은 조회한 행의 건수를, INSERT/UPDATE/DELETE 등 DML 문은 영향을 받은 행의 건수를 확인할 수 있습니다. 과도한 데이터를 조회하거나 변경하는 SQL을 찾을 때 활용합니다.

지원하는 데이터베이스 extension과 수집 범위는 다음과 같습니다.

ExtensionSELECT countDML countNote
mysql수집수집-
mysqli수집수집unbuffered 쿼리는 미수집
PDO수집수집-
pgsql수집수집비동기 쿼리는 미수집
oci8미수집수집SELECT 조회 건수 미수집
mssql수집수집-
sqlsrv미수집수집SELECT 조회 건수 미수집
odbc수집수집-
cubrid수집수집-
phpredis수집수집(개발팀 컨펌 필요) Redis 명령어 기준 건수 의미 확인
노트

oci8과 sqlsrv는 SELECT 조회 건수를 수집하지 않으며 DML 영향 건수만 수집합니다. mysqli의 unbuffered 쿼리와 pgsql의 비동기 쿼리는 결과 건수를 수집하지 않습니다.

  • whatap.trace_sql_normalize_enabled Boolean

    기본값 true

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

  • whatap.profile_sql_resource_enabled Boolean

    기본값 false

    트레이스에서 SQL이 수집될 때 해당 스텝에서 사용한 CPU와 메모리 사용량을 추적합니다.

  • whatap.profile_sql_param_enabled Boolean​

    기본값 false

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

    노트

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

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

  • whatap.profile_sql_comment_enabled Boolean

    기본값 false

    수집하는 SQL 문의 주석을 삭제합니다. false일 경우 주석을 제외한 SQL 문을 수집합니다. 설정을 통해 주석을 포함하거나 삭제할 수 있습니다.

  • whatap.profile_db_connection_map_size Int

    기본값 20

    동시에 연결이 유지되는 DB Connection 정보를 최대로 저장할 수 있는 크기입니다. 초과하는 DB Connection 연결 시 오래된 정보부터 삭제됩니다.

    노트

    Apache 및 PHP-FPM 다시 시작 후 적용됩니다.

  • whatap.profile_mysql_return_enabled Boolean

    기본값 true

    값이 true이면 Mysql 라이브러리 함수의 결과가 false 일 때 오류로 표기하는 기능을 활성화합니다. whatap.profile_mysql_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_mysql_error_ignore_empty Boolean

    기본값 true

    값이 false이면 오류 코드 또는 오류 메시지 내용이 없을 때 정상 결과로 표기합니다. whatap.profile_mysql_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_mysqli_return_enabled Boolean

    기본값 true

    값이 true이면 Mysqli 라이브러리 함수의 결과가 false 일 때 오류로 표기하는 기능을 활성화합니다.

  • whatap.profile_mysqli_error_info_enabled Boolean

    기본값 true

    값이 true이면 Mysqli 라이브러리 함수의 결과값이 false 일 때 에러 메시지 정보 수집하는 기능을 활성화합니다. whatap.profile_mysqli_return_enabled 설정이 false 인 경우는 적용되지 않습니다.

  • whatap.profile_mysqli_error_ignore_empty Boolean

    기본값 true

    값이 false이면 오류 코드 또는 오류 메시지 내용이 없을 때 정상 결과로 표기합니다. whatap.profile_mysqli_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_pdo_return_enabled Boolean

    기본값 true

    값이 true이면 pdo 라이브러리 함수의 결과가 false 일 때 오류로 표기하는 기능을 활성화합니다.

  • whatap.profile_pdo_error_info_enabled Boolean

    기본값 true

    값이 true이면 Mysql 라이브러리 함수의 결과값이 false 일 때 에러 메시지 정보 수집하는 기능을 활성화합니다. whatap.profile_pdo_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_pdo_error_ignore_empty Boolean

    기본값 true

    값이 false이면 오류 코드 또는 오류 메시지 내용이 없을 때 정상 결과로 표기합니다. whatap.profile_pdo_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_pdo_return_enabled Boolean

    기본값 true

    값이 true이면 pdo 라이브러리 함수의 결과가 false 일 때 오류로 표기하는 기능을 활성화합니다.

  • whatap.profile_pgsql_error_info_enabled Boolean

    기본값 true

    값이 true이면 pgsql(Posgressql) 라이브러리 함수의 결과값이 false 일 때 에러 메시지 정보 수집하는 기능을 활성화합니다. whatap.profile_pgsql_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_pgsql_error_ignore_empty Boolean

    기본값 true

    값이 false이면 오류 코드 또는 오류 메시지 내용이 없을 때 정상 결과로 표기합니다. whatap.profile_pgsql_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • wwhatap.profile_oci8_return_enabled Boolean

    기본값 true

    값이 true이면 oci8(Oracle) 라이브러리 함수의 결과가 False 일 때 오류로 표기하는 기능을 활성화합니다.

  • whatap.profile_oci8_error_info_enabled Boolean

    기본값 true

    값이 true이면 Mysql 라이브러리 함수의 결과값이 false 일 때 에러 메시지 정보 수집하는 기능을 활성화합니다. whatap.profile_pdo_return_enabled 설정이 false인 경우는 적용되지 않습니다.

  • whatap.profile_pdo_error_ignore_empty Boolean

    기본값 true

    값이 false이면 오류 코드 또는 오류 메시지 내용이 없을 때 정상 결과로 표기합니다. whatap.profile_pdo_return_enabled 설정이 false인 경우는 적용되지 않습니다.

최종 수정: