문서

1 일반

개요

관리 > 일반 섹션에는 프론트엔드 관련 기본값 설정과 Zabbix 커스터마이징을 위한 여러 하위 섹션이 포함되어 있습니다.

사용 가능한 하위 섹션 목록은 관리 메뉴 섹션에서 일반을 클릭하면 표시됩니다. 왼쪽 상단 모서리의 제목 드롭다운을 사용하여 하위 섹션 간 전환도 가능합니다.

GUI

이 섹션은 여러 프론트엔드 관련 기본값의 사용자 정의를 제공합니다.

구성 매개변수:

매개변수	설명
기본 언어	프로필에 언어를 지정하지 않은 사용자와 게스트 사용자를 위한 기본 언어입니다. 자세한 정보는 추가 프론트엔드 언어 설치를 참조하세요.
기본 시간대	프로필에 시간대를 지정하지 않은 사용자와 게스트 사용자를 위한 기본 시간대입니다.
기본 테마	프로필에 테마를 지정하지 않은 사용자와 게스트 사용자를 위한 기본 테마입니다.
검색 및 필터 결과 제한	웹 인터페이스 목록(예: 데이터 수집 > 호스트)에 표시될 최대 요소(행) 수입니다. 참고: 예를 들어 '50'으로 설정하면 영향을 받는 모든 프론트엔드 목록에서 첫 50개 요소만 표시됩니다. 목록에 50개 이상의 요소가 포함되어 있다면, "발견된 50+* 중 1부터 50까지 표시 중"*에서 '+' 기호로 이를 나타냅니다. 또한 필터링을 사용해도 여전히 50개 이상의 일치 항목이 있으면 처음 50개만 표시됩니다. 이 매개변수 값을 증가시키면 웹 서버 측에서 성능 저하 및 메모리 소비 증가로 이어질 수 있습니다.
개요 테이블의 최대 열과 행 수	데이터 개요 및 트리거 개요 대시보드 위젯에 표시할 최대 열과 행 수입니다. 동일한 제한이 열과 행 모두에 적용됩니다. 표시된 것보다 많은 행 및/또는 열이 존재하는 경우, 시스템은 테이블 하단에 경고를 표시합니다: "모든 결과가 표시되지 않았습니다. 더 구체적인 검색 기준을 제공해주세요."
테이블 셀 내에 표시할 최대 요소 수	단일 테이블 셀에 표시되는 항목의 경우, 여기서 구성된 수를 초과하여 표시되지 않습니다.
Zabbix 서버가 다운된 경우 경고 표시	이 매개변수는 Zabbix 서버에 연결할 수 없는 경우(다운되었을 가능성) 브라우저 창에 경고 메시지를 표시하도록 합니다. 메시지는 사용자가 페이지를 스크롤해도 계속 표시됩니다. 마우스를 올리면 메시지가 일시적으로 숨겨져서 아래 내용을 볼 수 있습니다.
근무 시간	이 시스템 전체 매개변수는 근무 시간을 정의합니다. 그래프에서 근무 시간은 흰색 배경으로, 비근무 시간은 회색으로 표시됩니다. 시간 형식에 대한 설명은 시간 기간 지정 페이지를 참조하세요. 사용자 매크로가 지원됩니다.
기술적 오류 표시	체크된 경우, 모든 등록된 사용자가 기술적 오류(PHP/SQL)를 볼 수 있습니다. 체크되지 않은 경우, 해당 정보는 Zabbix 슈퍼 관리자와 디버그 모드가 활성화된 사용자 그룹에 속한 사용자만 볼 수 있습니다.
최대 히스토리 표시 기간	모니터링 > 최신 데이터, 모니터링 > 호스트의 호스트 웹 시나리오 정보, 그리고 데이터 개요 대시보드 위젯에서 히스토리 데이터를 표시할 최대 시간 기간입니다. 허용 범위: 24시간(기본값) - 1주일. 시간 접미사(예: 1w(1주일), 36h(36시간))가 지원됩니다.
시간 필터 기본 기간	그래프와 대시보드에서 기본적으로 사용할 시간 기간입니다. 허용 범위: 1분 - 10년(기본값: 1시간). 시간 접미사(예: 10m(10분), 5w(5주))가 지원됩니다. 참고: 사용자가 그래프를 보면서 시간 기간을 변경하면, 이 시간 기간은 전역 기본값이나 이전 사용자 선택을 대체하는 사용자 기본설정으로 저장됩니다.
시간 선택기의 최대 기간	그래프와 대시보드의 최대 사용 가능 시간 기간입니다. 사용자는 더 오래된 데이터를 시각화할 수 없습니다. 허용 범위: 1년 - 10년(기본값: 2년). 시간 접미사(예: 1y(1년), 365w(365주))가 지원됩니다.

