SSM 접속 시 발생하는 「SSM 에이전트가 온라인 상태가 아닙니다」 문제 해결
2025.04.16안녕하세요 클래스메소드 김재욱(Kim Jaewook) 입니다. 이번에는 SSM 접속 시 발생하는 「SSM 에이전트가 온라인 상태가 아닙니다」 문제를 해결하는 방법에 대해서 정리해 봤습니다.
문제 발생
EC2 인스턴스를 생성하고 SSM 연결을 시도하려고 했더니 에러가 발생했습니다.
「SSM 에이전트가 온라인 상태가 아닙니다」
문제 해결
AWS에서는 SSM 관련 문제를 어떻게 해결할 수 있는지에 대한 방법을 제시하고 있습니다.
이번에 발생한 「SSM 에이전트가 온라인 상태가 아닙니다」 문제도 기재되어 있습니다.
내용을 확인해 보면 다음과 같습니다.
SSM Agent는 Session Manager가 Amazon EC2 인스턴스에 연결할 수 있도록 해당 인스턴스에서 실행되는 Amazon 소프트웨어입니다. 이 오류가 표시되면 SSM Agent가 Systems Manager 엔드포인트와 연결을 설정할 수 없는 것입니다. 방화벽 제한, 라우팅 문제 또는 인터넷 연결 부재가 문제의 원인일 수 있습니다.
대체로 네트워크 설정에서의 문제로 인터넷 연결 혹은 라우팅에서 문제가 발생하는 것 같습니다.
먼저 라우팅 테이블을 확인해 봅시다.
현재 EC2 인스턴스는 퍼블릭 서브넷에 배치한 상태이기 때문에 외부와 인터넷 연결이 가능한 상태여야합니다. 라우팅 테이블을 확인해 보면, 인터넷 게이트웨이 경로가 문제없이 설정되어 있습니다.
※ 만약 NAT Gateway를 생성하고, EC2 인스턴스가 프라이빗 서브넷에 배치된 상태라면, 프라이빗 서브넷의 라우팅 테이블에 NAT Gateway 경로가 설정되어 있어야합니다.
대부분 이 라우팅 테이블에서의 문제일 것이며, 라우팅 테이블에서도 문제가 없다면 EC2 인스턴스를 확인해 봅시다.
EC2 인스턴스가 퍼블릭 서브넷에 있으면서도 [퍼블릭 IPv4 주소]가 할당되지 않은 것을 확인할 수 있습니다. [퍼블릭 IPv4 주소]를 할당합시다.
EC2 인스턴스에 [퍼블릭 IPv4 주소]를 할당했습니다.
다시 SSM을 확인해 보면, 성공적으로 SSM 연결이 활성화된 것을 확인할 수 있습니다.
본 블로그 게시글을 읽고 궁금한 사항이 있으신 분들은 jaewookkim533@yahoo.com로 보내주시면 감사하겠습니다.
