문서

원본 보기

1 아이템 생성하기

개요

Zabbix 프론트엔드에서 아이템을 생성하려면 다음과 같이 하세요:

  • 데이터 수집 > 호스트로 이동
  • 호스트 행에서 아이템을 클릭
  • 화면 오른쪽 상단의 아이템 생성을 클릭
  • 양식에 아이템의 매개변수를 입력

기존 아이템을 열어서 복제 버튼을 누른 다음 다른 이름으로 저장하여 아이템을 생성할 수도 있습니다.

구성

Item 탭에는 일반적인 아이템 속성들이 포함되어 있습니다.

모든 필수 입력 필드는 빨간색 별표로 표시됩니다.

매개변수 설명
Name 아이템 이름.
사용자 매크로가 지원됩니다.
Type 아이템 유형. 개별 아이템 유형 섹션을 참조하세요.
Key 아이템 키 (최대 2048자).
지원되는 아이템 키는 개별 아이템 유형 섹션에서 찾을 수 있습니다.
키는 단일 호스트 내에서 고유해야 합니다.
키 유형이 'Zabbix agent', 'Zabbix agent (active)' 또는 'Simple check'인 경우, 키 값은 Zabbix agent 또는 Zabbix server에서 지원되어야 합니다.
참고: 올바른 키 형식.
Type of information 변환 후 데이터베이스에 저장되는 데이터 유형.
Numeric (unsigned) - 64비트 부호 없는 정수.
정수 아이템에 대해 부동소수점 값이 수신되면 소수 부분이 제거됩니다.
Numeric (float) - 64비트 부동소수점 숫자.
이 유형은 약 15자리의 정밀도를 허용하며 범위는 약 -1.79E+308에서 1.79E+308까지입니다 (PostgreSQL 11 및 이전 버전 제외).
과학적 표기법으로 값을 받는 것도 지원됩니다. 예: 1.23E+7, 1e308, 1.1E-4.
Character - 짧은 텍스트 데이터.
Log - 선택적 로그 관련 속성(타임스탬프, 소스, 심각도, logeventid)을 가진 긴 텍스트 데이터.
Text - 긴 텍스트 데이터. 텍스트 데이터 제한도 참조하세요.
Binary - 이진 숫자 (의존 아이템에서만 지원).
이진 데이터 유형을 반환하는 아이템은 계산된 아이템 공식이나 트리거 표현식에서 지원되지 않습니다.
특정 형식의 데이터만 반환하는 아이템 키의 경우, 일치하는 정보 유형이 자동으로 선택됩니다.
Host interface 호스트 인터페이스를 선택하세요. 이 필드는 호스트 레벨에서 아이템을 편집할 때 사용할 수 있습니다.
Units 단위 기호가 설정되면, Zabbix는 수신된 아이템 값에 후처리를 적용하고 지정된 단위 접미사와 함께 표시합니다.
특별한 형식을 가진 지원되는 단위 기호 (그리고 수신된 아이템 값 → 표시된 값의 예):
B - 바이트 (1024 → 1 KB)
Bps - 초당 바이트 (1024 → 1 KBps)
s - 초, 최대 3개의 가장 큰 0이 아닌 시간 단위를 사용하여 표시 (881764 → 10d 4h 56m)
uptime - hh:mm:ss 또는 N days, hh:mm:ss 형식의 경과 시간 (881764 → 10 days, 04:56:04)
unixtime - yyyy.mm.dd hh:mm:ss 형식으로 포맷된 Unix 타임스탬프 (881764 → 1970-01-11 04:56:04 AM); 올바른 형식을 위해서는 수신된 아이템 값이 Numeric (unsigned)여야 합니다.
다른 단위 (Hz, W 등)의 경우, 수신된 값이 1000을 초과하면 1000으로 나누어지고 해당 접두사와 함께 표시됩니다 (5000 → 5 KHz, 881764 → 881.76 KW).
단위 기호가 !로 시작하면, 단위 변환 및 접두사가 비활성화됩니다 (1024 !B → 1024 B, 61 !s → 61 s).
단위 기호 및 단위 변환에 대한 더 많은 예제와 세부 사항은 아이템 값 접미사를 참조하세요.
Update interval 이 아이템에 대해 N초마다 새로운 값을 검색합니다. 허용되는 최대 업데이트 간격은 86400초(1일)입니다.
시간 접미사가 지원됩니다. 예: 30s, 1m, 2h, 1d.
사용자 매크로가 지원됩니다.
단일 매크로가 전체 필드를 채워야 합니다. 필드에 여러 매크로가 있거나 매크로가 텍스트와 혼합된 것은 지원되지 않습니다.
참고: 업데이트 간격은 0이 아닌 값을 가진 사용자 정의 간격이 존재하는 경우에만 '0'으로 설정할 수 있습니다. '0'으로 설정되고 0이 아닌 값을 가진 사용자 정의 간격(유연 또는 예약)이 존재하면, 사용자 정의 간격 기간 동안 아이템이 폴링됩니다.
참고 아이템이 활성화된 후 또는 업데이트 간격 변경 후의 첫 번째 아이템 폴링은 구성된 값보다 빨리 발생할 수 있습니다.
새 아이템은 스케줄링 또는 유연한 업데이트 간격이 있고 업데이트 간격이 0으로 설정되지 않은 한, 생성된 지 60초 이내에 확인됩니다.
기존 수동 아이템은 지금 실행 버튼을 눌러 즉시 값을 폴링할 수 있습니다.
Custom intervals 아이템 확인을 위한 사용자 정의 규칙을 만들 수 있습니다:
Flexible - 업데이트 간격에 대한 예외를 생성합니다(다른 빈도를 가진 간격).
Scheduling - 사용자 정의 폴링 일정을 생성합니다.
자세한 정보는 사용자 정의 간격을 참조하세요.
시간 접미사가 간격 필드에서 지원됩니다. 예: 30s, 1m, 2h, 1d.
사용자 매크로가 지원됩니다.
단일 매크로가 전체 필드를 채워야 합니다. 필드에 여러 매크로가 있거나 매크로가 텍스트와 혼합된 것은 지원되지 않습니다.
Timeout 아이템 확인 타임아웃을 설정합니다(지원되는 아이템 유형에 사용 가능). 타임아웃 옵션을 선택하세요:
Global - 프록시/글로벌 타임아웃이 사용됩니다(회색으로 표시된 타임아웃 필드에 표시).
Override - 사용자 정의 타임아웃이 사용됩니다(타임아웃 필드에서 설정; 허용 범위: 1 - 600s). 시간 접미사 예: 30s, 1m 및 사용자 매크로가 지원됩니다.
타임아웃 링크를 클릭하면 프록시 타임아웃이나 글로벌 타임아웃(프록시가 사용되지 않는 경우)을 구성할 수 있습니다. 타임아웃 링크는 Administration > General 또는 Administration > Proxies 프론트엔드 섹션에 대한 권한을 가진 Super admin 유형의 사용자에게만 표시됩니다.
History 다음 중 하나를 선택하세요:
Do not store - 아이템 히스토리가 저장되지 않습니다. 의존 아이템만 히스토리를 유지해야 하는 경우 마스터 아이템에 유용합니다.
이 설정은 글로벌 하우스키퍼 설정으로 재정의할 수 없습니다.
Store up to - 데이터베이스에 상세 히스토리를 보관하는 기간을 지정합니다(1시간에서 25년). 오래된 데이터는 하우스키퍼에 의해 제거됩니다. 초 단위로 저장됩니다.
시간 접미사가 지원됩니다. 예: 2h, 1d. 사용자 매크로가 지원됩니다.
Store up to 값은 Administration > Housekeeping에서 전역적으로 재정의될 수 있습니다.
글로벌 재정의 설정이 존재하면, 주황색 정보 아이콘이 표시됩니다. 마우스를 올리면 경고 메시지가 표시됩니다. 예: Overridden by global housekeeper settings (1d).
데이터베이스의 값 히스토리 크기를 줄이기 위해 가능한 한 짧은 시간 동안만 기록된 값을 보관하는 것이 좋습니다. 긴 값 히스토리를 저장하는 대신 더 오랜 기간의 트렌드 데이터를 저장할 수 있습니다.
히스토리와 트렌드도 참조하세요.
Trends 다음 중 하나를 선택하세요:
Do not store - 트렌드가 저장되지 않습니다.
이 설정은 글로벌 하우스키퍼 설정으로 재정의할 수 없습니다.
Store up to - 데이터베이스에 집계된(시간별 최소, 최대, 평균, 개수) 히스토리를 보관하는 기간을 지정합니다(1일에서 25년). 오래된 데이터는 하우스키퍼에 의해 제거됩니다. 초 단위로 저장됩니다.
시간 접미사가 지원됩니다. 예: 24h, 1d. 사용자 매크로가 지원됩니다.
Store up to 값은 Administration > Housekeeping에서 전역적으로 재정의될 수 있습니다.
글로벌 재정의 설정이 존재하면, 주황색 정보 아이콘이 표시됩니다. 마우스를 올리면 경고 메시지가 표시됩니다. 예: Overridden by global housekeeper settings (7d).
참고: 트렌드 보관은 숫자가 아닌 데이터(문자, 로그 및 텍스트)에는 사용할 수 없습니다.
히스토리와 트렌드도 참조하세요.
Value mapping 이 아이템에 값 매핑을 적용합니다. 값 매핑은 수신된 값을 변경하지 않으며, 데이터 표시용으로만 사용됩니다.
Numeric(unsigned), Numeric(float) 및 Character 아이템과 함께 작동합니다.
예: "Windows 서비스 상태".
Log time format Log 유형의 아이템에서만 사용 가능합니다. 지원되는 자리 표시자:
y: 연도 (1970-2038).
M: 월 (01-12).
d: 일 (01-31).
h: 시간 (00-23).
m: 분 (00-59).
s: 초 (00-59).
비어 있으면, 타임스탬프는 1970년 1월 1일을 나타내는 Unix 시간 0으로 설정됩니다.
예를 들어, Zabbix agent 로그 파일의 다음 줄을 고려해보세요:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
이는 PID를 위한 6개의 문자 위치로 시작하고, 그 다음에 날짜, 시간, 그리고 나머지 메시지가 옵니다.
이 줄의 로그 시간 형식은 "pppppp:yyyyMMdd:hhmmss"입니다.
"p"와 ":" 문자는 자리 표시자이며 "yMdhms"를 제외한 모든 문자가 될 수 있습니다.
Populates host inventory field 아이템의 값이 채울 호스트 인벤토리 필드를 선택할 수 있습니다. 이는 호스트에 대해 자동 인벤토리 채우기가 활성화된 경우 작동합니다.
정보 유형이 'Log'로 설정된 경우 이 필드는 사용할 수 없습니다.
Description 아이템 설명을 입력하세요. 사용자 매크로가 지원됩니다.
Enabled 아이템이 처리되도록 활성화하려면 체크박스를 표시하세요.
Latest data 아이템의 최신 데이터를 보려면 링크를 클릭하세요.
이 링크는 이미 존재하는 아이템을 편집할 때만 사용할 수 있습니다.