자동 등록

이 섹션에서는 활성 에이전트 자동 등록의 암호화 수준을 구성할 수 있습니다.

$adm\_autoreg2.png$

별표로 표시된 매개변수는 필수입니다.

구성 매개변수:

매개변수	설명
암호화 수준	암호화 수준에 대해 하나 또는 두 옵션을 선택하세요: 암호화 없음 - 암호화되지 않은 연결이 허용됩니다 PSK - 미리 공유된 키를 사용한 TLS 암호화 연결이 허용됩니다
PSK identity	미리 공유된 키 식별자 문자열을 입력하세요. 이 필드는 암호화 수준으로 'PSK'가 선택된 경우에만 사용할 수 있습니다. PSK identity에 민감한 정보를 넣지 마세요. 수신자에게 어떤 PSK를 사용할지 알려주기 위해 네트워크를 통해 암호화되지 않은 상태로 전송됩니다.
PSK	미리 공유된 키를 입력하세요 (16진수 문자의 짝수 개수). 최대 길이: Zabbix가 GnuTLS 또는 OpenSSL 라이브러리를 사용하는 경우 512 16진수 자리 (256바이트 PSK), Zabbix가 mbed TLS (PolarSSL) 라이브러리를 사용하는 경우 64 16진수 자리 (32바이트 PSK). 예시: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 이 필드는 암호화 수준으로 'PSK'가 선택된 경우에만 사용할 수 있습니다.

참고: 보안 자동 등록

Timeouts

이 섹션에서는 전역 아이템 타입 타임아웃과 네트워크 타임아웃을 설정할 수 있습니다. 이 양식의 모든 필드는 필수입니다.

