실패했거나 대기 중인 상태로 멈춘 상태 관리자 연결 문제를 해결하려면 어떻게 해야 합니까?
최종 업데이트 날짜: 2021년 3월 24일
관리형 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에서 실행되도록 예약된 상태 관리자 연결을 생성했습니다. 하지만 연결 상태가 실패 또는 대기 중입니다. 이 문제를 해결하려면 어떻게 해야 합니까?
해결 방법
상태 관리자 연결을 생성할 때 Systems Manager는 지정한 일정, 대상, 문서 및 파라미터 정보를 관리형 인스턴스에 바인딩합니다. 연결 상태는 시스템이 모든 대상에 연결하려고 시도하는 동안 처음에는 대기 중 상태이다가 연결에 지정된 상태가 즉시 적용됩니다.
대기 중/실패 상태로 멈춘 연결 문제 해결
상태 관리자 연결이 대기 중 또는 실패 상태로 남아 있는 경우 먼저 SSM Agent의 최신 버전이 설치되어 있는지 확인합니다.
그런 다음 연결이 적용되는 리소스의 상태를 확인하고 호출이 있는지 확인하기 위해 기록을 봅니다.
- Systems Manager 콘솔 상태 관리자 연결 페이지에서 대기 중 또는 실패 상태로 멈춘 연결에 대해 하이퍼링크로 표시되는 연결 ID를 선택합니다.
- [실행 기록(Execution history)] 탭을 클릭하여 호출 기록을 봅니다.
- 기록에 호출을 나열되는 경우 하이퍼링크로 표시되는 실행 ID를 클릭하여 리소스 유형, 상태 및 기타 세부 정보를 확인합니다. 그런 다음 이 문서의 실패 원인 식별 섹션을 참조합니다.
기록에 나열된 호출이 없는 경우 인스턴스가 관리형 인스턴스인지 확인합니다. Systems Manager 콘솔에서 해당 인스턴스가 [관리형 인스턴스(Managed instances)]에 나열되어 있고 [SSM 에이전트 ping 상태(SSM Agent ping status)]가 [온라인(Online)]이어야 합니다.
[관리형 인스턴스(Managed instances)]에 해당 인스턴스가 표시되지 않을 경우 EC2 인스턴스가 Systems Manager 콘솔의 관리형 인스턴스에 나타나지 않는 이유는 무엇입니까?를 참조하세요.
[SSM Agent ping 상태(SSM Agent ping status)]가 [연결 끊김(Connection Lost)]인 경우 연결 끊김 상태인 Systems Manager 관리형 인스턴스의 문제를 해결하려면 어떻게 해야 합니까?를 참조하세요.
실패 원인 식별
기록에 호출이 나열되어 있는 경우 [실행 ID 연결 실행 대상(Execution ID Association execution targets)] 페이지에서 대상 인스턴스 [리소스 ID(Resource ID)]를 선택한 다음 [출력(Output)]을 선택합니다. 출력에는 연결 실패 이유에 대한 세부 정보와 오류 메시지가 표시됩니다.
- Systems Manager Automation 문서 오류에 대한 자세한 내용은 Systems Manager Automation 문제 해결을 참조하세요.
- Run Command 문서 오류에 대한 자세한 내용은 Systems Manager Run Command 문제 해결을 참조하세요.
참고: 출력은 사용하는 Systems Manager 문서에 따라 다릅니다. 자세한 내용은 AWS Systems Manager 문서를 참조하세요.
SSM 에이전트 로그 검토
Run Command 문서 실패에 대한 자세한 내용은 SSM 에이전트 로그를 참조하세요.
Linux 및 macOS의 경우 다음 디렉터리에서 로그를 찾습니다.
- /var/log/amazon/ssm/amazon-ssm-agent.log
- /var/log/amazon/ssm/errors.log
- /var/log/amazon/ssm/audits/amazon-ssm-agent-audit-YYYY-MM-DD
참고: SSM 에이전트 stderr 및 stdout 파일은 /var/lib/amazon/ssm 디렉터리에 씁니다.
Windows의 경우 다음 디렉터리에서 로그를 찾습니다.
- %PROGRAMDATA%\Amazon\SSM\Logs\amazon-ssm-agent.log
- %PROGRAMDATA%\Amazon\SSM\Logs\errors.log
- %PROGRAMDATA%\Amazon\SSM\Logs\audits\amazon-ssm-agent-audit-YYYY-MM-DD