AWS Systems Manager Run Command

AWS Systems Manager Run Command 지표 데이터 수집

구성¶

Func 설치¶

Guance 통합 - 확장 - 관리형 Func를 개통하는 것을 권장합니다. 모든 사전 조건이 자동으로 설치되므로, 스크립트 설치를 계속 진행하세요

직접 배포한 Func는 직접 배포한 Func를 참고하세요

설치 스크립트¶

안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 주세요. (간단하게 하려면 전역 읽기 전용 권한 ReadOnlyAccess를 직접 부여해도 됩니다)

관리형 개통 스크립트¶

1. Guance 콘솔에 로그인합니다
2. 【통합】 메뉴를 클릭하고 【클라우드 계정 관리】를 선택합니다
3. 【클라우드 계정 추가】를 클릭하고 【AWS】를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보를 이미 구성했다면 이 단계를 건너뜁니다
4. 【테스트】를 클릭한 다음 테스트가 성공하면 【저장】을 클릭합니다. 테스트에 실패하면 관련 구성 정보를 확인한 뒤 다시 테스트합니다
5. 【클라우드 계정 관리】 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
6. 클라우드 계정 상세 페이지의 【통합】 버튼을 클릭하고 미설치 목록에서 AWS Systems Manager Run Command를 찾아 【설치】 버튼을 클릭하면 설치 화면이 나타나며, 여기서 설치하면 됩니다

수동 개통 스크립트¶

1. Func 콘솔에 로그인한 뒤 【스크립트 마켓】을 클릭해 Guance 스크립트 마켓으로 들어가 integration_aws_ssm_run_command를 검색합니다

2. 【설치】를 클릭한 뒤 AWS AK ID, AK Secret 및 계정명을 입력합니다

3. 【배포 시작 스크립트】를 클릭하면 시스템이 자동으로 Startup 스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다

4. 활성화한 뒤에는 「관리 / 자동 트리거 구성」에서 해당 자동 트리거 구성을 확인할 수 있습니다. 【실행】을 클릭하면 정기 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다

검증¶

1. 「관리 / 자동 트리거 구성」에서 해당 작업에 대응하는 자동 트리거 구성이 존재하는지 확인하고, 동시에 해당 작업 기록 및 로그를 확인해 이상 여부를 점검합니다
2. Guance의 「인프라 - 리소스 디렉터리」에서 자산 정보가 존재하는지 확인합니다
3. Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다

지표¶

Amazon CloudWatch를 구성하면 더 많은 지표를 수집할 수 있습니다. Amazon CloudWatch 지표 상세 정보

AWS Systems Manager Run Command 지표는 aws_ssm_run_command 지표 세트 아래에 있으며, 설명 열에는 각 지표의 설명과 단위 및 통계 데이터가 포함됩니다.

객체¶

수집된 AWS Systems Manager Run Command 객체 데이터 구조는 「인프라 - 리소스 디렉터리」에서 객체 데이터를 확인할 수 있습니다

{
  "measurement": "aws_ssm_run_command",
  "tags": {
    "command_id"                 : "91d10100-89c4-4077-a2ce-89fb90d1f566",
    "document_name"              : "AWS-RunShellScript",
    "RegionId"                   : "ap-southeast-1"
  },
  "fields": {
    "document_version"           : "1",
    "expires_after"              : "2025-08-05T14:14:19.774000+08:00",
    "parameters"                 : "{[명령 문서]}",
    "instance_ids"               : "xxxx-0b8b6fee9ef5426d7",
    "targets"                    : "{[JSON 데이터]}",
    "requested_date_time"        : "2025-08-05T13:04:19.774000+08:00",
    "status"                     : "Success",
    "status_details"             : "Success",
    "cloud_watch_output_config"  : "{}",
    "alarm_configuration"        : "{}",
    "triggered_alarms"           : "[]",
    "timeout_seconds"            : "600",
    "output_s_3_region"          : "ap-southeast-1"
  }
}

주의: tags와 fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다