7.4.0 업그레이드 참고사항

Zabbix v7.4번역일: 2026-09-09원본 보기

이 참고사항은 Zabbix 7.2.x에서 Zabbix 7.4.0으로 업그레이드하는 경우에 적용됩니다.

모든 참고사항은 다음과 같이 분류됩니다.

호환성을 깨뜨리는 변경 사항 - 기존 설치 환경에 문제를 일으킬 수 있는 변경 사항 및 업그레이드 과정과 관련된 기타 중요 정보
기타 - Zabbix 기능의 변경 사항을 설명하는 나머지 모든 정보

함께 보기:

Zabbix 7.4.0 이전 버전에서 업그레이드하는 데 필요한 모든 관련 정보는 업그레이드 절차를 참조하세요.
HA 클러스터 업그레이드에서 고가용성(HA) 클러스터의 서버를 업그레이드하는 방법을 확인하세요.

업그레이드 과정

MySQL/MariaDB에서 Zabbix 서버 업그레이드를 성공적으로 완료하려면 바이너리 로깅이 활성화되어 있고 슈퍼유저 권한이 없으며 MySQL 구성 파일에 log_bin_trust_function_creators = 1이 설정되어 있지 않은 경우 MySQL에서 GLOBAL log_bin_trust_function_creators = 1을 설정해야 할 수 있습니다.

MySQL 콘솔에서 변수를 설정하려면 다음을 실행합니다.

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

업그레이드가 성공적으로 완료되면 이 옵션을 비활성화할 수 있습니다.

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

호환성을 깨뜨리는 변경 사항

PCRE 라이브러리 지원 중단

PCRE(또는 PCRE1) 라이브러리 지원이 중단되었습니다. 이제 Zabbix는 PCRE2로 컴파일됩니다.

사용자 자신의 미디어 관리

이제 기본적으로 모든 사용자가 자신의 미디어를 관리할 수 있습니다.

사용자가 자신의 미디어 세부 정보를 변경할 수 있는 권한은 사용자 역할에 따라 부여하거나 취소할 수 있습니다(자신의 미디어 생성 및 편집 옵션 참조).

또한 슈퍼 관리자 사용자가 다른 사용자의 미디어 세부 정보를 변경할 수 있는 권한도 사용자 역할에 따라 부여하거나 취소할 수 있습니다(사용자 미디어 생성 및 편집 옵션 참조).

이전 버전에서 업그레이드하는 경우 새 작업에 대한 기본 접근 권한이 활성화된 모든 역할에서 두 옵션이 모두 활성화됩니다. 새 작업에 대한 기본 접근 권한이 활성화되어 있지 않으면 업그레이드 후 관리자와 슈퍼 관리자가 미디어 편집 권한을 잃을 수 있습니다.

히스토리 함수 매개변수의 백슬래시 이스케이프

Zabbix 7.0.0부터 히스토리 함수 문자열 매개변수에 백슬래시를 올바르게 이스케이프하는 기능이 추가되었습니다.

7.0 이전 Zabbix 버전에서 업그레이드하는 동안 백슬래시가 추가되므로 매개변수가 길어집니다. 이로 인해 매개변수 길이가 최대 데이터 크기인 255자를 초과하면 트리거 함수가 손상될 수 있습니다.

이 문제를 방지하려면 업그레이드 전에 긴 매개변수를 사용자 매크로로 직접 옮기는 것이 좋습니다.

7.0 이전 Zabbix 버전에서 업그레이드할 때 변환된 매개변수 길이를 확인하는 추가 검사가 도입되었습니다. 변환된 길이가 최대 크기를 초과하면 해당 매개변수는 업그레이드되지 않으며, 나열된 매개변수를 사용자가 직접 수정하도록 요청하는 경고가 로그에 출력됩니다.

이스케이프 관련 업그레이드 문제도 참조하세요.

MSSQL Zabbix agent 2 플러그인 업데이트

