전처리 테스트

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

테스트

전처리 단계를 테스트하면 아이템 값이 수신되어 전처리되기를 기다리지 않고도 복잡한 전처리 파이프라인이 기대한 결과를 산출하는지 확인할 수 있어 유용합니다.

다음 방식으로 테스트할 수 있습니다:

  • 가상의 값에 대해
  • 호스트의 실제 값에 대해

각 전처리 단계는 개별적으로 테스트할 수도 있고 모든 단계를 함께 테스트할 수도 있습니다. Actions 블록에서 Test 또는 Test all steps 버튼을 각각 클릭하면 테스트 창이 열립니다.

가상의 값 테스트

매개변수 설명
Get value from host 가상의 값을 테스트하려면 이 체크박스를 선택하지 마세요.
참고: 실제 값 테스트.
Value 테스트할 입력값을 입력하세요.
매개변수 필드나 보기/편집 버튼 을 클릭하면 값이나 코드 블록을 입력할 수 있는 텍스트 영역 창이 열립니다.
Not supported 지원되지 않는 값을 테스트하려면 이 체크박스를 선택하세요.
이 옵션은 Check for not supported value 전처리 단계를 테스트할 때 유용합니다.
Error 오류 텍스트를 입력하세요.
이 필드는 Get value from host가 선택 해제되어 있고 Not supported가 선택된 경우 활성화됩니다.
Get value from host가 선택된 경우, 이 필드에는 호스트로부터 받은 실제 오류 메시지가 채워지며 읽기 전용입니다.
Time 입력값의 시간이 표시됩니다: now (읽기 전용).
Previous value 비교할 이전 입력값을 입력하세요.
Change 및 Throttling 전처리 단계에서만 사용됩니다.
Previous time 비교할 이전 입력값의 시간을 입력하세요.
Change 및 Throttling 전처리 단계에서만 사용됩니다.
기본값은 아이템의 'Update interval' 필드 값을 기준으로 합니다(예: '1m'이면 이 필드는 now-1m으로 채워집니다). 아무것도 지정되지 않았거나 사용자가 해당 호스트에 접근 권한이 없는 경우 기본값은 now-30s입니다.
Macros 매크로가 사용된 경우 해당 값과 함께 목록으로 표시됩니다. 이 값들은 테스트 목적으로 편집할 수 있지만, 변경 사항은 테스트 컨텍스트 내에서만 저장됩니다.
End of line sequence 여러 줄 입력값에 대한 줄 끝 시퀀스를 선택하세요:
LF - LF(줄 바꿈) 시퀀스
CRLF - CRLF(캐리지 리턴-줄 바꿈) 시퀀스.
Preprocessing steps 전처리 단계가 목록으로 표시되며, Test 버튼을 클릭한 후 각 단계별 테스트 결과가 표시됩니다.
테스트 결과가 프런트엔드로 전송될 때 최대 512KB로 잘립니다. 테스트 결과는 복사할 수 있습니다(잘린 512KB 이하까지만). 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서는 여전히 전부 처리된다는 점에 유의하세요.
해당 단계가 테스트에서 실패한 경우 오류 아이콘이 표시됩니다. 마우스를 올리면 오류 설명이 표시됩니다.
해당 단계에 "Custom on fail"이 지정되어 있고 그 동작이 수행된 경우, 전처리 테스트 단계 행 바로 다음에 새 줄이 나타나 어떤 동작이 수행되었고 어떤 결과(오류 또는 값)가 산출되었는지 보여줍니다.
Result 모든 단계를 함께 테스트하는 경우(즉, Test all steps 버튼을 클릭한 경우) 전처리 단계 테스트의 최종 결과가 항상 표시됩니다.
아이템의 값 유형으로 변환되는 방식도 표시됩니다. 예를 들어 Result converted to Numeric (unsigned)와 같이 표시됩니다.
테스트 결과가 프런트엔드로 전송될 때 최대 512KB로 잘립니다. 최종 결과는 복사할 수 있습니다(잘린 512KB 이하까지만). 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서는 여전히 전부 처리된다는 점에 유의하세요.

