릴리즈 노트

최신 버전: v0.2.7

2025-09-02

v0.2.7

Feature Span 데이터 순차 처리 옵션 추가

Trace 데이터의 scopespan 처리 시 Span.Kind = KIND_SERVER는 와탭 트랜잭션으로 처리
기존: 하나의 request에 여러 KIND_SERVER span을 모아 마지막에 처리
옵션 설정 시 Span을 순차적으로 처리

otel_tx_process_server_span_in_order_enabled
기본값: false

2025-09-01

v0.2.6

Change Span 데이터 처리 방식 개선

부모·자식 트리 구조로 Span 데이터를 수집
중간에 부모 Span 데이터가 없어도 이후 자식 Span 데이터를 처리하도록 변경

Change 속성 키 이름 추가

HTTP 상태 코드를 수집하는 속성 키 이름 http.response.status_code를 추가
- otel_attr_tx_status_keys
  - 기본값: http.status_code, http.response.status_code
에러 정보를 수집하는 속성 키 이름 error 를 추가
- otel_attr_error_keys
  - 기본값: error, error.type

2025-07-09

v0.2.5

Feature Parent 없는 Span을 트랜잭션으로 인식

Parent가 없는 Span은 kind에 관계없이 트랜잭션으로 처리
기존에는 SPAN_KIND_SERVER만 트랜잭션으로 처리
관련 옵션: otel_tx_root_span_enabled (기본값: true)

Feature 메트릭스 수집 방식 개선

기존 로그 기반 수집에서 프로메테우스 호환 방식으로 변경
Flex 보드(MXQL 데이터 조회)로 확인 가능

Change query_string_enabled 옵션 동작 방식 변경

query_string_enabled가 true이고 query_string_urls, query_string_keys가 설정되지 않은 경우
모든 URL의 query string 수집

Fixed HTTP Status 카운터 수집 오류 수정

500번대 에러의 합산 값이 수집되지 않던 문제 수정

2025-04-30

v0.2.4

Feature HTTP Status 오류 표시

HTTP Status code가 400 이상일 경우 오류로 표기하는 설정
- Key: transaction_status_error_enable
- Type: bool
- Default: false
- 수집 주기: 10초

Feature HTTP Status Code 통계 수집

전체 URL의 Status Code별 건수 수집을 위한 설정
- Key: tx_status_meter_enabled
- Type: bool
- Default: true
- 수집 주기: 10초
URL별 Status Code 건수 수집을 위한 설정
- Key: stat_txstatus_enabled
- Type: bool
- Default: true
- 수집 주기: 5분

Feature 분산 추적용 HTTP call 가상 span 정보를 설정해 분석 추적

HTTP call span 정보가 없을 때 가상 span 활성화
- Key: otel_virtual_httpc_enabled
- Type: bool
- Default: false
HTTP call span 정보가 없을 때 이름 설정
- Key: otel_virtual_httpc_name
- Type: string
- Default: external http call

Feature Gateway 정보 수집

게이트웨이 정보 수집 활성화
- Key: otel_gateway_enabled
- Type: bool
- Default: false
- 수집 항목 및 주기
  - 전체 URL 단위 트랜잭션·게이트웨이·API 호출 경과 시간 수집 주기: 10초
  - URL·Status별 트랜잭션·게이트웨이·API 호출 경과 시간 수집 주기: 5분
지정된 속성(attribute)의 값으로 게이트웨이 경과 시간을 설정
- Key: otel_attr_tx_gw_time_keys
- Type: string
- Default: duration.kong
지정된 속성(attribute)의 값으로 API 호출 경과 시간을 설정
- Key: otel_attr_tx_api_time_keys
- Type: string
- Default: duration.proxy
지정된 속성(attribute)의 값으로 응답시간을 설정
- Key: otel_replace_tx_resp_time_enabled
- Type: bool
- Default: false
- Key: otel_attr_replace_tx_resp_time_keys
- Type: string
- Default: duration.kong

Fixed HTTP Method 무시 설정 오류를 수정

PATCH, OPTIONS, HEAD, TRACE 메소드는 트랜잭션으로 수집하지 않음

2025-02-25

v0.2.3

Feature Span의 name 값을 트랜잭션 이름으로 지정하는 옵션 추가

otel_tx_path_setby_name_enabled bool (기본값 false)

Feature Trace Span의 SpanID를 외부 연결의 ParentSpanID로 인식하는 멀티 트랜잭션 연결 관련 옵션 추가

otel_mtrace_stepid_setby_trace_spanid_enabled bool (기본값 false)

Feature 파일 로그와 동일한 내용을 Stdout으로 출력하는 로그 옵션 추가

log_stdout_enabled bool (기본값 false)

Fixed whatap.conf 파일이 없을 경우 파일 없음 오류 로그가 계속 출력되는 현상 수정

Fixed 트랜잭션 ID가 0으로 표기되는 현상 수정

2024-12-11

v0.2.2

Feature 트랜잭션 URL과 URI 정보를 분리해서 처리

기존 URL로 표기되는 부분은 URI로 표기합니다.

Feature 외부 HTTP 호출의 URL 표기가 "Host:Port"로 수정

Feature Kong gateway 관련하여 정보를 추출할 속성의 키 값을 기본 설정에 추가

2024-11-06

v0.2.1

Fixed 내부에서 예기치 못한 panic 발생으로 인해 데이터 처리 goroutine이 중지되는 현상 수정

Fixed 불필요한 로그 제거 및 정리

2024-06-19

v0.2.0

New linux aarch64 지원

New span events에서 에러 정보 추가 수집

에러 내용이 attribute가 아닌 event로 유입되는 경우를 위해 수집합니다.

event에서 에러를 찾기 위한 에이전트 설정 옵션을 추가하세요.

whatap.conf
otel_events_exception_keys=exception.type
otel_events_error_message_keys=exception.message
otel_events_error_stack_keys=exception.stacktrace
otel_events_error_esc_keys=exception.escaped

Changed 기존 paramkey.txt 대신 security.conf 파일 사용

기존 security.conf 파일의 paramkey 키의 값을 사용합니다. 기본값은 무작위값이 아닌 WHATAP으로 지정도록 변경합니다. WHATAP 지정되면 키 입력없이 복호화할 수 있습니다.

Changed SQL 문장의 정규화 옵션 설정 변경

SQL 문장에서 파라미터를 분리하여 정규화하는 기능을 항상 활성화하세요. trace_sql_normalize_enabled 옵션을 항상 true로 설정하세요.
이미 정규화 옵션을 비활성화(정규화 중지 설정)한 상태라면, 정규화해서 파라미터를 별도 표기하는 설정을 활성화하세요.
- profile_sql_param_enabled 옵션을 true로 설정하세요.
- 정규화된 파라미터를 별도 암호화하여 수집합니다.
- security.conf의 paramkey로 복호화하여 데이터를 확인할 수 있습니다.

최신 버전: v0.2.7​