아이템 유형별 필드는 해당 페이지에 설명되어 있습니다.

호스트 레벨에서 기존 템플릿 레벨 아이템을 편집할 때, 여러 필드가 읽기 전용입니다. 폼 헤더의 링크를 사용하여 템플릿 레벨로 이동하여 편집할 수 있지만, 템플릿 레벨의 변경사항은 템플릿이 연결된 모든 호스트의 아이템을 변경한다는 점을 염두에 두세요.

아이템 값 전처리

전처리 탭을 통해 수신된 값에 대한 변환 규칙을 정의할 수 있습니다.

아이템 테스트

아이템 테스트를 수행하려면 서버와 프록시의 시스템 시간이 동기화되어 있는지 확인하세요. 서버 시간이 뒤처진 경우, 아이템 테스트에서 "The task has been expired." 오류 메시지가 반환될 수 있습니다. 그러나 서버와 프록시에 다른 시간대를 설정하는 것은 테스트 결과에 영향을 주지 않습니다.

아이템을 테스트하고 올바르게 구성된 경우 실제 값을 반환받을 수 있습니다. 테스트는 아이템이 저장되기 전에도 수행할 수 있습니다.

테스트는 호스트 및 템플릿 아이템, 아이템 프로토타입 및 로우레벨 디스커버리 규칙에 사용할 수 있습니다. 액티브 아이템은 테스트할 수 없습니다.

