OpenTelemetry Collector 0.165.0 업그레이드 전 설정과 메모리 방어 점검
OpenTelemetry Collector 0.165.0 업그레이드에 앞서 confighttp 필드 제거의 영향과 입력 방어 수정, 배치 중복 경고의 확인 범위를 점검한다.
2026-11-17
수신 크기 제한이 적용되는 지점부터 확인한다
작은 zstd 메시지도 압축 해제 결과를 만들기 전에 큰 메모리 할당을 유발할 수 있었다. 프레임 헤더가 디코더 윈도를 선언하고, 디코더는 출력 데이터를 생성하기 전에 그 윈도를 할당했기 때문이다. 수신 메시지나 요청 본문의 크기를 제한해도 이 할당은 별도로 발생할 수 있었다.
점검 기준은 **OpenTelemetry Collector v0.165.0 (2026-11-06)**이다. 공식 릴리스노트는 이 버전에서 gRPC와 HTTP의 zstd 디코더 윈도를 각각 설정된 수신 크기 상한으로 제한한다고 명시한다.
운영자가 확인할 대상은 실제 사용하는 수신 경로의 설정이다. gRPC는 max_recv_msg_size_mib, HTTP는 max_request_body_size가 이번 수정과 연결된다. 두 경로를 모두 사용한다면 한쪽 설정을 확인한 것으로 점검을 끝내지 않는다.
아래 그림은 zstd 헤더가 메모리 할당에 영향을 주는 지점과, 프로토콜별로 그 할당을 제한하는 설정의 관계를 보여 준다.
릴리스노트에는 gRPC가 메시지 처리를 마치는 즉시 디코더를 풀로 반환한다는 변경도 포함돼 있다. 윈도 크기 제한과 디코더 반환 시점은 함께 바뀌었지만, 운영 설정으로 확인할 직접적인 연결점은 각 수신 경로의 크기 상한이다.
이 수정으로 Collector 전체의 메모리 사용량에 상한이 생겼다고 해석해서는 안 된다. 자료가 설명하는 범위는 zstd 디코더 윈도 할당의 제한이다. 업그레이드 검토에서도 이 범위를 구분해야 수정의 효과를 과장하지 않고 확인할 수 있다.
confighttp 필드 제거는 사용 코드를 기준으로 점검한다
이번 릴리스의 breaking change는 pkg/confighttp에서 폐기 예정이던 필드를 제거한 것이다. 이 패키지를 사용하는 코드가 있다면 다음 식별자를 검색해 영향을 확인한다.
| 제거된 필드 | 확인 대상 | 업그레이드 전 처리 |
|---|---|---|
IdleConnTimeout |
해당 필드를 참조하거나 지정하는 코드 | 새 버전 API에 맞게 수정 |
MaxIdleConns |
해당 필드를 참조하거나 지정하는 코드 | 새 버전 API에 맞게 수정 |
MaxIdleConnsPerHost |
해당 필드를 참조하거나 지정하는 코드 | 새 버전 API에 맞게 수정 |
DisableKeepAlives |
해당 필드를 참조하거나 지정하는 코드 | 새 버전 API에 맞게 수정 |
여기서 점검 단위는 릴리스노트가 지목한 패키지 필드다. 이를 그대로 YAML 설정 키의 삭제 목록으로 옮기면 근거의 범위를 벗어난다. 자체 구성요소나 Collector 연동 코드에서 confighttp를 직접 사용한다면, 필드 참조를 확인하고 변경한 뒤 빌드로 검증한다.
같은 릴리스에서 pkg/confighttp는 stable로 표시됐다. 그러나 안정성 단계의 변경이 제거된 필드를 계속 사용할 수 있다는 뜻은 아니다. 업그레이드 판단에서는 stable 표기와 실제 API 변경 목록을 따로 읽어야 한다.
제공된 자료에는 제거된 필드의 대체 경로가 설명돼 있지 않다. 따라서 이름이 비슷한 다른 설정으로 일괄 치환하기보다, 먼저 실제 참조 위치와 영향을 확정하는 데 점검을 집중한다.
중첩 페이로드 방어는 크기 제한과 따로 검증한다
pkg/pdata에는 proto 언마샬링의 재귀 깊이를 100으로 제한하는 수정이 들어갔다. 적용 대상은 AnyValue, ArrayValue, KeyValueList, KeyValue이며, 악의적으로 깊게 중첩된 페이로드가 일으키는 스택 오버플로를 방어하기 위한 변경이다.
zstd 수정과 이 수정은 모두 입력 처리 방어지만, 다루는 문제가 다르다. 앞의 수정은 디코더 윈도 할당을 제한한다. 이 수정은 중첩된 값을 해석하면서 재귀가 깊어지는 문제를 제한한다. 압축 입력만 확인하면 중첩 구조에 대한 변경을 놓칠 수 있다.
다음 비교는 입력 방어를 검증할 때 메모리 할당과 재귀 깊이를 서로 다른 확인 대상으로 나눠야 하는 이유를 보여 준다.
업그레이드 검증 항목에도 이 차이를 반영한다. 압축된 수신 입력에 대한 확인과, 해당 타입을 사용하는 중첩 페이로드에 대한 확인을 구분해 기록한다. 자체 입력 검증 사례가 있다면 이번 수정이 다루는 구조를 포함하는지 살핀다.
다만 릴리스노트는 깊이 제한에 걸렸을 때 반환되는 오류 문자열이나 응답 코드를 설명하지 않는다. 검증 기대값에 특정 문구나 코드를 임의로 넣지 않고, 자료가 보장하는 제한과 방어 목적을 기준으로 삼는다.
배치 병용 경고가 없더라도 연결 구조를 읽는다
pkg/service는 파이프라인에서 batch 프로세서와 exporterhelper 배치를 함께 사용하면 시작 시 경고하도록 바뀌었다. 업그레이드 후 시작 로그에서 이 경고를 확인하고, 발견되면 해당 파이프라인에서 배치를 어디에 맡길지 검토한다.
경고의 탐지 범위에는 명시적인 한계가 있다.
- 탐지는 커넥터를 넘어가지 않는다.
- exporterhelper의 배치 기능을 숨기는 exporter 래퍼 내부는 검사하지 않는다.
따라서 경고가 없다는 사실만으로 배치 병용이 없다고 판단할 수는 없다. 커넥터를 포함한 구성이거나 exporter 래퍼를 사용하는 구성이라면, 시작 로그와 함께 실제 연결 구조를 확인해야 한다.
| 구성에서 보이는 요소 | 릴리스노트가 밝힌 탐지 범위 | 운영자가 확인할 것 |
|---|---|---|
| 파이프라인의 batch 프로세서와 exporterhelper 배치 | 병용 시 시작 경고 | 경고가 가리키는 배치 구성 |
| 커넥터를 통한 연결 | 커넥터를 넘어 탐지하지 않음 | 연결된 파이프라인의 배치 배치 위치 |
| 배치 기능을 숨기는 exporter 래퍼 | 래퍼 내부를 검사하지 않음 | 래퍼가 감싼 exporter의 배치 기능 |
경고를 발견했다고 batch 프로세서를 바로 삭제하는 것도 성급하다. 이번 자료는 병용을 알리는 기능을 설명할 뿐, 모든 파이프라인에 적용할 단일 배치 구성을 제시하지 않는다. 먼저 현재 구성에서 처리 책임이 겹치는 지점을 확인하고 변경 대상을 정한다.
queue_batch는 사용하는 신호의 안정성 단계를 확인한다
queue_batch 프로세서는 traces, metrics, logs에서 beta로 승격됐고, profiles에서는 alpha로 승격됐다. 같은 프로세서라도 사용하는 신호에 따라 안정성 단계가 다르므로 도입 검토 문서에 이를 구분해 적는다.
| 신호 | v0.165.0의 안정성 단계 | 도입 검토 시 확인점 |
|---|---|---|
| traces | beta | traces 경로의 사용 여부 |
| metrics | beta | metrics 경로의 사용 여부 |
| logs | beta | logs 경로의 사용 여부 |
| profiles | alpha | profiles 경로의 사용 여부와 alpha 단계 |
이 릴리스에서는 queue_batch의 큐와 배치 메트릭을 프로세서 메트릭으로 보고하는 변경도 포함됐다. 이를 사용하는 환경이라면 관련 메트릭을 확인하는 대시보드와 조회가 이번 변경을 반영하는지 검토할 대상이다. 제공된 자료에는 구체적인 메트릭 이름이 없으므로 이름을 추정해 조회식을 만들지는 않는다.
아래 그림은 프로세서 이름만 보고 안정성 단계를 판단하지 않도록, 신호별 분기를 보여 준다.
queue_batch의 승격과 배치 병용 경고는 별개로 판단해야 한다. 전자는 해당 프로세서의 신호별 안정성 단계에 관한 변경이고, 후자는 batch 프로세서와 exporterhelper 배치가 함께 있는 구성을 알리는 변경이다. 승격 소식만으로 기존 배치 구성을 일괄 교체할 근거는 없다.
메모리 제어와 큐 취소의 운영 기대값을 맞춘다
memory_limiter에는 강제 가비지 컬렉션을 비활성화할 수 있는 garbage_collector 설정 절이 추가됐다. 제어 필드는 enabled다. 이 옵션을 검토할 때는 앞서 다룬 zstd 윈도 제한, pdata 재귀 깊이 제한과 역할을 구분한다. 여기서 제어하는 대상은 강제 가비지 컬렉션의 활성 여부다.
자료에는 이 옵션을 바꿨을 때의 메모리 사용량이나 지연 시간 수치가 없다. 따라서 성능 개선을 전제로 변경하지 않고, 강제 가비지 컬렉션을 끄려는 운영 요구가 있는지부터 확인한다.
exporterhelper에서 wait_for_result를 사용하는 경로는 취소 처리의 기대값도 점검해야 한다. 이전에는 sending queue가 이미 요청을 수락했는데도 컨텍스트가 취소되면 context.Canceled를 반환하며 먼저 종료할 수 있었다. 요청은 계속 전달됐기 때문에 호출자가 이미 전송된 데이터를 실패로 보고할 여지가 있었다.
이번 버전에서는 큐가 이미 수락한 요청에 대해 취소가 조기 반환을 일으키지 않는다. 아직 요청에 대한 처리가 이뤄지지 않은 동안에는 취소가 계속 적용된다. 자체 호출 코드나 검증 사례가 있다면, 취소가 발생했다는 사실과 데이터 전달 결과를 같은 것으로 취급하는지 확인한다.
업그레이드 완료의 근거는 버전 문자열만으로 채우지 않는다. 제거된 필드의 참조를 확인한 결과, 수신 경로별 크기 설정, 중첩 페이로드 검증, 시작 경고와 연결 구조 점검 결과를 함께 남긴다. wait_for_result를 사용하는 환경에서는 취소 처리에 대한 기대값까지 맞춰야 이번 릴리스의 변경을 운영 동작에 반영했다고 판단할 수 있다.