MSSQL by Zabbix agent 2 템플릿이 업데이트되어 검색된 쿼럼 멤버를 이름별로 포함하거나 제외하는 필터와 빈 클러스터를 제외하기 위해 클러스터 이름으로 필터링할 수 있는 서비스 필터가 추가되었습니다. 템플릿이 오류 없이 작동하려면 MSSQL Zabbix agent 2 플러그인을 7.4.0 이상 버전으로 업데이트해야 합니다.

필수 libssh2 최소 버전

필수 libssh2 최소 버전이 1.0.0에서 1.8.0으로 상향되었습니다.

검색된 호스트의 호스트 프로토타입

현재 구성에 다른 호스트 프로토타입이 포함된 템플릿을 사용하는 호스트 프로토타입이 있으면 Zabbix 7.4로 업그레이드할 때 검색된 모든 호스트에 해당 템플릿에 정의된 호스트 프로토타입이 적용됩니다. 이 동작을 원하지 않는 경우 업그레이드하기 전에 관련 템플릿에서 호스트 프로토타입을 직접 삭제하세요.

업그레이드 중 호스트 프로토타입을 받게 될 검색된 호스트를 식별하려면 Zabbix 데이터베이스에서 다음 SQL 쿼리를 실행할 수 있습니다.

SELECT h.hostid,ht.templateid
FROM hosts_templates ht
JOIN hosts h ON ht.hostid=h.hostid
WHERE h.flags=4
  AND EXISTS (
    SELECT NULL
    FROM items i,host_discovery hd
    WHERE i.hostid=ht.templateid
    AND hd.parent_itemid=i.itemid
    )
ORDER BY hostid;

데이터베이스 연결 매개변수

DBPort와 DBSocket은 이제 상호 배타적입니다. 데이터베이스 연결 매개변수를 지정할 때 DBPort 또는 DBSocket 중 하나를 정의하거나, 기본값을 사용하도록 둘 다 정의하지 않을 수 있습니다.

기타

유효한 OID가 없어 지원되지 않는 SNMP 워크/검색 아이템

SNMP 워크 아이템은 OID 또는 OID 인스턴스가 하나도 존재하지 않을 경우 이제 오류를 반환하고 지원되지 않는 상태가 됩니다. 존재하지 않는 OID/인스턴스의 세부 정보는 DebugLevel=5로 로그에 기록됩니다. 이전에는 이러한 경우 빈 문자열을 반환했습니다.

마찬가지로 SNMP 검색 아이템은 OID 또는 OID 인스턴스가 하나도 존재하지 않을 경우 이제 오류를 반환하고 지원되지 않는 상태가 됩니다. 이전에는 이러한 경우 빈 배열을 반환했습니다.

이제 빈 문자열/배열은 OID/인스턴스가 존재하지만 해당 데이터가 없는 경우에만 반환됩니다.

히스토리 캐시 관리

일부 데이터 수집 시나리오에서는 특정 아이템이 서버/프록시 히스토리 캐시를 일시적으로 차단할 수 있습니다. 이로 인해 히스토리 데이터를 데이터베이스에 기록하는 작업이 지연되고 시스템 속도가 느려질 수 있습니다. 히스토리 캐시를 관리하는 데 도움이 되도록 다음 개선 사항이 도입되었습니다.

수동 캐시 지우기: Zabbix 서버/프록시의 새로운 history_cache_clear=target 런타임 명령을 사용하면 특정 아이템의 ID를 이용해 해당 아이템의 히스토리 캐시를 직접 지울 수 있습니다.
자동 캐시 지우기: 아이템을 비활성화하면 히스토리 캐시에서 즉시 제거됩니다(로그를 위해 유지되는 마지막 값은 제외). 마찬가지로 호스트를 비활성화하면 해당 호스트의 모든 아이템이 히스토리 캐시에서 제거됩니다(마지막 값은 제외).
캐시 진단 로깅: 히스토리 캐시가 가득 차면 이제 Zabbix 서버/프록시는 DebugLevel=3부터 히스토리 캐시 진단 정보를 로그에 기록합니다(이전에는 DebugLevel=4). 로그에는 히스토리 캐시에 값이 가장 많은 아이템이 포함됩니다.

