값 매핑

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

개요

값 매핑을 사용하면 숫자/문자열 값과 문자열 표현 간의 매핑을 통해 수신된 값을 더 사용자 친화적으로 표현하도록 설정할 수 있습니다.

예를 들어, 아이템 값이 "0" 또는 "1"인 경우, 값 매핑을 사용하여 이 값들을 더 사용자 친화적으로 표현할 수 있습니다.

  • 0 → Not Available
  • 1 → Available

데이터 백업 유형에 대한 값 매핑은 다음과 같이 구성할 수 있습니다.

  • F → Full
  • D → Differential
  • I → Incremental

전압에 대한 값 범위는 다음과 같이 구성할 수 있습니다.

  • <=209 → Low
  • 210-230 → OK
  • >=231 → High

값 매핑은 Zabbix 프런트엔드와 미디어 유형이 보내는 알림에서 사용됩니다.

수신된 값을 구성된 표현으로 치환하는 작업은 Zabbix 프런트엔드와 서버 양쪽에서 수행되지만, 서버는 다음 경우에만 치환을 처리합니다.

값 매핑은 템플릿 또는 호스트에서 설정합니다. 설정을 마치면 해당 템플릿이나 호스트에 속한 모든 아이템에서 사용할 수 있습니다. 아이템을 구성할 때 Value mapping 파라미터에 미리 구성한 값 매핑의 이름을 지정하세요.

값 맵 상속은 없습니다 - 호스트와 템플릿은 링크된 템플릿으로부터 값 매핑을 상속받지 않습니다. 호스트에 있는 템플릿 아이템은 계속해서 해당 템플릿에 구성된 값 매핑을 사용합니다.

값 매핑은 Numeric (unsigned), Numeric (float), Character 정보 유형을 가진 아이템에서 사용할 수 있습니다.

값 매핑은 해당 템플릿이나 호스트와 함께 내보내기/가져오기 됩니다. 또한 호스트 및 템플릿 일괄 업데이트 양식을 사용하여 일괄 업데이트할 수도 있습니다.

구성

값 매핑을 구성하려면 다음 단계를 따르세요.

1. 호스트 또는 템플릿 구성 양식을 엽니다.

2. Value mapping 탭에서 Add를 클릭하여 새 값 매핑을 추가하거나, 기존 매핑의 이름을 클릭하여 편집합니다.

값 매핑의 파라미터:

파라미터 < 설명
Name < 값 매핑 집합의 고유한 이름.
Mappings < 숫자/문자열 값을 문자열 표현으로 매핑하는 개별 규칙.

매핑은 드래그로 순서를 바꿀 수 있는 규칙의 순서대로 적용됩니다.
Type 매핑 유형:
equals - 같은 값이 매핑됩니다;
is greater than or equals - 같거나 더 큰 값이 매핑됩니다;
is less than or equals - 같거나 더 작은 값이 매핑됩니다;
in range - 범위 내의 값이 매핑됩니다; 범위는 <number1>-<number2> 또는 <number> 형태로 표현되며, 여러 범위도 지원됩니다(예: 1-10,101-110,201);
regexp - 정규 표현식에 해당하는 값이 매핑됩니다(전역 정규 표현식은 지원되지 않습니다);
default - 특정 매핑이 없는 나머지 모든 값이 매핑됩니다.

범위 매핑의 경우, 숫자 값 유형(is greater than or equals, is less than or equals, in range)만 지원됩니다.
^ Value 수신 값(매핑 유형에 따라 범위 또는 정규 표현식을 포함할 수 있음).
^ Mapped to 수신 값에 대한 문자열 표현(최대 64자).

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

목록에서 값 매핑을 볼 때는 처음 세 개의 매핑만 표시되며, 더 많은 매핑이 있음을 나타내는 점 세 개가 표시됩니다.

값 매핑 예시

미리 정의된 에이전트 아이템 중 하나인 Zabbix agent ping은 값을 표시하기 위해 템플릿 수준의 값 매핑 "Zabbix agent ping status"를 사용합니다.

아이템 구성 양식에서 Value mapping 필드에 이 값 매핑에 대한 참조가 있는 것을 확인할 수 있습니다.

이 매핑은 Monitoring → Latest data 섹션에서 "Up"을 표시하는 데 사용됩니다(괄호 안에 원시 값이 함께 표시됨).

Latest data 섹션에서 표시되는 값은 20자로 줄여서 표시됩니다. 값 매핑을 사용하는 경우, 이 줄임은 매핑된 값에는 적용되지 않고 괄호 안에 표시되는 원시 값에만 적용됩니다.

미리 정의된 값 매핑이 없다면, 이해하기 어려울 수 있는 "1"만 보게 될 것입니다.