각 전처리 단계 이후의 결과를 확인하려면 Test를 클릭하세요.

테스트 값은 개별 단계 또는 모든 단계에 대해 테스트 세션 사이에 저장되므로, 사용자가 전처리 단계나 아이템 구성을 변경한 뒤 정보를 다시 입력할 필요 없이 테스트 창으로 돌아올 수 있습니다. 다만 페이지를 새로고침하면 값이 사라집니다.

테스트는 Zabbix 서버가 수행합니다. 프런트엔드는 해당 요청을 서버로 보내고 결과를 기다립니다. 요청에는 입력값과 전처리 단계(사용자 매크로가 확장된 상태)가 포함됩니다. Change 및 Throttling 단계의 경우, 선택적으로 이전 값과 시간을 지정할 수 있습니다. 서버는 각 전처리 단계에 대한 결과를 응답합니다.

모든 기술적 오류나 입력 유효성 검사 오류는 테스트 창 상단의 오류 박스에 표시됩니다.

실제 값 테스트

실제 값을 대상으로 전처리를 테스트하려면:

  • Get value from host 체크박스를 선택합니다
  • 호스트 매개변수(호스트 주소, 포트, 프록시 이름/프록시 없음)와 아이템별 세부 정보(SNMPv2 커뮤니티나 SNMPv3 보안 자격 증명 등)를 입력하거나 확인합니다. 이 필드들은 컨텍스트를 인식합니다:
    • 가능한 경우 값이 미리 채워집니다. 예를 들어 에이전트가 필요한 아이템의 경우 선택된 호스트의 에이전트 인터페이스 정보를 가져와 채워집니다
    • 템플릿 아이템의 경우 값을 수동으로 입력해야 합니다
    • 일반 텍스트 매크로 값은 해석되어 표시됩니다
    • 필드 값(또는 값의 일부)이 시크릿 또는 Vault 매크로인 경우 해당 필드는 비어 있으며 수동으로 입력해야 합니다. 아이템 매개변수에 시크릿 매크로 값이 포함된 경우 다음 경고 메시지가 표시됩니다: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
    • 해당 아이템 유형의 컨텍스트에서 필요하지 않은 필드는 비활성화됩니다 (예: 계산형 아이템의 경우 호스트 주소와 프록시 필드가 비활성화됩니다)
  • 전처리를 테스트하려면 Get value and test를 클릭하세요

아이템 구성 폼에서 값 매핑을 지정한 경우(Show value 필드), 아이템 테스트 대화 상자에는 최종 결과 다음에 'Result with value map applied'라는 이름의 추가 줄이 표시됩니다.

호스트로부터 실제 값을 가져오는 것과 관련된 매개변수는 다음과 같습니다:

매개변수 설명
Get value from host 호스트로부터 실제 값을 가져오려면 이 체크박스를 선택하세요.
Host address 호스트 주소를 입력하세요.
이 필드는 아이템 호스트 인터페이스의 주소로 자동 채워집니다.
Port 호스트 포트를 입력하세요.
이 필드는 아이템 호스트 인터페이스의 포트로 자동 채워집니다.
Additional fields for SNMP interfaces
(SNMP version, SNMP community, Context name, etc.)		 SNMP 인터페이스(v1, v2, v3) 구성에 대한 자세한 내용은 SNMP 모니터링 구성을 참고하세요.
이 필드들은 아이템 호스트 인터페이스로부터 자동으로 채워집니다.
Proxy 호스트가 프록시에 의해 모니터링되는 경우 프록시를 지정하세요.
이 필드는 호스트의 프록시(있는 경우)로 자동 채워집니다.
Value 호스트에서 가져온 값입니다.
매개변수 필드나 보기/편집 버튼 을 클릭하면 값이나 코드 블록의 텍스트 영역 창이 열립니다.
값은 프런트엔드에서만 최대 512KB로 잘립니다. 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서는 여전히 전부 처리된다는 점에 유의하세요.

나머지 매개변수에 대해서는 위의 가상의 값 테스트를 참고하세요.