1 전처리 테스트

원본 보기

1 전처리 테스트

테스트

전처리 단계 테스트는 복잡한 전처리 파이프라인이 아이템 값을 수신하고 전처리될 때까지 기다리지 않고도 예상된 결과를 생성하는지 확인하는 데 유용합니다.

다음에 대해 테스트할 수 있습니다:

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

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

가상 값 테스트

매개변수 설명
호스트에서 값 가져오기 가상 값을 테스트하려면 이 체크박스를 선택하지 마세요.
참고: 실제 값 테스트.
값 테스트할 입력 값을 입력하세요.
매개변수 필드를 클릭하거나 보기/편집 버튼 을 클릭하면 값이나 코드 블록을 입력할 수 있는 텍스트 영역 창이 열립니다.
지원되지 않음 지원되지 않는 값을 테스트하려면 이 체크박스를 선택하세요.
이 옵션은 지원되지 않는 값 확인 전처리 단계를 테스트하는 데 유용합니다.
오류 오류 텍스트를 입력하세요.
이 필드는 호스트에서 값 가져오기가 선택되지 않았지만 지원되지 않음이 선택된 경우에 활성화됩니다.
호스트에서 값 가져오기가 선택되면 이 필드는 호스트의 실제 오류 메시지로 채워집니다(읽기 전용).
시간 입력 값의 시간이 표시됩니다: now (읽기 전용).
이전 값 비교할 이전 입력 값을 입력하세요.
변경 및 조절 전처리 단계에서만 사용됩니다.
이전 시간 비교할 이전 입력 값의 시간을 입력하세요.
변경 및 조절 전처리 단계에서만 사용됩니다.
기본값은 아이템의 '업데이트 간격' 필드 값을 기반으로 합니다('1m'인 경우 이 필드는 now-1m으로 채워집니다). 지정되지 않았거나 사용자가 호스트에 액세스할 수 없는 경우 기본값은 now-30s입니다.
매크로 매크로가 사용되는 경우 해당 값과 함께 나열됩니다. 값은 테스트 목적으로 편집할 수 있지만 변경 사항은 테스트 컨텍스트 내에서만 저장됩니다.
줄 끝 시퀀스 여러 줄 입력 값에 대한 줄 끝 시퀀스를 선택하세요:
LF - LF (line feed) 시퀀스
CRLF - CRLF (carriage-return line-feed) 시퀀스.
전처리 단계 전처리 단계가 나열되며 테스트 버튼을 클릭한 후 각 단계에 대한 테스트 결과가 표시됩니다.
테스트 결과는 프론트엔드로 전송될 때 최대 512KB로 잘립니다. 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서 완전히 처리됩니다.
테스트에서 단계가 실패한 경우 오류 아이콘이 표시됩니다. 마우스를 올리면 오류 설명이 표시됩니다.
단계에 대해 "실패 시 사용자 정의"가 지정되고 해당 작업이 수행되는 경우, 전처리 테스트 단계 행 바로 다음에 새 줄이 나타나 수행된 작업과 생성된 결과(오류 또는 값)를 보여줍니다.
결과 모든 단계를 함께 테스트할 때(모든 단계 테스트 버튼을 클릭할 때) 전처리 단계 테스트의 최종 결과가 모든 경우에 표시됩니다.
아이템 값 유형으로의 변환 유형도 표시됩니다(예: Result converted to Numeric (unsigned)).
테스트 결과는 프론트엔드로 전송될 때 최대 512KB로 잘립니다. 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서 완전히 처리됩니다.

각 전처리 단계 후의 결과를 보려면 테스트를 클릭하세요.

테스트 값은 개별 단계 또는 모든 단계에 대한 테스트 세션 간에 저장되어 사용자가 전처리 단계나 아이템 구성을 변경한 후 정보를 다시 입력하지 않고도 테스트 창으로 돌아갈 수 있습니다. 하지만 페이지를 새로 고치면 값이 손실됩니다.

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

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

실제 값 테스트

실제 값에 대한 전처리를 테스트하려면:

  • 호스트에서 값 가져오기 체크박스를 선택하세요
  • 호스트 매개변수(호스트 주소, 포트, 프록시 이름/프록시 없음)와 아이템별 세부 정보(SNMPv2 커뮤니티 또는 SNMPv3 보안 자격 증명 등)를 입력하거나 확인하세요. 이러한 필드는 컨텍스트 인식적입니다:
    • 가능할 때 값이 미리 채워집니다. 즉, 에이전트가 필요한 아이템의 경우 호스트의 선택된 에이전트 인터페이스에서 정보를 가져옵니다
    • 템플릿 아이템의 경우 값을 수동으로 입력해야 합니다
    • 일반 텍스트 매크로 값이 해석됩니다
    • 필드 값(또는 값의 일부)이 secret 또는 Vault 매크로인 경우 필드가 비어 있으며 수동으로 입력해야 합니다. 아이템 매개변수에 secret 매크로 값이 포함된 경우 다음 경고 메시지가 표시됩니다: "아이템에 비밀 값을 가진 사용자 정의 매크로가 포함되어 있습니다. 이러한 매크로의 값은 수동으로 입력해야 합니다."
    • 아이템 유형의 컨텍스트에서 필요하지 않을 때 필드가 비활성화됩니다(예: 계산된 아이템의 경우 호스트 주소와 프록시 필드가 비활성화됩니다)
  • 전처리를 테스트하려면 값 가져오기 및 테스트를 클릭하세요

아이템 구성 양식에서 값 매핑을 지정한 경우('값 표시' 필드), 아이템 테스트 대화상자는 최종 결과 다음에 '값 맵이 적용된 결과'라는 또 다른 줄을 표시합니다.

호스트에서 실제 값을 가져오는 것과 관련된 매개변수:

매개변수 설명
호스트에서 값 가져오기 호스트에서 실제 값을 가져오려면 이 체크박스를 선택하세요.
호스트 주소 호스트 주소를 입력하세요.
이 필드는 아이템 호스트 인터페이스의 주소로 자동으로 채워집니다.
포트 호스트 포트를 입력하세요.
이 필드는 아이템 호스트 인터페이스의 포트로 자동으로 채워집니다.
SNMP 인터페이스의 추가 필드
(SNMP 버전, SNMP 커뮤니티, 컨텍스트 이름 등)		 SNMP 인터페이스(v1, v2 및 v3) 구성에 대한 추가 세부 정보는 SNMP 모니터링 구성을 참고하세요.
이러한 필드는 아이템 호스트 인터페이스에서 자동으로 채워집니다.
프록시 호스트가 프록시로 모니터링되는 경우 프록시를 지정하세요.
이 필드는 호스트의 프록시(있는 경우)로 자동으로 채워집니다.
값 호스트에서 검색된 값입니다.
매개변수 필드를 클릭하거나 보기/편집 버튼 을 클릭하면 값이나 코드 블록의 텍스트 영역 창이 열립니다.
값은 최대 512KB로 잘리며 프론트엔드에서만 발생합니다. 결과가 잘린 경우 경고 아이콘이 표시됩니다. 마우스를 올리면 경고 설명이 표시됩니다. 512KB보다 큰 데이터도 Zabbix 서버에서 완전히 처리됩니다.

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

다음 단계는?