---
sourceDocument: 호주 IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/it-operations-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# 에이전트 클라이언트 수집기 검사 정의 페이지

# 에이전트 클라이언트 수집기 검사 정의 페이지 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

검사 정의를 생성할 때 검사 정의 페이지에서 구성할 필드입니다.
{#check-definition-form__table_ntn_dwf_vyb__entry__2}

| 필드 | 설명 |
|-|-|
| 이름 | 검사를 설명하는 이름입니다. |
| 검사 유형 | 검사 유형을 선택합니다. 사용 가능한 모니터링 옵션은 다음과 같습니다. * 이벤트 * 메트릭 {#check-definition-form__ul_pcv_2wf_vyb} |
| 활성 | 검사를 활성화하려면 선택합니다. |
| 프록시 유효 여부 | 검사 정책이 프록시로 작동하도록 설정되었음을 나타내려면 선택합니다. 검사 인스턴스에서 이 옵션을 볼 때 읽기 전용입니다. |
| 명령 자동 생성 | 명령 프리픽스 값과 매개변수 탭 값을 사용하여 명령을 자동으로 생성하려면 선택합니다. |
| 명령 프리픽스 | 명령 자동 생성 확인란을 선택할 때 자동 생성에 사용되는 명령입니다. 프리픽스는 스크립트 이름과 같이 정적(변경되지 않는) 명령의 일부로 구성됩니다. |
| 명령 | * 에이전트 클라이언트 수집기가 실행하는 명령을 입력합니다. 주: 명령 자동 생성 확인란을 선택하면 이 필드는 자동으로 매개변수 탭에 지정된 활성 매개변수의 프리픽스와 플래그로 채워집니다. * 이 필드에는 다음 중 하나 이상에서 가져온 매개변수가 있습니다. * 단순 템플릿: `{{.labels.params_field_name}}`: 매개변수 탭의 항목에서 값을 가져옵니다. 예를 들어 `{{.labels.params_warning}}`의 문자열은 warning 매개변수 값이 사용됨(매개변수 탭에서 구성된 경우)을 의미합니다. * 모니터링된 CI: `{{.labels.params_ci_field_name}}`: 모니터링된 CI에서 자동으로 값을 가져옵니다. 여기서 `field_name`은 CI 테이블에 있는 필수 필드의 정확한 이름으로 대체됩니다. {#check-definition-form__ul_rcv_2wf_vyb} {#check-definition-form__ul_qcv_2wf_vyb} |
| 구성 데이터 파일 | 검사가 실행될 때 다운로드할 구성 데이터 파일을 선택합니다. |
| 설명 | 검사에 대한 설명입니다. |
| 실행 모드 | 검사의 실행 모드입니다. 사용할 수 있는 옵션은 다음과 같습니다. * shell: 지원 execv하지 않는 검사에 사용됩니다. * execv: 검사 실행 중에 향상된 보안을 제공합니다. {#check-definition-form__ul_scv_2wf_vyb} 기본 실행 모드는 다음과 같습니다. * 기존 검사 정의: shell * 새 검사 정의: execv * 필드에 값을 입력하지 않은 경우: shell {#check-definition-form__ul_tcv_2wf_vyb} 버전 2.9.0으로 업그레이드할 때 이 필드가 읽기 전용인 경우 Now Support지식베이스의 (KB1122498) 문서에 설명된 대로 읽기 전용 상태를 비활성화해야 합니다. |
| 간격 | 검사 실행 사이에 대기하는 시간(초)입니다. 예를 들어 값이 60이면 검사가 60초마다 실행됩니다. 지정된 값은 정수여야 합니다. |
| 시간 제한 | 출력이 반환되지 않을 때 검사 실행이 중지되기까지의 시간(초)입니다. 예를 들어 값이 60이면 검사 실행이 60초 동안 값을 반환하지 않으면 실행이 중지됩니다. |
| 이벤트 상태 변경 임계치 | 새 이벤트가 전송되기 전에 검사의 응답 상태가 발생해야 하는 연속 횟수입니다. 예를 들어, 이 값이 5로 설정되어 있는 경우 응답 상태가 확인에서 오류로 변경되는 검사는 상태 변경이 다섯 번 연속 발생한 후에만 오류 상태인 새 이벤트를 생성합니다. 에이전트를 다시 시작하면 항상 초기 이벤트가 전송됩니다. 기본값: 5(AWS 이벤트 정책 제외) |
| 이벤트 상태 복구 임계치 | 이전 이벤트를 종결하기 위해 검사 응답 상태가 개선되어야 하는 연속 횟수입니다. 예를 들어, 이 값이 3으로 설정되어 있는 경우 응답 상태가 오류 에서 확인 으로 변경되는 검사는 이전 이벤트를 종결하고 상태 변경이 세 번 연속 발생한 후에만 확인 상태의 새 이벤트를 생성합니다. 기본값: 1(이벤트 정책 제외 AWS ) |
| 자격 증명 실패 정규 표현식 | 자격 증명 오류로 인해 검사가 실패했음을 나타내는 검사 출력의 문자열입니다. 그런 다음 에이전트는 올바른 자격 증명을 찾을 때까지 자격 증명 별칭의 일부인 자격 증명을 계속 검색합니다. 이 필드는 검사 정책에서 자격 증명 별칭을 사용할 때 관련 있는 필수 항목입니다. 새 검사를 만들 때 문자열을 수동으로 입력합니다. |
| 플러그인 | 검사와 연결할 플러그인을 선택합니다. 이 작업을 완료하면 플러그인이 다운로드된 후 검사가 실행됩니다. |
[표 1. 검사 정의 양식]

{#check-definition-form__table_ntn_dwf_vyb}
* **[검사 정의 양식 매개변수 탭](https://servicenow-prod.fluidtopics.net/s2CW~7z8nASXiyBuWB83JA)**   
  검사 정의 양식의 명령 필드에 대한 매개변수 탭 정의입니다.
* **[테스트 검사 대화 상자 필드](https://servicenow-prod.fluidtopics.net/RskfvJyMpyyboWUKVBUe9A)**   
  검사 정의를 테스트할 때의 대화 상자 필드입니다.