매개변수		설명
아이템 타입별 타임아웃		모니터링 아이템(타입별)에서 응답을 기다리는 시간(초)입니다. 허용 범위: 1 - 600초 (기본값: 3초; Browser 아이템 타입의 기본값: 60초). 시간 접미사(예: 30s, 1m)와 사용자 매크로가 지원됩니다. 지원되는 아이템 타입: - Zabbix agent (패시브 및 액티브 검사 모두) - Simple check (`icmpping`, `vmware.` 아이템 제외) - SNMP agent (SNMP `walk[OID]` 및 `get[OID]` 아이템만) - External check - Database monitor - HTTP agent - SSH agent - TELNET agent - Script - Browser 프록시를 사용하고 타임아웃이 구성된 경우, 프록시의 타임아웃 설정이 전역 설정보다 우선합니다. 특정 아이템에 타임아웃이 설정된 경우, 프록시 및 전역 설정보다 우선합니다.
UI용 네트워크 타임아웃
	Communication	유휴 소켓을 닫기 전에 대기하는 시간(초)입니다(Zabbix 서버에 연결이 이미 설정되었지만, 이 시간 동안 프론트엔드가 데이터 읽기/전송 작업을 완료할 수 없으면 연결이 끊어집니다). 허용 범위: 1 - 300초 (기본값: 3초).
	Connection	Zabbix 서버 연결 시도를 중단하기 전에 대기하는 시간(초)입니다. 허용 범위: 1 - 30초 (기본값: 3초).
	Media type test	미디어 타입을 테스트할 때 응답을 기다리는 시간(초)입니다. 허용 범위: 1 - 300초 (기본값: 65초).
	Script execution	스크립트를 실행할 때 응답을 기다리는 시간(초)입니다. 허용 범위: 1 - 300초 (기본값: 60초). 이 타임아웃은 다양한 길이를 가질 수 있는 전체 스크립트 실행 체인에 대한 것입니다. 예를 들어, 에이전트에서 스크립트가 실행되는 경우, 서버(또는 프록시)를 통해 에이전트까지의 왕복 과정입니다. 에이전트에서 실행되는 스크립트의 경우, 서버 또는 프록시 타임아웃이 적용됩니다. 액티브 에이전트에서만 실행되는 스크립트의 경우, 기본 서버/프록시 타임아웃을 늘려야 할 수 있습니다. 서버/프록시 타임아웃은 액티브 검사 새로고침 빈도보다 높아야 하며, 그렇지 않으면 액티브 에이전트가 스크립트를 받기도 전에 서버/프록시 타임아웃이 초과될 수 있습니다. 참고: 스크립트 타임아웃
	Item test	아이템을 테스트할 때 반환된 데이터를 기다리는 시간(초)입니다. 허용 범위: 1 - 600초 (기본값: 60초).
	Scheduled report test	예약된 리포트를 테스트할 때 반환된 데이터를 기다리는 시간(초)입니다. 허용 범위: 1 - 300초 (기본값: 60초).

이미지

이미지 섹션은 Zabbix에서 사용 가능한 모든 이미지를 표시합니다. 이미지는 데이터베이스에 저장됩니다.

유형 드롭다운을 통해 아이콘과 배경 이미지를 전환할 수 있습니다:

아이콘은 네트워크 맵 요소를 표시하는 데 사용됩니다.
배경은 네트워크 맵의 배경 이미지로 사용됩니다.

이미지 추가

오른쪽 상단의 아이콘 생성 또는 배경 생성 버튼을 클릭하여 자신만의 이미지를 추가할 수 있습니다.

이미지 속성:

매개변수	설명
이름	이미지의 고유한 이름입니다.
업로드	로컬 시스템에서 Zabbix로 업로드할 파일(PNG, JPEG, GIF, 또는 WebP)을 선택합니다. 업로드 중에 PNG로 변환될 다른 형식을 업로드하는 것도 가능할 수 있습니다. 이미지 처리에는 GD 라이브러리가 사용되므로 지원되는 형식은 사용된 라이브러리 버전에 따라 달라집니다(Zabbix에서는 2.0.28 이상이 필요함).

업로드 파일의 최대 크기는 ZBX_MAX_IMAGE_SIZE 값으로 제한되며, 이는 1024x1024 바이트 또는 1MB입니다.

이미지 크기가 1MB에 가깝고 max_allowed_packet MySQL 구성 매개변수가 기본값인 1MB일 경우 이미지 업로드가 실패할 수 있습니다. 이 경우 max_allowed_packet 매개변수를 증가시키세요.

아이콘 매핑

이 섹션에서는 특정 호스트와 특정 아이콘의 매핑을 생성할 수 있습니다. 호스트 인벤토리 필드 정보가 매핑 생성에 사용됩니다.

매핑은 네트워크 맵 구성에서 일치하는 호스트에 적절한 아이콘을 자동으로 할당하는 데 사용할 수 있습니다.

새 아이콘 맵을 생성하려면 오른쪽 상단 모서리의 아이콘 맵 생성을 클릭하세요.

구성 매개변수:

