CNCF graduated·incubating 프로젝트 릴리스 노트의 AI 분석.
이번 릴리스에는 익스포터 큐 일괄 처리 기능 게이트와 익스포터·스크레이퍼 메트릭 동작 변경이 포함됩니다. 공개 API의 필드 형태가 바뀌는 호환성 변경도 있으며, 보안 권고나 보안 수정 사항은 공개되지 않았습니다.
영향 확인 (2)
breakingconfighttp. 필드 명명 방식 변경
이 변경은 extension/zpages를 사용하는 경우에 적용됩니다.
extension/zpages의 Config에서 confighttp.가 임베디드 필드 대신 이름이 지정된 필드가 됩니다. (#15308)
breakingconfigauth. 필드 명명 방식 변경
이 변경은 configauth.를 사용하는 경우에 적용됩니다.
pkg/confighttp의 AuthConfig에서 configauth.가 임베디드 필드 대신 이름이 지정된 필드가 됩니다. (#15308)
이번 릴리스는 설정 관련 API를 정리하는 변경을 담고 있습니다. 기존 pkg/xconfmap 기호를 사용하는 구성은 confmap의 동등한 기호를 사용하도록 조정하는 내용입니다.
영향 확인 (1)
breakingpkg/xconfmap의 Validator와 Validate 제거
pkg/xconfmap의 Validator 또는 Validate 기호를 사용하는 경우에 적용됩니다.
pkg/xconfmap에서 Validator와 Validate를 제거했습니다. 대신 confmap의 동등한 기호를 사용합니다.
히스토그램 버킷 값이 조정되고 구성 기능과 기능 게이트가 추가됐으며, 여러 결함이 수정됐습니다. API 기호 일부가 제거 또는 사용 중단 지정되고 configstorage 모듈이 추가됐으며, 보안 문제나 권고문은 확인되지 않았습니다.
영향 확인 (1)
breakingBalancerName 함수 제거
BalancerName을 사용하는 경우에 적용됩니다.
BalancerName 함수가 제거되고, 대신 DefaultBalancerName 상수를 사용하도록 바뀌었습니다.
미리 준비 (1)
deprecatedWithForceUnmarshaler 옵션 사용 중단 지정
WithForceUnmarshaler를 사용하는 경우에 적용됩니다.
WithForceUnmarshaler 옵션이 사용 중단 권고 대상으로 지정됐습니다. 대신 confmap.를 사용합니다.
안정화된 기능 게이트 제거와 프로세서 메트릭 이름 변경이 포함됩니다. 도구와 API 기능이 추가·변경되고 생성기 결함이 수정되며, 서비스 설정 API 두 개가 사용 중단 예정으로 전환됩니다.
영향 확인 (9)
breakingconfighttp. 기능 게이트 제거
confightp.를 사용하는 경우에 해당합니다.
confighttp. 안정화 기능 게이트가 제거됩니다.
breakingconfigoptional. 기능 게이트 제거
configoptional.를 사용하는 경우에 해당합니다.
configoptional. 안정화 기능 게이트가 제거됩니다.
breakingconfmap. 기능 게이트 제거
confmap.를 사용하는 경우에 해당합니다.
confmap. 안정화 기능 게이트가 제거됩니다.
미리 준비 (1)
deprecated서비스 설정 API 사용 중단 예정 지정
service. 또는 extensioncapabilities.를 사용하는 경우에 해당합니다.
service.와 extensioncapabilities.가 사용 중단 예정으로 지정됩니다. 대신 유효 설정과 확장 전 설정을 나타내는 service.과 extensioncapabilities.가 사용됩니다.
설정 생성과 메타데이터 검증의 기본 동작이 바뀌어 운영자나 컴포넌트 작성자의 설정 변경이 필요할 수 있습니다. API와 기능 게이트의 성숙도 및 기능이 조정되었고, Snappy에서 발생하던 메모리 손상과 오류도 수정되었습니다.
영향 확인 (3)
breakingpdata. 기능 게이트 제거
pdata.을 사용하는 경우 적용됩니다.
pdata. 기능 게이트를 제거했습니다.
breakingreaggregation 설정 생성 기본 활성화
cmd/mdatagen을 실행하는 경우 적용됩니다.
cmd/mdatagen에서 reaggregation 설정 생성을 기본으로 활성화합니다. reaggregation_enabled: false로 설정하면 enabled 필드만 포함한 메트릭 설정을 계속 생성합니다.
breakingfeature_gates 메타데이터 검증 강화
metadata.에서 feature_gates를 설정하는 경우 적용됩니다.
metadata.의 feature_gates 검증을 기본적으로 더 엄격하게 적용합니다. 게이트 항목에 skip_strict_validation: true를 설정하면 해당 게이트에 한해 엄격한 검증을 건너뜁니다.
이번 릴리스는 exporter의 진행 중 요청 메트릭과 구성 검증 API를 추가하고, 런타임 및 구성 관련 결함을 수정합니다. 명시적으로 설정한 Prometheus telemetry의 기본 동작이 바뀌고, 큰 snappy 요청에 대한 적용 범위가 좁아졌으며 검증 API의 사용 중단이 시작됩니다.
영향 확인 (2)
breakingsnappy 요청의 본문 크기 제한 적용 시점 수정
max_request_body_size를 설정한 경우에 적용됩니다.
Content-Encoding: snappy 요청에서 압축 해제 버퍼를 할당하기 전에 max_request_body_size 제한을 적용합니다.
breaking명시적으로 설정한 Prometheus 메트릭 기본값 수정
telemetry 메트릭 섹션을 설정한 경우에 적용됩니다.
telemetry 메트릭 섹션을 명시적으로 설정해도 Prometheus exporter의 WithoutScopeInfo, WithoutUnits, WithoutTypeSuffix 기본값이 true로 적용됩니다. 구성 역직렬화 과정에서 암묵적 기본 구성과 같은 기본값을 사용합니다.
미리 준비 (1)
deprecated구성 검증 API 사용 중단 처리
xconfmap. 또는 confmap.를 사용하는 경우에 적용됩니다.
xconfmap.와 confmap.가 deprecated 처리되고, confmap.와 confmap.가 대체 API로 지정됩니다.
이번 릴리스에는 기본값 변경, API 및 구성 계약 변경, 새 기능, 사용 중단 지정, 버그 수정이 포함됩니다. 보안 권고나 보안 관련 수정 사항은 공개되지 않았습니다.
영향 확인 (2)
breaking생성된 Collector 소스의 replace 경로 기본값 변경
생성된 Collector 소스를 사용하는 경우 적용됩니다.
생성된 Collector 소스의 모듈에서 replace 문이 기본적으로 상대 경로를 사용합니다.
breakingConfig. 필드 구조 변경
Config.를 사용하는 경우 적용됩니다.
Config.가 익명 임베디드 필드에서 이름이 지정된 필드로 변경되었습니다.
미리 준비 (1)
deprecatedDefaultMetricsBuilderConfig 함수 사용 중단
DefaultMetricsBuilderConfig를 사용하는 경우 적용됩니다.
DefaultMetricsBuilderConfig 함수가 사용 중단되었으며, 대신 NewDefaultMetricsBuilderConfig를 사용하도록 변경되었습니다.