아이템 테스트는 다음 패시브 아이템 유형에서 사용할 수 있습니다:

  • Zabbix agent
  • SNMP agent (v1, v2, v3)
  • IPMI agent
  • SSH checks
  • Telnet checks
  • JMX agent
  • Simple checks (icmpping*, vmware.* 아이템 제외)
  • Zabbix internal
  • Calculated items
  • External checks
  • Database monitor
  • HTTP agent
  • Script
  • Browser

아이템을 테스트하려면 아이템 구성 폼 하단의 Test 버튼을 클릭하세요. 테스트할 수 없는 아이템(액티브 체크, 제외된 심플 체크 등)의 경우 Test 버튼이 비활성화됩니다.

아이템 테스트 폼에는 필요한 호스트 매개변수(호스트 주소, 포트, 서버/프록시로 테스트(프록시 이름))와 아이템별 세부 정보(SNMPv2 커뮤니티 또는 SNMPv3 보안 자격 증명 등)를 위한 필드가 있습니다. 이러한 필드는 상황에 따라 달라집니다:

  • 가능한 경우 값이 미리 채워집니다. 즉, 에이전트가 필요한 아이템의 경우 호스트의 선택된 에이전트 인터페이스에서 정보를 가져와 채웁니다.
  • 템플릿 아이템의 경우 값을 수동으로 입력해야 합니다.
  • 일반 텍스트 매크로 값이 해석됩니다.
  • 값(또는 값의 일부)이 시크릿이나 Vault 매크로인 필드는 비어 있으며 수동으로 입력해야 합니다. 아이템 매개변수에 시크릿 매크로 값이 포함된 경우 다음 경고 메시지가 표시됩니다: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
  • 아이템 유형의 맥락에서 필요하지 않은 경우 필드가 비활성화됩니다(예: 계산된 아이템의 경우 호스트 주소 필드와 프록시 필드가 비활성화됨)