매개변수	설명
이름	아이콘 맵의 고유 이름.
매핑	매핑 목록. 매핑 순서에 따라 우선순위가 결정됩니다. 드래그 앤 드롭으로 매핑을 목록에서 위아래로 이동할 수 있습니다.
인벤토리 필드	일치하는 항목을 찾기 위해 검색할 호스트 인벤토리 필드.
표현식	일치를 설명하는 정규 표현식.
아이콘	표현식에 대한 일치가 발견될 경우 사용할 아이콘.
기본값	사용할 기본 아이콘.

정규 표현식

이 섹션에서는 프론트엔드의 여러 곳에서 사용할 수 있는 사용자 정의 정규 표현식을 생성할 수 있습니다. 자세한 내용은 정규 표현식 섹션을 참조하세요.

트리거 표시 옵션

이 섹션에서는 프론트엔드에서 트리거 상태가 표시되는 방법과 트리거 심각도 이름 및 색상을 사용자 지정할 수 있습니다.

매개변수	설명
사용자 정의 이벤트 상태 색상 사용	이 매개변수를 체크하면 확인됨/미확인 문제에 대한 색상 사용자 지정이 활성화됩니다.
미확인 PROBLEM 이벤트, 확인된 PROBLEM 이벤트, 미확인 RESOLVED 이벤트, 확인된 RESOLVED 이벤트	새로운 색상 코드를 입력하거나 색상을 클릭하여 제공된 팔레트에서 새 색상을 선택하세요. 깜빡임 체크박스가 표시되면 트리거가 상태 변경 시 더 잘 보이도록 일정 시간 깜빡입니다.
OK 트리거 표시 기간	OK 트리거를 표시하는 시간 기간입니다. 허용 범위: 0 - 24시간. 시간 접미사(예: 5m, 2h, 1d)가 지원됩니다.
상태 변경 시 트리거 깜빡임 기간	트리거 깜빡임 지속 시간입니다. 허용 범위: 0 - 24시간. 시간 접미사(예: 5m, 2h, 1d)가 지원됩니다.
분류되지 않음, 정보, 경고, 평균, 높음, 재해	시스템 기본값 대신 표시할 사용자 정의 심각도 이름 및/또는 색상입니다. 새로운 색상 코드를 입력하거나 색상을 클릭하여 제공된 팔레트에서 새 색상을 선택하세요. 여기서 입력한 사용자 정의 심각도 이름은 모든 로케일에서 사용됩니다. 특정 사용자를 위해 다른 언어로 번역해야 하는 경우 트리거 심각도 사용자 지정 페이지를 참조하세요.

지리적 지도

이 섹션에서는 지리적 지도 타일 서비스 제공자를 선택하고 Geomap 대시보드 위젯의 서비스 제공자 설정을 구성할 수 있습니다. 지리적 지도를 사용한 시각화를 제공하기 위해 Zabbix는 오픈 소스 JavaScript 대화형 지도 라이브러리인 Leaflet을 사용합니다. Zabbix는 미리 정의된 타일 제공자를 포함하여 타사 타일 제공자가 제공하는 이미지의 품질에 대해 제어할 수 없음을 참고하세요.

매개변수	설명
타일 제공자	사용 가능한 타일 서비스 제공자 중 하나를 선택하거나 기타를 선택하여 다른 타일 제공자나 자체 호스팅 타일을 추가합니다(사용자 정의 타일 서비스 제공자 사용 참조).
타일 URL	지리적 지도에서 타일 레이어를 로드하고 표시하기 위한 URL 템플릿(최대 2048자)입니다. 이 필드는 타일 제공자가 기타로 설정된 경우에만 편집할 수 있습니다. 다음 자리 표시자가 지원됩니다: {s}는 사용 가능한 하위 도메인 중 하나를 나타냅니다; {z}는 URL의 확대/축소 수준 매개변수를 나타냅니다; {x}와 {y}는 타일 좌표를 나타냅니다; {r}은 레티나 타일을 로드하기 위해 URL에 "\@2x"를 추가하는 데 사용할 수 있습니다. 예시: `https://{s}.example.com/{z}/{x}/{y}{r}.png`
저작권 표시 텍스트	지도의 작은 텍스트 상자에 표시될 타일 제공자 저작권 표시 텍스트입니다. 이 필드는 타일 제공자가 기타로 설정된 경우에만 표시됩니다.
최대 확대/축소 수준	지도의 최대 확대/축소 수준입니다. 이 필드는 타일 제공자가 기타로 설정된 경우에만 편집할 수 있습니다.

