AWS Step Function State Machine
AWS Step Function State Machine 메트릭 데이터 수집
구성¶
Func 설치¶
Guance 통합 - 확장 - 관리형 Func 사용을 권장합니다: 모든 사전 조건이 자동으로 설치되어 있으니 계속해서 스크립트를 설치하세요
직접 배포한 Func는 직접 배포한 Func를 참고하세요
설치 스크립트¶
안내: 요구사항에 맞는 Amazon AK를 미리 준비해 두세요(간단히 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
관리형 개통 스크립트¶
- Guance 콘솔에 로그인합니다
- [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보를 이미 설정했다면 이 단계는 건너뜁니다
- [테스트]를 클릭합니다. 테스트가 성공하면 [저장]을 클릭합니다. 테스트가 실패하면 관련 구성 정보를 확인한 뒤 다시 테스트합니다
- [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭하여 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지의 [통합] 버튼을 클릭한 뒤
미설치목록에서AWS Step Function State Machine을 찾아 [설치] 버튼을 클릭하고, 팝업되는 설치 화면에서 설치하면 됩니다
수동 개통 스크립트¶
-
Func 콘솔에 로그인한 뒤 [스크립트 마켓]을 클릭하여 Guance 스크립트 마켓으로 이동하고
integration_aws_sfn_state_machine을 검색합니다 -
[설치]를 클릭한 뒤 AWS AK ID, AK Secret 및 계정명을 입력합니다
-
[배포 시작 스크립트]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고 해당 시작 스크립트를 자동으로 구성합니다 -
활성화한 후에는 「관리 / 자동 트리거 설정」에서 해당 자동 트리거 설정을 볼 수 있습니다. [실행]을 클릭하면 정기 실행을 기다릴 필요 없이 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다
검증¶
- 「관리 / 자동 트리거 설정」에서 해당 작업에 대응하는 자동 트리거 설정이 존재하는지 확인하고, 동시에 작업 기록과 로그를 확인하여 이상이 있는지 점검합니다
- Guance의 「기반 시설 - 리소스 디렉터리」에서 자산 정보가 존재하는지 확인합니다
- Guance의 「메트릭」에서 해당 모니터링 데이터가 있는지 확인합니다
메트릭¶
아마존 클라우드 모니터링을 구성하면, 설정을 통해 더 많은 메트릭을 수집할 수 있습니다 아마존 클라우드 모니터링 메트릭 상세
AWS Step Function State Machin 메트릭은 aws_states 메트릭 세트에 있으며, 설명 열에는 각 메트릭의 설명, 단위 및 통계 데이터가 포함됩니다.
| 메트릭 이름 | 설명 |
|---|---|
ExecutionTime |
실행 시작 시간과 종료 시간 사이의 시간 간격(밀리초) |
ExecutionThrottled |
제한을 받은 StateEntered 이벤트와 재시도 수 |
ExecutionsAborted |
중단되거나 종료된 실행 수 |
ExecutionsFailed |
실패한 실행 수 |
ExecutionsStarted |
시작된 실행 수 |
ExecutionsSucceeded |
성공적으로 완료된 실행 수 |
ExecutionsTimedOut |
어떤 이유로든 시간 초과된 실행 수 |
객체¶
수집된 AWS Step Function State Machin 객체 데이터 구조는 「기반 시설 - 리소스 디렉터리」에서 확인할 수 있습니다
{
"measurement": "aws_sfn_state_machine",
"tags": {
"state_machine_arn" : "arn:xxx:axxxxow:ap-southeast-1:xxxx7738534:environment/MyAirflowEnvironment",
"sate_machine_name" : "HelloWorldStateMachine",
"RegionId" : "ap-southeast-1"
},
"fields": {
"type" : "STANDARD",
"creationDate" : "2025-08-15T10:35:10.879000+08:00"
}
}
주의:
tags,fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다