Bot 에이전트 진단 점검 수행

Bot Runner 기기 및 Control Room 간의 연결 관련 문제에 대해 Bot 에이전트 진단 유틸리티를 사용합니다. 이 유틸리티는 문제 해결에 도움이 되는 솔루션이나 제안을 제공하여 문제를 진단하는 데 도움이 됩니다.

전제 조건

Bot 에이전트가 사용자 기기에 설치되어 있는지 확인합니다.

프로시저

  1. Windows 명령 프롬프트를 엽니다.
  2. Bot 에이전트 설치 경로로 이동합니다.
    • 시스템 수준에서 설치되는 Bot 에이전트의 기본 경로는 C:\Program Files\Automation Anywhere\Bot Agent입니다.
    • 로컬 사용자 수준에서 설치되는 Bot 에이전트의 기본 경로는 %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent입니다.
  3. AADiagnosticUtility.exe를 입력하여 Bot 에이전트 진단 유틸리티를 실행합니다.
    진단 검사를 수행하기 위한 다양한 옵션이 설명과 함께 표시됩니다.
    옵션 설명
    -checkDownloadError <CR_URL> Bot 배포가 실패할 경우 Bot 종속성 다운로드 오류를 확인합니다.
    주: 오류 메시지는 장치 메모리에 유지되고 Bot 에이전트 서비스가 다시 시작되면 제거됩니다.

    Bot Runner 기기가 Control Room에 연결되어 있지만 종속 패키지가 Bot Runner 기기에 다운로드되어 있지 않기 때문에 자동화에 실패할 때 이 옵션을 사용합니다. 이 경우 유틸리티는 추가 진단을 위한 제안을 제공합니다.
    -checkProxy <CR_URL> 기기의 프록시 설정을 확인합니다.

    Bot Runner 기기에서 Control Room에 연결할 수 없을 때 이 옵션을 사용하여 Bot 에이전트 사용을 위해 프록시를 사용할 수 있는지 또는 구성되었는지 확인합니다.

    importProxy 옵션을 사용하여 프록시 설정을 가져오는 옵션도 제공됩니다.

    주: 인증된 프록시에 대한 기기 프록시 설정은 Bot 에이전트 등록 프로세스 동안 설정할 수 있으며, Bot 에이전트 진단 유틸리티를 통해 업데이트할 수 있습니다. 기기의 모든 사용자에게 동일한 자격증명이 사용됩니다.
    -checkWSError <CR_URL> WebSocket 연결 및 오류를 확인합니다.
    주: 오류 메시지는 장치 메모리에 유지되고 Windows 작업 관리자의 서비스 탭에서 Bot 에이전트 서비스가 다시 시작되면 제거됩니다.

    WebSocket 연결 오류로 인해 Bot Runner 장치에서 Control Room에 연결할 수 없을 때 이 옵션은 추가 조사를 위해 가능한 이유를 제공합니다.
    -collectLogs 이제 Bot Runner 기기에서 여러 로그를 캡처하여 문제 관련 정보 수집을 위한 처리 시간을 단축할 수 있습니다.
    이 옵션을 사용하여 유틸리티가 실행되는 장치의 압축 폴더에서 디버깅 및 문제 해결을 위해 현재 날짜 노드 관리자, Bot 시작 프로그램 및 이벤트 뷰어 로그를 캡처하고 저장합니다.
    • 시스템 수준에서 설치된 Bot 에이전트의 경우 로그는 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip에 저장됩니다.
    • 로컬 사용자 수준에서 설치된 Bot 에이전트의 경우 로그는 %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip에 저장됩니다.
    주:
    • 보안 이벤트에 대한 Windows 로그를 캡처하려면 상승된 권한(관리자로 실행)으로 유틸리티를 실행합니다.

      상승된 권한 없이 유틸리티를 실행하면 다음 오류가 표시됩니다.

      오류: security_event_viewer_<date>.evtx를 캡처할 수 없습니다.
    • 저장 공간을 절약하려면 디버깅 후 파일을 삭제하십시오.
    -configProxy <CR_URL> 프록시 구성을 확인하고, 필요한 경우 프록시 자격증명을 구성합니다.

    인증된 서버에 대한 자격 증명이 없기 때문에 Bot Runner 장치에서 Control Room에 연결할 수 없을 때 이 옵션을 사용하여 프록시 서버 자격증명을 구성하십시오. Control Room에 로그인하여 연결 문제가 해결되었는지 확인하십시오.
    -importProxy <CR_URL> 로그인한 사용자 기기에서 시스템 사용자 기기로 프록시 설정을 가져옵니다.
    주: 프록시 설정을 가져오려면 관리자 권한이 있어야 합니다.

    프록시 서버 문제로 인해 Bot Runner 장치에서 Control Room에 연결할 수 없을 때 이 옵션을 사용하여 로그인한 사용자의 프록시 설정을 Bot 에이전트의 시스템 사용자에게 가져옵니다.

    이 옵션에서는 다음에 대한 정보를 제공합니다.
    • 프록시 서버의 인증 여부.
    • Control Room URL이 프록시 서버의 수신 허용 목록에 추가됩니다.
    • WebSocket 연결은 프록시 구성의 일부로 허용됩니다.
    -importSSLCertificate path_to_ssl_certificate 필요한 경우 SSL 인증서를 Java 자격증명 스토어로 가져옵니다.
    주: SSL 인증서를 가져오려면 관리자 권한이 있어야 합니다.

    유효한 SSL 인증서가 없기 때문에 Bot Runner 장치에서 Control Room에 연결할 수 없을 때 이 옵션을 사용하여 SSL 인증서를 가져오십시오. importSSLCertificatepath_to_ssl_certificate 옵션에 지정된 파일 위치에서 유효한 인증서 파일을 사용할 수 있는지 확인해야 합니다.

    가져온 인증서가 유효하도록 Automation Anywhere Bot 에이전트 서비스를 다시 시작해야 합니다.
    -list 로컬 기기에서의 활성 Bot 배포를 봅니다.

    이 옵션을 사용하여 실행 중인 자동화(Bot)를 확인하고 나열합니다.
    -ping <CR_URL> Control Room 및 Bot Runner 기기 간의 연결을 확인합니다.

    이 옵션을 사용하여 Bot Runner 장치가 Control Room에 핑(도달)할 수 있는지 확인합니다.
    -validateSSLCertificate <CR_URL> 유효한 SSL 인증서를 확인하고 인증서가 유효한지 또는 유효하지 않은지 확인합니다.
    주: 이 검사를 수행하려면 읽기 권한이 있어야 합니다.

    유효하지 않은 SSL 인증서 때문에 Bot Runner 장치에서 Control Room에 연결할 수 없을 때 이 옵션을 사용하여 SSL 인증서가 유효한지 확인하십시오. 이 문제를 해결하려면 importSSLCertificate 옵션을 사용하십시오.
  4. 명령 프롬프트에 다음 옵션을 입력합니다. <filepath>\AADiagnosticUtility.exe -<option> <CR_URL>
    예를 들어 WebSocket 오류를 확인하려면 명령 프롬프트에 다음을 입력합니다. AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/
    이 옵션은 다음 결과를 반환합니다. 이 기기에는 최근에 웹 소켓 오류가 발생하지 않았습니다.

    다른 옵션을 사용하여 추가 진단 검사를 수행합니다.