1 아이템 생성하기

원본 보기

1 아이템 생성

개요

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

  • Data collection > Hosts로 이동
  • 호스트 행에서 Items 클릭
  • 화면 우측 상단의 Create item 클릭
  • 폼에서 아이템의 매개변수 입력

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

설정

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

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

매개변수 설명
이름 아이템 이름.
사용자 매크로를 지원합니다.
유형 아이템 유형. 개별 아이템 유형 섹션을 참조하세요.
키 아이템 키 (최대 2048자).
지원되는 아이템 키는 개별 아이템 유형 섹션에서 찾을 수 있습니다.
키는 단일 호스트 내에서 고유해야 합니다.
키 유형이 'Zabbix agent', 'Zabbix agent (active)' 또는 'Simple check'인 경우, 키 값은 Zabbix agent 또는 Zabbix server에서 지원되어야 합니다.
참고: 올바른 키 형식.
정보 유형 변환 후 데이터베이스에 저장되는 데이터 유형.
숫자 (부호 없음) - 64비트 부호 없는 정수.
정수 아이템에 대해 부동소수점 값이 수신되면 소수 부분이 잘립니다.
숫자 (부동소수점) - 64비트 부동소수점 숫자.
이 유형은 약 15자리의 정밀도와 약 -1.79E+308부터 1.79E+308까지의 범위를 허용합니다 (PostgreSQL 11 이하 버전 제외).
과학적 표기법으로 값을 수신하는 것도 지원됩니다. 예: 1.23E+7, 1e308, 1.1E-4.
문자 - 짧은 텍스트 데이터.
로그 - 선택적 로그 관련 속성(타임스탬프, 소스, 심각도, logeventid)이 있는 긴 텍스트 데이터.
텍스트 - 긴 텍스트 데이터. 텍스트 데이터 제한도 참조하세요.
바이너리 - 이진 숫자 (종속 아이템에서만 지원).
이진 데이터 유형으로 값을 반환하는 아이템은 계산 아이템 공식이나 트리거 표현식에서 지원되지 않습니다.
특정 형식의 데이터만 반환하는 아이템 키의 경우, 일치하는 정보 유형이 자동으로 선택됩니다.
호스트 인터페이스 호스트 인터페이스를 선택합니다. 이 필드는 호스트 수준에서 아이템을 편집할 때 사용할 수 있습니다.
단위 단위 기호가 설정되면, 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); 올바른 형식을 위해서는 수신된 아이템 값이 숫자 (부호 없음)이어야 합니다.
다른 단위 (Hz, W 등)의 경우, 수신된 값이 1000을 초과하면 1000으로 나누어지고 해당 접두사와 함께 표시됩니다 (5000 → 5 KHz, 881764 → 881.76 KW).
단위 기호 앞에 !가 붙으면 단위 변환 및 접두사가 비활성화됩니다 (1024 !B → 1024 B, 61 !s → 61 s).
단위 기호와 단위 변환에 대한 더 많은 예시와 세부 사항은 아이템 값 접미사를 참조하세요.
업데이트 간격 이 아이템에 대한 새 값을 N초마다 검색합니다. 최대 허용 업데이트 간격은 86400초(1일)입니다.
시간 접미사를 지원합니다. 예: 30s, 1m, 2h, 1d.
사용자 매크로를 지원합니다.
단일 매크로가 전체 필드를 채워야 합니다. 필드에 여러 매크로가 있거나 매크로가 텍스트와 혼합된 것은 지원되지 않습니다.
주의: 업데이트 간격은 0이 아닌 값을 가진 사용자 정의 간격이 존재할 때만 '0'으로 설정할 수 있습니다. '0'으로 설정되고 0이 아닌 값을 가진 사용자 정의 간격(유연 또는 예약된)이 존재하는 경우, 아이템은 사용자 정의 간격 기간 동안 폴링됩니다.
주의 아이템이 활성화된 후 또는 업데이트 간격 변경 후 첫 번째 아이템 폴링은 설정된 값보다 빨리 발생할 수 있습니다.
새 아이템은 스케줄링 또는 유연 업데이트 간격이 있고 업데이트 간격이 0으로 설정되지 않은 한, 생성 후 60초 이내에 확인됩니다.
기존 패시브 아이템은 지금 실행 버튼을 눌러 즉시 값을 폴링할 수 있습니다.
사용자 정의 간격 아이템 확인을 위한 사용자 정의 규칙을 만들 수 있습니다:
유연 - 업데이트 간격에 대한 예외를 생성합니다 (다른 빈도의 간격).
스케줄링 - 사용자 정의 폴링 일정을 생성합니다.
자세한 정보는 사용자 정의 간격을 참조하세요.
시간 접미사가 간격 필드에서 지원됩니다. 예: 30s, 1m, 2h, 1d.
사용자 매크로를 지원합니다.
단일 매크로가 전체 필드를 채워야 합니다. 필드에 여러 매크로가 있거나 매크로가 텍스트와 혼합된 것은 지원되지 않습니다.
타임아웃 아이템 확인 타임아웃을 설정합니다 (지원되는 아이템 유형에서 사용 가능). 타임아웃 옵션을 선택합니다:
전역 - 프록시/전역 타임아웃이 사용됩니다 (회색으로 표시된 타임아웃 필드에 표시).
덮어쓰기 - 사용자 정의 타임아웃이 사용됩니다 (타임아웃 필드에서 설정; 허용 범위: 1 - 600s). 시간 접미사 예: 30s, 1m과 사용자 매크로를 지원합니다.
타임아웃 링크를 클릭하면 프록시 타임아웃 또는 전역 타임아웃을 구성할 수 있습니다 (프록시를 사용하지 않는 경우). 타임아웃 링크는 관리 > 일반 또는 관리 > 프록시 프론트엔드 섹션에 권한이 있는 슈퍼 관리자 유형의 사용자에게만 표시됩니다.
히스토리 다음 중 하나를 선택합니다:
저장하지 않음 - 아이템 히스토리가 저장되지 않습니다. 종속 아이템만 히스토리를 보관하면 되는 마스터 아이템에 유용합니다.
이 설정은 전역 하우스키퍼 설정으로 덮어쓸 수 없습니다.
최대 저장 - 데이터베이스에 상세 히스토리를 보관할 기간을 지정합니다 (1시간부터 25년까지). 오래된 데이터는 하우스키퍼에 의해 제거됩니다. 초 단위로 저장됩니다.
시간 접미사를 지원합니다. 예: 2h, 1d. 사용자 매크로를 지원합니다.
최대 저장 값은 관리 > 하우스키핑에서 전역적으로 덮어쓸 수 있습니다.
전역 덮어쓰기 설정이 존재하는 경우, 주황색 정보 아이콘이 표시됩니다. 마우스를 올리면 경고 메시지가 표시됩니다. 예: 전역 하우스키퍼 설정에 의해 덮어쓰기됨 (1d).
데이터베이스의 값 히스토리 크기를 줄이기 위해 가능한 한 짧은 시간 동안 기록된 값을 보관하는 것이 좋습니다. 긴 값 히스토리를 저장하는 대신 더 긴 트렌드 데이터를 저장할 수 있습니다.
히스토리와 트렌드도 참조하세요.
트렌드 다음 중 하나를 선택합니다:
저장하지 않음 - 트렌드가 저장되지 않습니다.
이 설정은 전역 하우스키퍼 설정으로 덮어쓸 수 없습니다.
최대 저장 - 데이터베이스에 집계된(시간별 min, max, avg, count) 히스토리를 보관할 기간을 지정합니다 (1일부터 25년까지). 오래된 데이터는 하우스키퍼에 의해 제거됩니다. 초 단위로 저장됩니다.
시간 접미사를 지원합니다. 예: 24h, 1d. 사용자 매크로를 지원합니다.
최대 저장 값은 관리 > 하우스키핑에서 전역적으로 덮어쓸 수 있습니다.
전역 덮어쓰기 설정이 존재하는 경우, 주황색 정보 아이콘이 표시됩니다. 마우스를 올리면 경고 메시지가 표시됩니다. 예: 전역 하우스키퍼 설정에 의해 덮어쓰기됨 (7d).
주의: 트렌드 보관은 숫자가 아닌 데이터 - 문자, 로그, 텍스트에서는 사용할 수 없습니다.
히스토리와 트렌드도 참조하세요.
값 매핑 이 아이템에 값 매핑을 적용합니다. 값 매핑은 수신된 값을 변경하지 않으며, 데이터 표시용입니다.
숫자(부호 없음), 숫자(부동소수점), 문자 아이템과 함께 작동합니다.
예: "Windows service states".
로그 시간 형식 로그 유형의 아이템에서만 사용 가능합니다. 지원되는 플레이스홀더:
y: 연도 (1970-2038).
M: 월 (01-12).
d: 일 (01-31).
h: 시간 (00-23).
m: 분 (00-59).
s: 초 (00-59).
비워두면 타임스탬프가 Unix 시간으로 0으로 설정되어 1970년 1월 1일을 나타냅니다.
예를 들어, Zabbix agent 로그 파일의 다음 줄을 고려하세요:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
PID를 위한 6개 문자 위치로 시작하고, 날짜, 시간, 그리고 메시지의 나머지 부분이 이어집니다.
이 줄의 로그 시간 형식은 "pppppp:yyyyMMdd:hhmmss"입니다.
"p"와 ":" 문자는 플레이스홀더이며 "yMdhms"를 제외한 모든 문자가 될 수 있습니다.
호스트 인벤토리 필드 채우기 아이템의 값으로 채울 호스트 인벤토리 필드를 선택할 수 있습니다. 이는 호스트에 대해 자동 인벤토리 채우기가 활성화된 경우 작동합니다.
이 필드는 정보 유형이 '로그'로 설정된 경우 사용할 수 없습니다.
설명 아이템 설명을 입력합니다. 사용자 매크로를 지원합니다.
활성화 아이템이 처리되도록 활성화하려면 확인란을 표시합니다.
최신 데이터 아이템의 최신 데이터를 보려면 링크를 클릭합니다.
이 링크는 이미 존재하는 아이템을 편집할 때만 사용할 수 있습니다.

아이템 유형별 필드는 해당 페이지에서 설명됩니다.

호스트 수준에서 기존 템플릿 수준 아이템을 편집할 때, 여러

아이템 값 전처리

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

아이템 테스트

아이템 테스트를 수행하려면 서버와 프록시의 시스템 시간이 동기화되어 있는지 확인하세요. 서버 시간이 뒤처져 있는 경우 아이템 테스트에서 "작업이 만료되었습니다."라는 오류 메시지가 반환될 수 있습니다. 하지만 서버와 프록시에 다른 시간대를 설정한 경우에는 테스트 결과에 영향을 주지 않습니다.

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

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

다음 패시브 아이템 타입에서 아이템 테스트가 가능합니다:

  • 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 매크로인 필드는 비어 있으며 수동으로 입력해야 합니다. 아이템 매개변수에 비밀 매크로 값이 포함된 경우 다음 경고 메시지가 표시됩니다: "아이템에 비밀 값을 가진 사용자 정의 매크로가 포함되어 있습니다. 이러한 매크로의 값은 수동으로 입력해야 합니다."
  • 아이템 타입의 컨텍스트에서 필요하지 않은 필드는 비활성화됩니다(예: 계산 아이템의 경우 호스트 주소 필드와 프록시 필드가 비활성화됨)

아이템을 테스트하려면 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 (only 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초마다 재계산됩니다(자세한 내용은 트리거 계산 시간 참조).

다음 단계는?