본문으로 건너뛰기

에이전트 기능 제어

PHP 애플리케이션 서버의 기능을 제어할 수 있습니다.

  • whatap.stat_enabled Boolean

    기본값 true

    통계 정보 추적 기능을 활성화합니다. 5분 단위로 수집되는 트랜잭션, SQL, HTTPCALL, UserAgent, Client IP 등의 통계 데이터 등이 해당됩니다.

  • whatap.stat_ipurl_enabled Boolean

    기본값 false

    프로젝트 사이드 메뉴 중 통계 > IP 트랜잭션 통계 수집 여부를 설정합니다.

    노트

    다음 문서를 참조하세요.

  • whatap.license String

    에이전트를 설치할 때 서버로부터 부여받은 액세스 키를 설정합니다. 액세스 키에는 에이전트가 속한 프로젝트와 보안 통신을 위한 암호 키를 포함하고 있습니다.

  • whatap.realtime_user_thinktime_max Milliseconds

    기본값 300000

    실시간 사용자를 측정할 때 동일 사용자로 인정되는 최대 호출 간격을 지정합니다.

  • whatap.time_sync_interval_ms Milliseconds

    기본값 300000

    에이전트와 서버 간 시간 동기화 주기를 지정합니다. 동기화하지 않을 경우 0으로 지정합니다.

  • whatap.text_reset Int

    기본값 0

    와탭 에이전트는 한번 보낸 텍스트 유형 데이터는 hash 처리되므로 다음날까지 다시 전송하지 않습니다. 이전 설정값과 다른 값을 설정하는 경우 다시 전송합니다.

    노트

    트랜잭션 URL, SQL String 등이 텍스트 유형 데이터에 해당합니다.

  • whatap.ext.error_enabled Boolean

    기본값 true

    PHP 확장 모듈(PHP Extension module)에서 오류(Error) 정보를 수집하는 기능을 활성화 합니다. PHP 컴파일 설치로 php.ini에 whatap 항목이 있으면 whatap.ini가 아닌 php.ini에 추가하세요.

노트

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

  • whatap.ext.exception_enabled Boolean

    기본값 true

    PHP 확장 모듈(PHP Extension module)에서 예외 처리(Exception) 정보를 수집하는 기능을 활성화합니다. PHP 컴파일 설치로 php.ini에 whatap 항목이 있으면 whatap.ini가 아닌 php.ini에 추가하세요.

노트

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

  • whatap.debug_gc_percent Int

    기본값 200

    whatap-php 서비스 데몬의 gc 호출 간격을 늘려서 CPU 부하를 줄일 수 있습니다. CPU 부하가 줄어드는 대신 메모리 사용량이 늘어납니다. 최대 1000까지 적용됩니다.

  • whatap.use_env_first Boolean PHP agent v2.8.2 or later

    기본값 false

    에이전트 설정의 우선순위는 whatap.ini 파일이 먼저 적용되고, 그다음으로 환경 변수가 적용됩니다. 환경 변수를 우선적으로 적용하려면 옵션값을 true로 설정하세요. 또는 WHATAP_USE_ENV_FIRST=true 형식으로 환경 변수를 설정할 수도 있습니다.

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

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

  • whatap.trace_login_enabled Boolean PHP agent v2.14.1 or later

    기본값 false

    요청에서 로그인 아이디를 수집하는 기능을 활성화합니다. GET/POST 파라미터 또는 Session 객체에서 로그인 아이디를 추출하며, 수집한 값은 로그인별 트랜잭션 통계와 연계됩니다. 즉, 본 옵션을 활성화하면 트랜잭션을 로그인 사용자 단위로 구분해 분석할 수 있습니다.

    노트

    로그인별 통계는 whatap.stat_login_enabled 옵션을 함께 활성화해야 수집됩니다.

  • whatap.trace_login_param_key String PHP agent v2.14.1 or later

    로그인 아이디를 추출할 GET/POST 파라미터의 키 이름을 지정합니다. 같은 키가 GET과 POST에 모두 존재하면 POST 값을 우선 적용합니다.

  • whatap.trace_login_session_key String PHP agent v2.14.1 or later

    로그인 아이디를 추출할 Session 객체의 경로를 지정합니다. 중첩된 Session 구조는 점(.)으로 구분해 표기합니다. 예를 들어 $_SESSION['auth']['user_id'] 값을 수집하려면 auth.user_id로 지정합니다.

    노트

    whatap.trace_login_param_key와 whatap.trace_login_session_key의 적용 우선순위는 (개발팀 컨펌 필요) 입니다. 두 옵션을 동시에 지정한 경우 어느 출처를 우선하는지 확인이 필요합니다.

최종 수정: