아이템 생성
개요
Zabbix 프런트엔드에서 아이템을 생성하려면 다음과 같이 하십시오:
- Data collection > Hosts로 이동
- 호스트 행에서 Items 클릭
- 화면 우측 상단의 Create item 클릭
- 폼에 아이템의 매개변수 입력
기존 아이템을 열어 Clone 버튼을 클릭한 다음 다른 이름으로 저장하여 아이템을 생성할 수도 있습니다.
설정
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 - 선택적 로그 관련 속성(timestamp, source, severity, logeventid)이 있는 긴 텍스트 데이터. Text - 긴 텍스트 데이터. 텍스트 데이터 제한도 참고하십시오. Binary - 이진수(종속 아이템에서만 지원). 이진 데이터 유형 값을 반환하는 아이템은 계산된 아이템 수식이나 트리거 표현식에서 지원되지 않습니다. 하나의 특정 형식으로만 데이터를 반환하는 아이템 키의 경우, 일치하는 정보 유형이 자동으로 선택됩니다. |
| Host interface | 호스트 인터페이스를 선택하십시오. 이 필드는 호스트 레벨에서 아이템을 편집할 때 사용할 수 있습니다. |
| Units | 단위 기호가 설정되면 Zabbix는 수신된 아이템 값에 후처리를 적용하고 지정된 단위 접미사와 함께 표시합니다. 특수 형식을 지원하는 단위 기호(수신된 아이템 값 → 표시되는 값의 예): B - 바이트(1024 → 1 KB) Bps - 초당 바이트(1024 → 1 KBps) s - 초, 0이 아닌 가장 큰 시간 단위 최대 3개로 표시(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이 아닌 값을 가진 커스텀 간격(flexible 또는 scheduled)이 존재하면, 아이템은 해당 커스텀 간격 동안 폴링됩니다. 참고 아이템이 활성화된 후 또는 업데이트 간격이 변경된 후의 첫 번째 아이템 폴링은 설정된 값보다 더 일찍 발생할 수 있습니다. Scheduling 또는 Flexible 업데이트 간격이 있고 Update interval이 0으로 설정된 경우가 아니라면, 새 아이템은 생성 후 60초 이내에 확인됩니다. 기존의 passive 아이템은 Execute now 버튼을 눌러 즉시 값을 폴링할 수 있습니다. |
| Custom intervals | 아이템 확인을 위한 커스텀 규칙을 생성할 수 있습니다: Flexible - Update interval에 대한 예외를 생성합니다(다른 빈도의 간격). Scheduling - 커스텀 폴링 스케줄을 생성합니다. 자세한 내용은 Custom intervals를 참고하십시오. 시간 접미사는 Interval 필드에서 지원됩니다. 예: 30s, 1m, 2h, 1d. 사용자 매크로를 지원합니다. 단일 매크로는 필드 전체를 채워야 합니다. 필드 안에 여러 매크로를 넣거나 매크로와 텍스트를 혼합하는 것은 지원되지 않습니다. |
| Timeout | 아이템 확인 타임아웃을 설정합니다(지원되는 아이템 유형에서 사용 가능). 타임아웃 옵션을 선택하십시오: Global - 프록시/전역 타임아웃이 사용됩니다(회색으로 표시된 Timeout 필드에 표시됨). Override - 커스텀 타임아웃이 사용됩니다(Timeout 필드에 설정; 허용 범위: 1 - 600초). 시간 접미사(예: 30s, 1m)와 사용자 매크로를 지원합니다. Timeouts 링크를 클릭하면 프록시 타임아웃 또는(프록시를 사용하지 않는 경우) 전역 타임아웃을 설정할 수 있습니다. Timeouts 링크는 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).데이터베이스의 값 히스토리 크기를 줄이기 위해 가능한 한 짧은 기간 동안만 값을 기록하는 것을 권장합니다. 값의 긴 히스토리를 저장하는 대신, 더 긴 기간의 트렌드 데이터를 저장할 수 있습니다. History and trends도 참고하십시오. |
| Trends | 다음 중 하나를 선택하십시오: Do not store - 트렌드를 저장하지 않습니다. 이 설정은 전역 하우스키퍼 설정으로 재정의할 수 없습니다. Store up to - 데이터베이스에 집계된(시간별 최소, 최대, 평균, 개수) 히스토리를 보관하는 기간을 지정합니다(1일에서 25년까지). 더 오래된 데이터는 하우스키퍼가 삭제합니다. 초 단위로 저장됩니다. 시간 접미사를 지원합니다. 예: 24h, 1d. 사용자 매크로를 지원합니다. Store up to 값은 Administration > Housekeeping에서 전역적으로 재정의할 수 있습니다. 전역 재정의 설정이 존재하는 경우, 주황색 정보 아이콘이 표시됩니다. 마우스를 올리면 경고 메시지가 표시됩니다. 예: Overridden by global housekeeper settings (7d).참고: 트렌드 보관은 숫자가 아닌 데이터(character, log, text)에는 사용할 수 없습니다. History and trends도 참고하십시오. |
| Value mapping | 이 아이템에 값 매핑을 적용합니다. 값 매핑은 수신된 값을 변경하지 않으며, 데이터 표시 용도로만 사용됩니다. Numeric(unsigned), Numeric(float), Character 아이템에서 동작합니다. 예: "Windows service states". |
| Log time format | Log 유형의 아이템에서만 사용할 수 있습니다. 지원되는 플레이스홀더: 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개의 문자 위치로 시작하고, 그 뒤에 날짜, 시간, 나머지 메시지가 이어집니다. 이 라인의 log time format은 "pppppp:yyyyMMdd:hhmmss"가 됩니다. "p"와 ":" 문자는 플레이스홀더이며 "yMdhms"를 제외한 어떤 문자든 될 수 있습니다. |
| Populates host inventory field | 아이템 값이 채울 호스트 인벤토리 필드를 선택할 수 있습니다. 이는 호스트에 자동 인벤토리 채우기가 활성화된 경우 동작합니다. Type of information이 'Log'로 설정된 경우 이 필드는 사용할 수 없습니다. |
| Description | 아이템 설명을 입력하십시오. 사용자 매크로를 지원합니다. |
| Enabled | 체크박스를 표시하여 아이템을 활성화하면 처리됩니다. 아이템을 비활성화하면, 마지막 값(로그의 경우 유지됨)을 제외하고 히스토리 캐시에서 즉시 제거됩니다. |
| Latest data | 링크를 클릭하여 아이템의 최신 데이터를 확인하십시오. 이 링크는 이미 존재하는 아이템을 편집할 때만 사용할 수 있습니다. |
아이템 유형별 필드는 해당 페이지에 설명되어 있습니다.
호스트 레벨에서 기존 템플릿 레벨 아이템을 편집할 때, 여러 필드가 읽기 전용입니다. 폼 헤더의 링크를 사용하여 템플릿 레벨로 이동하여 편집할 수 있으며, 템플릿 레벨에서의 변경은 해당 템플릿이 연결된 모든 호스트의 아이템을 변경한다는 점에 유의하십시오.
Tags 탭에서는 아이템 레벨 태그를 정의할 수 있습니다.
아이템 값 전처리
Preprocessing 탭에서는 수신된 값에 대한 변환 규칙을 정의할 수 있습니다.
아이템 테스트
아이템 테스트를 수행하려면, 서버와 프록시의 시스템 시간이 동기화되어 있는지 확인하십시오. 서버 시간이 뒤처져 있는 경우, 아이템 테스트에서 "The task has been expired." 오류 메시지가 반환될 수 있습니다. 그러나 서버와 프록시에 서로 다른 시간대를 설정하는 것은 테스트 결과에 영향을 주지 않습니다.
아이템을 테스트할 수 있으며, 올바르게 설정된 경우 실제 값을 반환받을 수 있습니다. 테스트는 아이템이 저장되기 전에도 수행할 수 있습니다.
테스트는 호스트 및 템플릿 아이템, 아이템 프로토타입, low-level discovery 규칙에서 사용할 수 있습니다. active 아이템에서는 테스트를 사용할 수 없습니다.
아이템 테스트는 다음 passive 아이템 유형에서 사용할 수 있습니다:
- 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 버튼을 클릭하십시오. 테스트할 수 없는 아이템(예: active checks, 제외된 simple checks)의 경우 Test 버튼이 비활성화되어 있다는 점에 유의하십시오.
아이템 테스트 폼에는 필요한 호스트 매개변수(호스트 주소, 포트, 서버/프록시로 테스트(프록시 이름))와 아이템별 세부 정보(예: SNMPv2 community 또는 SNMPv3 보안 자격 증명)에 대한 필드가 있습니다. 이 필드들은 상황에 맞게 동작합니다:
- agent가 필요한 아이템의 경우 선택된 호스트의 agent 인터페이스 정보를 가져와, 가능한 경우 값이 미리 채워집니다.
- 템플릿 아이템의 경우 값을 수동으로 입력해야 합니다.
- 일반 텍스트 매크로 값은 해석됩니다.
- 값(또는 값의 일부)이 secret 또는 Vault 매크로인 필드는 비어 있으며 수동으로 입력해야 합니다. 아이템 매개변수에 secret 매크로 값이 포함된 경우, 다음 경고 메시지가 표시됩니다: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
- 아이템 유형의 맥락에서 필요하지 않은 경우 필드가 비활성화됩니다(예: calculated 아이템의 경우 호스트 주소 필드와 프록시 필드가 비활성화됨)
아이템을 테스트하려면 Get value를 클릭하십시오. 값을 성공적으로 가져오면 Value 필드에 채워지고, 기존 값(있는 경우)은 Previous value 필드로 이동하며, 동시에 Prev. time 필드(두 값(클릭) 사이의 시간 차이)를 계산하고, 수신된 값에서 "\n\r"이 감지되면 EOL 시퀀스를 감지하여 CRLF로 전환을 시도합니다.
전처리를 테스트하려면 Get value and test를 클릭하십시오.
호스트에서 가져온 값과 테스트 결과는 프런트엔드로 전송될 때 최대 512KB로 잘립니다. 결과가 잘린 경우 경고 아이콘이 표시됩니다. 경고 설명은 마우스오버 시 표시됩니다. 512KB보다 큰 데이터도 Zabbix server에서는 여전히 완전히 처리된다는 점에 유의하십시오.
설정이 올바르지 않으면, 가능한 원인을 설명하는 오류 메시지가 표시됩니다.
호스트에서 성공적으로 가져온 값은 전처리 단계 테스트에도 사용할 수 있습니다.
폼 버튼
폼 하단의 버튼으로 여러 작업을 수행할 수 있습니다.
 |
아이템을 추가합니다. 이 버튼은 새 아이템에서만 사용할 수 있습니다. |
 |
아이템의 속성을 업데이트합니다. |
 |
현재 아이템의 속성을 기반으로 다른 아이템을 생성합니다. |
 |
새 아이템 값에 대한 확인을 즉시 실행합니다. passive 확인에서만 지원됩니다(자세한 내용 참고). 참고 즉시 값을 확인할 때 설정 캐시는 업데이트되지 않으므로, 값이 아이템 설정에 대한 최근 변경 사항을 반영하지 않을 수 있습니다. |
 |
값을 가져와 아이템 설정이 올바른지 테스트합니다. |
 |
아이템 히스토리와 트렌드를 삭제합니다. |
 |
아이템을 삭제합니다. |
 |
아이템 속성 편집을 취소합니다. |
텍스트 데이터 제한
텍스트 데이터 제한은 데이터베이스 백엔드에 따라 다릅니다. 텍스트 값을 데이터베이스에 저장하기 전에, 데이터베이스 값 유형 제한에 맞게 잘립니다:
| 데이터베이스 | Type of information | < | < |
|---|---|---|---|
| Character | Log | Text | |
| MySQL | 255자 | 65536바이트 | 65536바이트 |
| PostgreSQL | 255자 | 65536자 | 65536자 |
| SQLite (Zabbix proxy 전용) | 255자 | 65536자 | 65536자 |
커스텀 스크립트 제한
사용 가능한 커스텀 스크립트 길이는 사용하는 데이터베이스에 따라 다릅니다:
| 데이터베이스 | 문자 수 제한 | 바이트 제한 |
|---|---|---|
| MySQL | 65535 | 65535 |
| PostgreSQL | 65535 | 제한 없음 |
| SQLite (Zabbix proxy 전용) | 65535 | 제한 없음 |
아이템 타임아웃
아이템 타임아웃은 Zabbix가 확인을 실패로 중단하기 전까지 얼마나 기다릴지를 지정합니다.
타임아웃에 도달하면, 데이터 검색이 완료되지 않았더라도 확인은 중단됩니다. 데이터가 부분적으로 수신된 경우, 아이템은 지원되지 않음 상태가 되고 오류 메시지가 기록됩니다(예: SNMP 확인에서 여러 OID 중 하나에 대해서만 데이터가 성공적으로 수집된 경우).
많은 아이템 유형에서 flexible 아이템 타임아웃을 설정할 수 있습니다:
단일 아이템별 커스텀 타임아웃은 다른 아이템의 타임아웃을 낮게 유지하면서 특정 아이템에 더 긴 타임아웃을 지정하고 싶을 때 유용합니다.
타임아웃 우선순위
- 단일 아이템 타임아웃이 다른 모든 타임아웃보다 우선합니다.
- 프록시 레벨 타임아웃이 전역 타임아웃보다 우선합니다.
Zabbix server 또는 proxy 설정의 타임아웃은 flexible 타임아웃이 설정된 확인에서는 아무런 역할을 하지 않습니다.
Flexible 타임아웃 지원
Flexible 아이템 타임아웃은 다음 아이템 유형에서 지원됩니다:
- Zabbix agent(passive 및 active checks 모두)
- SNMP agent(레거시 SNMP checks^1^ 제외)
- Simple check(
icmpping*및 VMware 아이템^2^ 제외) - SSH agent
- Telnet agent
- External check
- Database monitor
- Script
- HTTP agent
- Browser
^1^ 레거시 SNMP checks(단일 OID 폴링)의 경우, server 또는 proxy의 타임아웃 설정이 적용됩니다.
^2^ icmpping* 아이템의 경우, 타임아웃 값은 아이템 키에 직접 지정됩니다. VMware 모니터링 아이템은 server 또는 proxy 설정의 자체 VMwareTimeout 매개변수를 사용합니다.
지원되지 않는 아이템
지원되지 않는 아이템은 Not supported 상태로 보고되며, 표준 Update interval에 따라 계속 재확인됩니다.
아이템은 어떤 이유로든(예: 연결 오류, 아이템을 처리할 poller가 설정되지 않음) 값을 가져올 수 없는 경우 지원되지 않는 상태가 됩니다. 또한, 히스토리 데이터를 수신하지 않는 아이템은 Not supported 상태로 남아 있습니다. 이는 예상된 동작입니다—아이템은 새롭고 유효한 히스토리 데이터를 수신할 때만 Normal 상태로 전환됩니다.
문제(problem)와 마찬가지로, 지원되지 않는 아이템은 새 데이터가 수신될 때만 재평가됩니다—해당 아이템에 대해 더 이상 사용 가능한 히스토리 데이터가 없더라도 마찬가지입니다. 즉, 아이템과 트리거는 새 데이터를 수신할 때만 상태를 변경합니다. 그러나 트리거 표현식에 날짜 및 시간 및/또는 nodata() 함수가 포함된 경우, 트리거는 30초마다 재계산됩니다(자세한 내용은 트리거 계산 시간 참고).