아이템을 테스트하려면 Get value를 클릭하세요. 값이 성공적으로 검색되면 Value 필드에 채워지고, 현재 값(있는 경우)은 Previous value 필드로 이동하며 Prev. time 필드(두 값(클릭) 간의 시간 차이)도 계산되고, 검색된 값에서 "\n\r"을 감지하면 EOL 시퀀스를 감지하여 CRLF로 전환하려고 시도합니다.

전처리를 테스트하려면 Get value and test를 클릭하세요.

호스트에서 검색된 값과 테스트 결과는 프론트엔드로 전송될 때 최대 512KB 크기로 잘립니다. 결과가 잘리면 경고 아이콘이 표시됩니다. 경고 설명은 마우스를 올리면 표시됩니다. 512KB보다 큰 데이터는 Zabbix 서버에서 여전히 완전히 처리됩니다.

구성이 올바르지 않으면 가능한 원인을 설명하는 오류 메시지가 표시됩니다.

호스트에서 성공적으로 검색된 값은 전처리 단계를 테스트하는 데에도 사용할 수 있습니다.

폼 버튼

폼 하단의 버튼들을 통해 여러 작업을 수행할 수 있습니다.
아이템을 추가합니다. 이 버튼은 새 아이템에만 사용할 수 있습니다.
아이템의 속성을 업데이트합니다.
현재 아이템의 속성을 기반으로 다른 아이템을 생성합니다.
새 아이템 값에 대한 검사를 즉시 실행합니다. 수동 검사에만 지원됩니다(자세한 내용 참조).
참고: 즉시 값을 확인할 때 구성 캐시는 업데이트되지 않으므로, 값은 최근 아이템 구성 변경 사항을 반영하지 않습니다.
값을 가져와서 아이템 구성이 올바른지 테스트합니다.
아이템 히스토리와 트렌드를 삭제합니다.
아이템을 삭제합니다.
아이템 속성 편집을 취소합니다.

