AgentNowHandler - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • AgentNowHandler 스크립트 포함은 요청 시 검사 정의를 실행하고, 요청 시 실행 및 테스트 검사 실행의 상태를 확인하고, 요청 시 실행된 백그라운드 확인을 중지할 수 있는 메서드를 제공합니다.

    이 스크립트 포함에는 프레임워크(sn_agent) 스토어 애플리케이션이 필요하며 에이전트 클라이언트 수집기sn_agent 네임스페이스 내에서 제공됩니다. 자세한 내용은 에이전트 클라이언트 수집기를 참조하십시오.

    REST API 솔루션은 에이전트 클라이언트 수집기 API를 참조하십시오.

    AgentNowHandler - AgentNowHandler()

    AgentNowHandler 인스턴스를 작성합니다.

    표 1. 매개변수
    이름 유형 설명
    없음

    다음 예제에서는 AgentNowHandler를 초기화하는 방법을 보여 줍니다.

    var handler = new sn_agent.AgentNowHandler();

    AgentNowHandler - getRequestStatus(문자열 requestId)

    지정된 ID로 요청 상태를 가져옵니다.

    표 2. 매개변수
    이름 유형 설명
    requestId 문자열 runCheckForCis() 메서드를 호출하여 생성된 검사 요청 ID입니다.
    표 3. 반환
    속성 설명
    객체 요청 상태 및 적용 가능한 오류 메시지입니다.
    상태 요청 상태입니다.
    가능한 값:
    • done – 확인이 성공했습니다.
    • 실패 – 확인에 실패했습니다. 자세한 내용은 오류 메시지를 참조하십시오.
    • mid_flow – MID Server에서 요청 출력을 처리 중입니다.
    • 처리 중 – 확인이 진행 중입니다.
    • timeout – runCheckForCis() 메서드에 설정된 시간 제한을 초과했는지 확인합니다.

    데이터 유형: 문자열
    err_msg 오류 메시지(있는 경우)
    가능한 값:
    • 관련 CI에 대한 에이전트를 찾을 수 없습니다.
    • 지정된 ID로 신원 확인 요청이 없습니다.
    • 지정된 ID의 요청이 없습니다.
    • 지정된 ID에 테스트 결과가 없습니다.
    • 요청 시간 제한.

    데이터 유형: 문자열

    다음 예제에서는 요청의 상태를 가져오는 방법을 보여 줍니다.

    var handler = new sn_agent.AgentNowHandler();
var check = {checkDefId: "158279505372b30034b8ddeeff7b1270"};
var computerGr = new GlideRecord("cmdb_ci_computer");
computerGr.query();
var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

var reqStatusJson = handler.getRequestStatus(requestId);
gs.info(JSON.stringify(reqStatusJson));

    AgentNowHandler - getTestResultStatus(문자열 testResultId)

    지정된 테스트 결과의 테스트 검사 상태를 가져옵니다.

    표 4. 매개변수
    이름 유형 설명
    테스트 결과 ID 문자열 테스트 검사 요청을 생성하여 생성된 테스트 결과 ID입니다.
    표 5. 반환
    속성 설명
    상태 테스트 결과의 상태입니다.
    가능한 값:
    • 0: 보류 중
    • 1: 진행 중
    • 2: 완료
    • 3: 지정된 ID로 테스트 결과 없음

    데이터 유형: 문자열
    출력 상태를 설명하는 출력입니다.

    데이터 유형: 문자열

    다음 예제에서는 완료된 테스트 검사 요청의 결과 상태를 가져오는 방법을 보여줍니다.

    var testCheckStatusJson = handler.getTestResultStatus("testResultId");
gs.info(JSON.stringify(testCheckStatusJson));

    AgentNowHandler - runCheckForCis(객체 ci, 객체 검사, 번호 우선순위, 번호 시간 초과)

    지정된 구성 항목에 대해 검사를 실행합니다.

    표 6. 매개변수
    이름 유형 설명
    CI GlideRecord 검사가 작동하는 모든 CMDB 테이블(모든 애플리케이션, 호스트 또는 에이전트)의 GlideRecord
    검사 객체 검사 ID 및 선택적 검사 매개변수입니다. 
    "check": {
  "checkDefId": "String",
  "params": {Object}
}
    check.checkDefId 문자열 검사 정의 [sn_agent_check_def] 테이블의 검사 정의 Sys_id입니다.
    check.params 객체 옵션입니다. 매개변수 이름 및 값의 맵입니다. 이러한 설정을 사용하여 검사 정의와 지정된 값의 매개변수 기록을 재정의할 수 있습니다. 
    "params": {
  "<parameter name>": "String"
}
    우선순위 번호 ECC 큐에 설정할 요청의 우선순위입니다.
    가능한 값:
    • 0: 대화형
    • 1: 긴급 처리
    • 2: 표준
    시간 제한 번호 요청에 대한 시간 제한 값(초)입니다.
    표 7. 반환
    유형 설명
    문자열 생성된 백그라운드 확인 요청의 Sys_id입니다.

    다음 예제에서는 백그라운드 확인을 실행하고 요청 ID를 가져오는 방법을 보여 줍니다.

    var handler = new sn_agent.AgentNowHandler();
var check = {checkDefId: "028fcd5067c80010b7b72dbd2685ef4f"};
var computerGr = new GlideRecord("cmdb_ci_computer");
computerGr.query();
var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

gs.info(requestId);

    출력:

    b9cf14aedb5e30106f4810284b961990

    AgentNowHandler - stopBackgroundCheck(문자열 requestId)

    백그라운드 확인을 중지합니다.

    백그라운드 확인을 시작하려면 runCheckForCis() 메서드를 사용합니다.

    표 8. 매개변수
    이름 유형 설명
    requestId 문자열 runCheckForCis() 메서드를 호출하여 생성된 백그라운드 확인 요청의 ID입니다.
    표 9. 반환
    유형 설명
    없음

    다음 예제에서는 백그라운드 확인 실행을 중지하는 방법을 보여 줍니다.

    handler.stopBackgroundCheck(backRequestId);