사용자 정의 타일 서비스 제공자 사용하기

Geomap 위젯은 사용자 정의 자체 호스팅 또는 제3자 타일 제공자 서비스로부터 래스터 타일 이미지를 로드할 수 있습니다. 사용자 정의 제3자 타일 제공자 서비스나 자체 호스팅 타일 폴더 또는 서버를 사용하려면, Tile provider 필드에서 Other를 선택하고 적절한 플레이스홀더를 사용하여 Tile URL 필드에 사용자 정의 URL을 지정하세요.

모듈

이 섹션에서는 사용자 정의 모듈과 내장된 프론트엔드 모듈을 관리할 수 있습니다.

디렉터리 스캔을 클릭하여 사용자 정의 모듈을 등록/해제할 수 있습니다. 등록된 모듈은 목록에 나타나며, 등록 해제된 모듈은 목록에서 제거됩니다.

목록에서 모듈 상태를 클릭하여 모듈을 활성화/비활성화할 수 있습니다. 목록에서 모듈을 선택한 후 목록 하단의 활성화/비활성화 버튼을 클릭하여 모듈을 일괄적으로 활성화/비활성화할 수도 있습니다.

목록에서 모듈 이름을 클릭하면 팝업 창에서 해당 모듈의 세부 정보를 볼 수 있습니다.

모듈 상태는 모듈 세부 정보 팝업 창에서도 업데이트할 수 있습니다. 이를 위해 활성화 체크박스를 체크/체크 해제한 후 업데이트를 클릭하세요.

이름 또는 상태(활성화/비활성화)로 모듈을 필터링할 수 있습니다.

커넥터

이 섹션에서는 HTTP를 통해 Zabbix 데이터를 외부 시스템으로 스트리밍하기 위한 커넥터를 설정할 수 있습니다.

새로운 커넥터를 설정하려면 커넥터 생성을 클릭하세요.

이름이나 상태(활성화/비활성화)로 커넥터를 필터링할 수 있습니다. 목록에서 커넥터 상태를 클릭하여 커넥터를 활성화/비활성화할 수 있습니다. 목록에서 커넥터를 선택한 후 목록 아래의 활성화/비활성화 버튼을 클릭하여 커넥터를 대량으로 활성화/비활성화할 수도 있습니다.

기타

이 섹션에서는 기타 프런트엔드 매개변수들을 구성할 수 있습니다.