장기적인 시스템 안정성을 위해 데이터 수집이 사용 가능한 리소스(데이터베이스 성능, 캐시 크기, 수집 간격, 로그 아이템 매개변수 등)와 균형을 이루는지 확인하세요. zabbix[wcache] 내부 아이템을 사용하여 Zabbix 히스토리 캐시를 모니터링할 수 있습니다. Zabbix 서버/프록시의 히스토리 캐시 크기를 늘리는 방법도 고려할 수 있습니다.

사용자 미디어의 가시성을 높이기 위해 이제 사용자 알림은 별도의 메뉴 섹션으로 사용자 설정 아래에 제공됩니다.

새로운 알림 섹션에는 이전에 사용자 프로필 섹션에 있던 미디어와 프론트엔드 알림이라는 두 개의 탭이 있습니다.

맵에서 중첩된 호스트 그룹의 정보가 올바르게 표시됨

이제 맵에서 중첩된 호스트 그룹의 정보가 올바르게 표시됩니다. 예를 들면 다음과 같습니다.

이제 호스트 그룹 레이블에 중첩된 호스트 그룹의 모든 호스트에 대한 문제 요약이 표시됩니다.
이제 "호스트 그룹 요소" 보기에서 중첩된 호스트 그룹의 각 호스트가 별도의 맵 요소로 표시됩니다.
이제 맵 레이블에 중첩된 호스트 그룹에 포함된 모든 문제의 요약이 표시됩니다.

설정용 데이터베이스 테이블 변환

이제 settings 테이블이 config 테이블을 대체하여 전역 구성 매개변수를 저장합니다. 새 테이블은 매개변수마다 열을 두어 단일 행에 저장하는 대신 키-값 형식을 사용합니다. 이 변경이 데이터 교환에 미치는 영향의 예는 서버-프록시 데이터 교환 프로토콜("settings" 객체)을 참조하세요.

서버 및 프록시의 최대 캐시 크기 증가

캐시 고갈을 늦추고 일시적인 문제(예: 구성, 데이터베이스 또는 네트워크 문제)가 발생해도 작동을 유지할 수 있도록 최대 캐시 크기가 2 GB에서 16 GB로 상향되었습니다.

서버: HistoryCacheSize, HistoryIndexCacheSize, TrendCacheSize의 최댓값이 증가했습니다.
프록시: HistoryCacheSize와 HistoryIndexCacheSize의 최댓값이 증가했습니다.

기본 사용자 세션 보관 기간 단축

사용자 세션 데이터의 기본 보관 기간이 365일에서 31일로 단축되었습니다. 이 변경은 hk_sessions 매개변수에 영향을 주며, 이제 기본값이 365d 대신 31d입니다.

지원되는 최소 Go 버전

지원되는 최소 Go 버전이 1.21에서 1.23으로 상향되었습니다.

이전에 1.23보다 오래된 Go 버전을 사용하여 소스에서 Zabbix agent 2, agent 2 로드 가능 플러그인 또는 웹 서비스를 빌드했다면 최신 보안 업데이트와 버그 수정을 적용할 수 있도록 지원되는 Go 버전을 사용하여 이러한 구성 요소를 다시 빌드하는 것이 좋습니다. 이전 Go 버전으로 빌드한 구성 요소는 계속 작동하지만, 이를 업그레이드하려면 더 최신 Go 환경이 필요합니다.

Host Wizard용 템플릿 업그레이드

새로운 Host Wizard는 Zabbix에서 모니터링 대상(장치, 애플리케이션, 서비스 등)을 설정하기 위한 단계별 안내 인터페이스를 제공합니다. 템플릿 선택, Zabbix agent 설치, 호스트 인터페이스 추가 등의 주요 단계를 안내하여 새 호스트 또는 기존 호스트의 구성을 간소화합니다.

이전 Zabbix 버전에서 업그레이드한 후에는 Host Wizard와 함께 작동하도록 템플릿을 업그레이드해야 합니다. 지침은 템플릿 업그레이드를 참조하세요.

SNMPv1 및 SNMPv2 검사 동시 처리

이제 사용 가능한 검색 워커가 SNMPv1 및 SNMPv2 비동기 서비스 검사를 동시에 처리합니다.