명령 상태 이해

AWS Systems Manager의 기능인 Run Command는 어떤 명령을 처리하는 동안과 명령을 처리한 각 관리형 노드에 대해 그 명령이 거치게 되는 다양한 상태에 대한 자세한 상태 정보를 보고합니다. 다음 방법을 사용하여 명령 상태를 모니터링할 수 있습니다.

Run Command 상태

Run Command는 플러그인, 호출, 전체 명령 상태라는 세 가지 영역에 대한 자세한 상태 정보를 보고합니다. 플러그인은 명령의 SSM 문서에 정의된 코드 실행 블록입니다. 플러그인에 대한 자세한 내용은 Command 문서 플러그인 참조 섹션을 참조하세요.

동시에 여러 관리형 노드에 명령을 보내는 경우, 각 노드를 대상으로 하는 명령 사본 각각을 명령 호출이라고 합니다. 예를 들어 AWS-RunShellScript 문서를 사용하여 ifconfig 명령을 20개의 Linux 인스턴스에 보내는 경우 이 명령에는 20개의 호출이 있습니다. 각 명령 호출은 개별적으로 상태를 보고합니다. 지정된 명령 호출에 대한 플러그인 역시 상태를 개별적으로 보고합니다.

마지막으로, Run Command에는 모든 플러그인과 호출에 대한 총체적인 명령 상태가 포함되어 있습니다. 다음 표에 나와 있는 것처럼, 총체적인 명령 상태는 플러그인이나 호출에서 보고되는 상태와 다를 수 있습니다.

명령 제한 시간 값 이해

Systems Manager는 명령을 실행할 때 다음 시간 제한 값을 적용합니다.

총 제한 시간

Systems Manager 콘솔에서 시간 제한(초)(Timeout (seconds)) 필드에 시간 제한 값을 지정합니다. 명령이 전송된 후 Run Command는 명령이 만료되었는지 여부를 확인합니다. 명령이 명령 만료 제한(총 시간 제한)에 도달하면 상태가 InProgress, Pending 또는 Delayed인 모든 호출에 대해 상태가 DeliveryTimedOut으로 변경됩니다.

보다 기술적인 수준에서 총 시간 제한(시간 제한(초)(Timeout (seconds)))은 다음과 같이 두 가지 시간 제한 값의 조합입니다.

Total timeout = "Timeout(seconds)" from the console + "timeoutSeconds": "{{ executionTimeout }}" from your SSM document

예를 들어 Systems Manager 콘솔에서 시간 제한(초)(Timeout (seconds))의 기본값은 600초입니다. AWS-RunShellScriptSSM 문서를 사용하여 명령을 실행하는 경우 다음 문서 샘플과 같이 "timeoutSeconds": "{{ executionTimeout }}"의 기본값은 3,600초입니다.

  "executionTimeout": {
      "type": "String",
      "default": "3600",

  "runtimeConfig": {
    "aws:runShellScript": {
      "properties": [
        {
          "timeoutSeconds": "{{ executionTimeout }}"

즉, 시스템이 명령 상태를 DeliveryTimedOut으로 설정하기 전에 명령이 4,200초(70분) 동안 실행됩니다.

실행 제한 시간

Systems Manager 콘솔의 실행 시간 제한(Execution Timeout) 필드에 실행 시간 제한 값을 지정합니다(사용 가능한 경우). 모든 SSM 문서에 실행 시간 제한을 지정해야 하는 것은 아닙니다. Execution Timeout(실행 시간 초과) 필드는 SSM 문서에 해당 입력 파라미터가 정의되어 있는 경우에만 표시됩니다. 지정된 경우 이 시간 내에 명령이 완료되어야 합니다.

기본 실행 제한 시간

SSM 문서에서 실행 제한 시간 값을 명시적으로 지정할 필요가 없는 경우 Systems Manager는 하드 코딩된 기본 실행 제한 시간을 적용합니다.

Systems Manager가 시간 제한을 보고하는 방법

Systems Manager가 대상의 SSM Agent로부터 execution timeout 응답을 수신한 경우 Systems Manager는 명령 호출을 executionTimeout으로 표시합니다.

Run Command가 SSM Agent로부터 문서 터미널 응답을 받지 못하면 명령 호출은 deliveryTimeout으로 표시됩니다.

대상의 시간 제한 상태를 확인하기 위해 SSM Agent는 모든 파라미터와 SSM 문서의 콘텐츠를 결합하여 executionTimeout을 계산합니다. SSM Agent에서 명령이 시간 초과되었다고 판단하면 executionTimeout을 서비스로 전송합니다.

시간 제한(초)(Timeout (seconds))의 기본값은 3,600초입니다. 실행 시간 제한(Execution Timeout)의 기본값도 3,600초입니다. 따라서 명령의 총 기본 시간 제한은 7,200초입니다.