AWS Step Functions(SFN)State Machine
AWS Step Functions (SFN) State Machine 메트릭 데이터 수집
구성¶
Func 설치¶
Guance 통합 - 확장 - 호스팅 Func를 활성화하는 것을 권장합니다. 모든 사전 요구 사항이 자동으로 설치되므로 스크립트 설치를 진행하세요.
직접 Func를 배포하는 경우 Func 직접 배포를 참고하세요
설치 스크립트¶
안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 주세요. (간단히 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
관리형 Func에서 스크립트 활성화¶
- Guance 콘솔에 로그인합니다
- 【통합】 메뉴를 클릭하고 【클라우드 계정 관리】를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 설정되어 있다면 이 단계를 건너뜁니다
- [테스트]를 클릭하고, 테스트에 성공하면 [저장]을 클릭합니다. 테스트에 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
- 【클라우드 계정 관리】 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지에서 【통합】을 클릭하고
미설치목록에서AWS Step Functions(SFN)State Machine를 찾은 다음 【설치】를 클릭하여 설치 양식을 엽니다.
수동 활성화 스크립트¶
-
Func 콘솔에 로그인하고 【스크립트 마켓】을 클릭하여 Guance 스크립트 마켓을 연 다음
integration_aws_sfn_state_machine를 검색합니다. -
[설치]를 클릭한 뒤 다음 파라미터를 입력합니다. AWS AK ID, AK Secret, 계정명.
-
[배포 시작 스크립트]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다. -
활성화 후에는 [관리 / 자동 트리거 설정]에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 예약 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다.
검증¶
- [관리 / 자동 트리거 구성]에서 해당 작업의 자동 트리거 구성이 있는지 확인하고 작업 기록과 로그에서 이상 여부를 점검합니다.
- Guance의 「인프라 - 리소스 디렉터리」에서 자산 정보가 있는지 확인합니다
- Guance의 【메트릭】에서 해당 모니터링 데이터가 있는지 확인합니다.
지표¶
아마존 클라우드 모니터링을 구성하면, 설정을 통해 더 많은 메트릭을 수집할 수 있습니다 아마존 클라우드 모니터링 메트릭 상세
AWS Step Functions (SFN) State Machine 메트릭은 aws_states 메트릭 세트에 있으며, 설명 열에는 각 메트릭의 설명, 단위 및 통계 데이터가 포함됩니다.
| 메트릭 이름 | 설명 |
|---|---|
ExecutionTime |
실행 시작 시간과 종료 시간 사이의 시간 간격(밀리초) |
ExecutionThrottled |
제한을 받은 StateEntered 이벤트와 재시도 수 |
ExecutionsAborted |
중단되거나 종료된 실행 수 |
ExecutionsFailed |
실패한 실행 수 |
ExecutionsStarted |
시작된 실행 수 |
ExecutionsSucceeded |
성공적으로 완료된 실행 수 |
ExecutionsTimedOut |
어떤 이유로든 시간 초과된 실행 수 |
객체¶
수집된 AWS Step Functions (SFN) State Machine 객체 데이터 구조는 「기반 시설 - 리소스 디렉터리」에서 확인할 수 있습니다
{
"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의 필드는 이후 업데이트에 따라 변경될 수 있습니다