매개변수	설명
Frontend URL	Zabbix 웹 인터페이스의 URL (최대 2048자). 이 매개변수는 Zabbix 웹 서비스가 프런트엔드와 통신하기 위해 사용되며, 예약된 보고서를 활성화하려면 지정해야 합니다.
Group for discovered hosts	네트워크 탐지와 에이전트 자동등록으로 탐지된 호스트는 여기서 선택된 호스트 그룹에 자동으로 배치됩니다.
Default host inventory mode	호스트 인벤토리의 기본 모드입니다. 서버나 프런트엔드에서 새로운 호스트나 호스트 프로토타입이 생성될 때마다 이 모드가 따라집니다. 단, 호스트 탐지/자동등록 중에 호스트 인벤토리 모드 설정 작업으로 재정의되는 경우는 예외입니다.
User group for database down message	데이터베이스 다운 알람 메시지를 보낼 사용자 그룹. Zabbix 서버는 백엔드 데이터베이스의 가용성에 의존합니다. 데이터베이스 없이는 작동할 수 없습니다. 데이터베이스가 다운되면 선택된 사용자들이 Zabbix로부터 알림을 받을 수 있습니다. 알림은 여기서 설정된 사용자 그룹에게 활성화된 사용자 미디어 항목을 사용하여 전송됩니다. 알림은 다음 미디어 유형을 통해 전송됩니다(활성화된 경우): 이메일; SMS; 사용자 정의 알림 스크립트. 웹훅 미디어 항목이 구성되고 활성화되어 있어도 알림을 트리거하지 않습니다. Zabbix 서버는 중지되지 않으며, 데이터베이스가 다시 돌아와 처리를 계속할 수 있을 때까지 대기합니다. 알림은 다음 내용으로 구성됩니다: `[MySQL\|PostgreSQL\|Oracle] database <DB Name> [on <DB Host>:<DB Port>] is not available: <error message depending on the type of DBMS (database)>` <DB Host>는 빈 값으로 정의된 경우 메시지에 추가되지 않으며, <DB Port>는 기본값("0")인 경우 추가되지 않습니다. 알림 관리자(특수한 Zabbix 서버 프로세스)는 10초마다 데이터베이스에 새로운 연결을 시도합니다. 데이터베이스가 여전히 다운 상태이면 알림 관리자는 알림 전송을 반복하지만, 15분마다 한 번을 넘지 않습니다.
Log unmatched SNMP traps	해당하는 SNMP 인터페이스를 찾을 수 없는 경우 SNMP 트랩을 로깅합니다.

인증

매개변수	설명
로그인 시도	로그인 가능성이 차단되기 전까지의 실패한 로그인 시도 횟수입니다.
로그인 차단 간격	로그인 시도 제한을 초과했을 때 로그인이 금지되는 기간입니다. 허용 범위: 30 - 3600초. 시간 접미사(예: 90s, 5m, 1h)를 지원합니다.

시크릿 저장

Vault provider 매개변수를 사용하여 사용자 매크로 값을 저장할 시크릿 관리 소프트웨어를 선택할 수 있습니다. 지원되는 옵션:

HashiCorp Vault (기본값)
CyberArk Vault

참고: 시크릿 저장.

보안

매개변수	설명
URI 스킴 검증	URI 스킴 검증을 비활성화하려면 이 체크박스를 해제하세요 (기본값: 활성화됨). 체크하면 허용된 URI 스킴을 쉼표로 구분된 목록으로 지정할 수 있습니다 (기본값: http,https,ftp,file,mailto,tel,ssh). 프론트엔드에서 URI가 사용되는 모든 필드에 적용됩니다 (예: 맵 요소 URL).
X-Frame-Options HTTP 헤더 사용	HTTP X-Frame-options 헤더를 비활성화하려면 이 체크박스를 해제하세요 (권장하지 않음). 체크하면 HTTP X-Frame-options 헤더의 값을 지정할 수 있습니다. 지원되는 값: SAMEORIGIN (기본값) 또는 'self' (단일 따옴표 필수) - 페이지는 페이지 자체와 같은 출처의 프레임에서만 표시될 수 있습니다; DENY 또는 'none' (단일 따옴표 필수) - 페이지는 어떤 사이트에서 시도하더라도 프레임에 표시될 수 없습니다; 공백으로 구분된 호스트명 문자열; 목록에 'self' (단일 따옴표 필수)를 추가하면 페이지가 페이지 자체와 같은 출처의 프레임에서 표시될 수 있습니다. 단일 따옴표 없이 'self' 또는 'none'을 사용하면 호스트명으로 간주됩니다.
iframe 샌드박스 사용	검색된 URL 콘텐츠를 샌드박스에 넣는 것을 비활성화하려면 이 체크박스를 해제하세요 (권장하지 않음). 체크하면 iframe 샌드박스 예외를 지정할 수 있습니다; 지정되지 않은 제한사항은 여전히 적용됩니다. 이 필드가 비어 있으면 모든 sandbox 속성 제한사항이 적용됩니다. 자세한 정보는 `sandbox` 속성의 설명을 참조하세요.