텍스트 데이터 제한

텍스트 데이터 제한은 데이터베이스 백엔드에 따라 달라집니다. 텍스트 값을 데이터베이스에 저장하기 전에 데이터베이스 값 유형 제한에 맞게 잘립니다:

데이터베이스 정보 유형
Character Log Text
MySQL 255 characters 65536 bytes 65536 bytes
PostgreSQL 255 characters 65536 characters 65536 characters
Oracle 255 characters 65536 characters 65536 characters
SQLite (Zabbix proxy 전용) 255 characters 65536 characters 65536 characters

커스텀 스크립트 제한

사용 가능한 커스텀 스크립트 길이는 사용하는 데이터베이스에 따라 다릅니다:

데이터베이스 문자 수 제한 바이트 제한
MySQL 65535 65535
PostgreSQL 65535 제한 없음
Oracle 2048 4000
SQLite (Zabbix proxy만 해당) 65535 제한 없음

아이템 타임아웃

아이템 타임아웃은 Zabbix가 검사를 실패로 중단하기 전에 얼마나 기다릴지를 지정합니다.

타임아웃에 도달하면 데이터 수집이 완료되지 않았더라도 검사가 중단됩니다. 데이터가 부분적으로만 수신되면 아이템이 지원되지 않음 상태가 되고 오류 메시지가 기록됩니다 (예: SNMP 검사에서 여러 OID 중 하나에 대해서만 데이터가 성공적으로 수집된 경우).

많은 아이템 유형의 경우 유연한 아이템 타임아웃을 설정할 수 있습니다:

  • 개별 아이템별
  • 아이템 유형별 (프록시 수준에서)
  • 아이템 유형별 (전역 수준에서)

개별 아이템별 사용자 정의 타임아웃은 다른 아이템의 타임아웃을 낮게 유지하면서 특정 아이템에 대해 더 긴 타임아웃을 지정하고자 할 때 유용합니다.

타임아웃 우선순위

  1. 개별 아이템 타임아웃은 다른 모든 타임아웃보다 우선합니다.
  2. 프록시 수준 타임아웃은 전역 타임아웃보다 우선합니다.

Zabbix 서버 또는 프록시 구성의 타임아웃은 유연한 타임아웃이 설정된 검사에서는 전혀 역할을 하지 않습니다.

유연한 타임아웃 지원

다음 아이템 유형에서 유연한 아이템 타임아웃이 지원됩니다:

지원되지 않는 항목

지원되지 않는 항목은 지원되지 않음 상태로 보고되며, 여전히 표준 업데이트 간격에 따라 재확인됩니다.

항목은 어떤 이유로 값을 가져올 수 없는 경우(예: 연결 오류, 항목을 처리할 폴러가 구성되지 않음) 지원되지 않는 상태가 됩니다. 또한, 이력 데이터를 받지 못하는 항목은 지원되지 않음 상태를 유지합니다. 이는 예상되는 동작입니다. 항목은 새롭고 유효한 이력 데이터를 받을 때만 정상 상태로 전환됩니다.

문제와 마찬가지로, 지원되지 않는 항목은 새로운 데이터가 수신될 때만 재평가됩니다. 해당 항목에 대한 이력 데이터가 더 이상 없더라도 마찬가지입니다. 즉, 항목과 트리거는 새로운 데이터를 받을 때만 상태가 변경됩니다. 하지만 트리거 표현식에 날짜 및 시간 및/또는 nodata() 함수가 포함되어 있으면, 트리거는 30초마다 재계산됩니다(자세한 내용은 트리거 계산 시간 참조).