기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon CloudWatch를 사용하여 Step Functions 지표 모니터링 모니터링은 AWS Step Functions 및 AWS 솔루션의 안정성, 가용성 및 성능을 유지하는 데 중요한 부분입니다. 다중 지점 실패를 AWS 디버깅하는 데 사용하는 서비스에서 데이터를 수집할 수 있습니다. Step Functions 모니터링을 시작하기 전에 다음 질문에 대해 답하는 모니터링 계획을 작성해야 합니다. + 모니터링의 목표 + 모니터링할 리소스 + 이러한 리소스를 모니터링하는 빈도 + 사용할 모니터링 도구 + 모니터링 작업을 수행할 사람 + 문제 발생 시 알려야 할 대상 다음 단계는 환경의 정상 성능에 대한 기준을 설정하는 것입니다. 이렇게 하려면 다양한 시간과 다양한 부하 조건에서 성능을 측정해야 합니다. Step Functions를 모니터링할 때 과거 모니터링 데이터를 저장하는 것이 좋습니다. 그러한 데이터는 현재 성능 데이터와 비교하고, 일반 성능 패턴과 성능 이상을 식별하고, 문제 해결 방법을 제안하는 기준이 될 수 있습니다. 활동 및 작업 실패를 모니터링하여 기준을 설정하는 것이 좋습니다. 성능이 기준 지표를 벗어나면 근본 원인을 조사할 수 있도록 알림을 설정합니다. 기준선을 설정하려면 최소한 다음 지표를 모니터링해야 합니다. + `ExecutionsStarted` + `ExecutionsTimedOut` + *선택 사항*(활동을 사용하는 경우) - `ActivitiesStarted` + *선택 사항*(활동을 사용하는 경우) - `ActivitiesTimedOut` ## CloudWatch에 대한 Step Functions 지표 유형 Step Functions는 Amazon CloudWatch에 다음과 같은 유형의 지표를 제공합니다. 이러한 지표를 사용하면 상태 머신 및 활동을 추적하고 임계값에 경보를 설정할 수 있습니다. 를 사용하여 지표를 볼 수 있습니다 AWS Management Console. 지표는 CloudWatch 지표의 컨테이너인 *네임스페이스*별로 그룹화되므로 여러 애플리케이션의 지표가 실수로 함께 집계되지 않습니다. **비 ASCII 이름 및 로깅** Step Functions는 비 ASCII 문자가 포함된 상태 머신, 실행, 활동 및 레이블 이름을 허용합니다. 이러한 문자는 Amazon CloudWatch에서 데이터 로깅을 방지하므로 Step Functions 지표를 추적할 수 있도록 ASCII 문자만 사용하는 것이 좋습니다. ### CloudWatch 지표 전송 CloudWatch 지표를 전송하고자 최선을 다할 것입니다. 모든 지표가 제때 전송될 것이라고 보장할 수는 없습니다. 특정 요청에 대한 데이터 요소는 그 요청이 실제로 처리되었을 때보다 더 늦은 타임스탬프와 함께 반환될 수도 있습니다. 데이터 요소가 CloudWatch를 통해 제공되기 전에 잠시동안 지연될 수 있거나 아예 전송되지 않을 수 있습니다. CloudWatch 요청 지표는 상태 머신 실행 정보를 거의 실시간으로 제공합니다. 모든 실행 관련 지표를 완벽하게 제공한다는 의미는 아닙니다. 완벽한 전송을 보장할 수 없는 그 특성에 따라 [결제 및 비용 관리 대시보드](https://console.aws.amazon.com/billing/home?#/)에 제공되는 보고서에는 실행 지표에 나타나지 않는 액세스 요청이 하나 이상 포함될 수 있습니다. ### 시간 간격을 보고하는 지표 일부 Step Functions CloudWatch 지표는 *시간 간격*이며 항상 밀리초 단위로 측정됩니다. 이러한 지표는 일반적으로 사용자가 알기 쉬운 이름을 사용하여 상태 머신, 활동 및 Lambda 함수 제한 시간을 설정하는 실행 단계에 해당합니다. 예를 들어, `ActivityRunTime` 지표는 활동이 실행을 시작한 후 완료될 때까지 걸리는 시간을 측정합니다. 동일한 기간에 대해 제한 시간 값을 설정할 수 있습니다. CloudWatch 콘솔에서 시간 간격 지표에 대한 표시 통계로 **평균**을 선택하면 최상의 결과를 얻을 수 있습니다. ### 개수를 보고하는 지표 Step Functions CloudWatch 지표 중 일부는 결과를 *개수*로 보고합니다. 예를 들어, `ExecutionsFailed`는 실패한 상태 머신 실행 수를 기록합니다. Step Functions는 모든 상태 머신 실행에 `ExecutionsStarted` 지표 **2**개를 내보냅니다. 이로 인해 `ExecutionsStarted` 지표에 대한 [SampleCount](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html) 통계에는 모든 상태 머신 실행에 대한 값 **2**가 표시됩니다. 실행이 완료된 후 SampleCount 통계에 `ExecutionStarted=1` 및 `ExecutionStarted=0`이 표시됩니다. 마찬가지로 다른 실행 상태 지표는 CloudWatch 지표에 대해 최소한 한 번 및 최선의 노력 전달 작업으로 인해 2번 이상 방출될 수 있습니다. **작은 정보** CloudWatch 콘솔에서 개수를 보고하는 지표의 표시 통계로 **합계**를 사용하는 것이 좋습니다. ## CloudWatch에서 Step Functions 지표 보기 CloudWatch 콘솔을 사용하여 실행, 활동, 함수 및 서비스 통합에 대한 Step Functions 지표를 볼 수 있습니다. 1. 에 로그인 AWS Management Console 하고 CloudWatch 콘솔을 엽니다. 1. **지표**를 선택하고 **모든 지표** 탭에서 **상태**를 선택합니다. 최근에 실행을 실행했다면 다음과 같은 유형의 지표가 최대 4개까지 표시됩니다. + **실행 지표** + **활동 기능 지표** + **Lambda 함수 지표** + **서비스 통합 지표** 1. 지표 목록을 보려는 지표 유형을 선택합니다. + 지표에 대한 그래프를 보려면 목록에서 지표 옆의 확인란을 선택합니다. 그래프 보기 위의 시간 범위 컨트롤을 사용하여 그래프 파라미터를 변경할 수 있습니다. 상대값 또는 절대값(특정 날짜 및 시간)을 사용하여 사용자 지정 시간 범위를 선택할 수 있습니다. 또한 드롭다운 목록을 사용하여 값을 선, 스택형 영역 또는 숫자(값)으로 표시할 수 있습니다. + 그래프에 대한 세부 정보를 보려면 그래프 아래 나타나는 지표 색상 코드 위에 마우스 포인터를 놓으면 지표 세부 사항이 표시됩니다. CloudWatch 지표 사용 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/working_with_metrics.html)을 참조하세요. ## CloudWatch에서 Step Functions 지표에 대한 경보 설정 Amazon CloudWatch 경보를 사용하여 작업을 수행할 수 있습니다. 예를 들어 경보 임계 값 도달 시기를 알고 싶으면 `StateMachinesFailed` 지표가 특정 임계 값을 초과할 때 알림을 Amazon SNS 주제에 보내거나 이메일을 보내도록 경보를 설정하면 됩니다. ### 지표에 대해 경보를 설정하려면 1. 에 로그인 AWS Management Console 하고 CloudWatch 콘솔을 엽니다. 1. 보려는 지표를 하나 이상 선택한 다음 **그래프로 표시된 지표**를 선택합니다. 1. 목록의 지표 옆에 있는 종 모양 아이콘을 선택하여 **경보 생성** 페이지를 표시합니다. 1. **경보 임계값** 및 **작업**에 값을 입력한 후 **경보 생성**을 선택합니다. 경보 설정 및 CloudWatch 경보 사용 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/AlarmThatSendsEmail.html)을 참조하세요. ## 계정 수준 사용 지표 `AWS/Usage` 네임스페이스에는 다음 Step Functions 지표가 포함됩니다. 다음 지표는 차원이 없으며 리전의 계정 전체에 적용됩니다. | 지표 | 설명 | | --- | --- | | StateMachineCount | 계정에서 현재 활성 상태 시스템 수입니다. 계정에서 상태 머신을 추가하거나 삭제하고 몇 분 정도 기다렸다가 계정에 대해이 지표를 활성화해야 할 수 있습니다. | | ActivityCount | 계정에서 현재 활성 활동 수입니다. 계정에서 활동을 추가하거나 삭제하고 몇 분 정도 기다렸다가 계정에 대해이 지표를 활성화해야 할 수 있습니다. | | OpenExecutionCountPerStateMachine | 계정의 상태 시스템당 실행을 엽니다. | ## 실행 지표 `AWS/States` 네임스페이스에는 모든 Step Functions 실행에 대한 다음 지표가 포함되어 있습니다. 다음 지표는 차원이 없으며 리전의 계정 전체에 적용됩니다. | 지표 | 설명 | | --- | --- | | OpenExecutionCount | 현재 *열린 실행*의 대략적인 수 - 현재 계정에서 진행 중인 워크플로입니다.
표준 워크플로의 경우 `StartExecution` 또는 `RedriveExecution`을 호출할 때 **ExecutionLimitExceeded** 오류를 방지하기 위해 워크플로가 **최대** 실행 한도에 도달하는 시점에 대한 통찰력을 제공하기 위한 입니다.
`OpenExecutionCount`는 대략적인 열린 워크플로 수입니다. 이 지표는 관찰된 실행 중인 워크플로 수보다 적습니다. 10,000개 미만의 열린 워크플로 수를 실행하면 열린 실행이 0으로 표시될 수 있습니다. `OpenExecutionLimit`에 가까워지면 알려주는 경보의 경우, 기본 열린 워크플로 한도가 1,000,000회 실행이므로 임곗값이 100,000 이상인 [최대](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html) 통계를 사용하는 것이 좋습니다. | | OpenExecutionLimit | 최대 열린 실행 수입니다. 자세한 내용은 [계정과 관련된 할당량](service-quotas.md#service-limits-accounts) 단원을 참조하십시오.
*Express 워크플로에는 이 한도가 적용되지 않습니다.* | ### 모든 상태 머신에 대한 실행 지표 모든 상태 머신은 지표를 내보냅니다. `ExecutionThrottled` 지표는 실행이 제한된 경우에만 내보내집니다. 다음 지표는 로 필터링`StateMachineArn`하여 특정 상태 시스템을 식별할 수 있습니다. **계정 수준 지표** 상태 시스템 ARN이 없으면 다음 지표가 **계정 수준에서** 보고됩니다. 상태 시스템 ARN을 제공하여 상태 시스템 수준에서 보고합니다. | 지표 | 설명 | | --- | --- | | ExecutionsAborted | 중단되거나 종료된 실행 수입니다. | | ExecutionsFailed | 실패한 실행 수입니다. | | ExecutionsStarted | 시작된 실행 수입니다. | | ExecutionsSucceeded | 성공적으로 완료된 실행 수입니다. | | ExecutionsTimedOut | 이유에 관계없이 시간이 초과된 실행 수입니다. | | ExecutionThrottled | 조절된 StateEntered 이벤트 및 재시도 수입니다. 이 항목은 StateTransition 조절과 관련됩니다. 자세한 내용은 [상태 제한과 관련된 할당량](service-quotas.md#service-limits-api-state-throttling) 단원을 참조하십시오. | | ExecutionTime | 실행 시작 시간과 종료 시간 사이의 시간 간격(밀리초)입니다. | ### Express 워크플로의 실행 지표 `AWS/States` 네임스페이스에는 Step Functions Express 워크플로 실행에 대한 다음 지표가 포함되어 있습니다. **계정 수준 지표** 상태 시스템 ARN이 없으면 `ExpressExecutionBilledDuration` 및는 **계정 수준에서** `ExpressExecutionBilledMemory` 보고합니다. 상태 시스템 ARN을 제공하여 상태 시스템 수준에서 보고합니다. | 지표 | 설명 | | --- | --- | | ExpressExecutionBilledDuration | Express 워크플로 요금이 청구되는 기간입니다. | | ExpressExecutionBilledMemory | Express 워크플로에 요금이 청구되는 메모리 사용량입니다. | | ExpressExecutionMemory | 특정 Express 워크플로에서 사용하는 총 메모리입니다. | ### 표준 워크플로의 Redrive 실행 지표 상태 머신 실행을 [redrive](redrive-executions.md)하면 Step Functions에서 다음 지표를 내보냅니다. 모든 redriven 실행에 대해 `Executions*` 지표를 내보냅니다. 예를 들어 redriven 실행이 중단되었다고 가정해보겠습니다. 이 실행은 `RedrivenExecutionsAborted` 및 `ExecutionsAborted` 모두에 대해 0이 아닌 데이터포인트를 내보냅니다. | 지표 | 설명 | | --- | --- | | ExecutionsRedriven | redriven 실행 수입니다. | | RedrivenExecutionsAborted | 취소되거나 종료된 redriven 실행 수입니다. | | RedrivenExecutionsTimedOut | 이유에 관계없이 시간이 초과된 redriven 실행 수입니다. | | RedrivenExecutionsSucceeded | 성공적으로 완료된 redriven 실행 수입니다. | | RedrivenExecutionsFailed | 실패한 redriven 실행 수입니다. | ### Step Functions 실행 지표에 대한 차원 | 차원 | 설명 | | --- | --- | | StateMachineArn | 해당 실행에 사용되는 상태 머신의 Amazon 리소스 이름(ARN)입니다. | ### 버전이 있는 실행 차원 | 차원 | 설명 | | --- | --- | | StateMachineArn | [버전](concepts-state-machine-version.md)으로 실행이 시작된 상태 머신의 Amazon 리소스 이름(ARN)입니다. | | Version | 실행을 시작하는 데 사용된 상태 머신 버전입니다. | ### 별칭이 있는 실행 차원 | 차원 | 설명 | | --- | --- | | StateMachineArn | [별칭](concepts-state-machine-alias.md)으로 실행이 시작된 상태 머신의 Amazon 리소스 이름(ARN)입니다. | | Alias | 실행을 시작하는 데 사용된 상태 머신 별칭입니다. | ## 맵 실행 지표 `AWS/States` 네임스페이스에는 모든 Step Functions 맵 실행에 대한 다음 지표가 포함되어 있습니다. 이는 리전의 계정 전체에 적용되는 차원 없는 지표입니다. | 지표 | 설명 | | --- | --- | | ApproximateOpenMapRunCount | 계정에서 현재 진행 중인 맵 실행의 대략적인 수입니다.
이 지표를 사용하면 **OpenMapRunLimit**에 근접할 때 백로깅된 맵 실행을 방지하기 위한 조치를 취할 수 있습니다.
**OpenMapRunLimit**에 가까워지면 알려주는 경보의 경우, 기본 **OpenManRunLimit** 한도가 1,000회 맵 실행이므로 임곗값이 900 이상인 **최대** 통계를 사용하는 것이 좋습니다. | | OpenMapRunLimit | 열린 최대 맵 실행 수입니다.
자세한 내용은 [계정과 관련된 할당량](service-quotas.md#service-limits-accounts) 단원을 참조하십시오. | | ApproximateMapRunBacklogSize | *백로그에 올라온* [맵 실행](concepts-examine-map-run.md)의 대략적인 수입니다. 백로그에 올라온 맵 실행은 총 오픈 맵 실행 수가 할당량 미만이 될 때까지 [MapRunStarted](https://docs.aws.amazon.com/step-functions/latest/apireference/API_MapRunStartedEventDetails.html) 이벤트에서 기다립니다.
맵 실행이 백로그에 올라오는 동안 항목 수는 0이 됩니다. 맵 실행이 열리고 입력을 읽기 시작하면 개수가 증가합니다. | ## 버전 및 별칭 지표 `AWS/States` 네임스페이스에는 상태 시스템의 버전 및 별칭 수에 대한 다음 지표가 포함됩니다. | 지표 | 설명 | | --- | --- | | AliasCount | 상태 머신에 대해 생성된 [별칭](concepts-state-machine-alias.md) 수입니다.
상태 머신마다 별칭을 최대 100개까지 [만들](concepts-state-machine-alias.md#procedure-create-aliases) 수 있습니다. | | VersionCount | 상태 머신에 게시된 [버전](concepts-state-machine-version.md) 수입니다.
상태 머신 버전을 최대 1,000개까지 [게시](concepts-state-machine-version.md#procedure-create-versions)할 수 있습니다. | ### 버전 및 별칭에 대한 리소스 수 지표의 차원 | 차원 | 설명 | | --- | --- | | ResourceArn | 버전이나 별칭이 있는 상태 머신의 Amazon 리소스 이름(ARN)입니다. | ## 활동 지표 `AWS/States` 네임스페이스에는 Step Functions 활동에 대한 다음 지표가 포함되어 있습니다. **계정 수준 지표** 상태 시스템 ARN이 없으면 다음 지표가 **계정 수준에서** 보고됩니다. 상태 시스템 ARN을 제공하여 상태 시스템 수준에서 보고합니다. | 지표 | 설명 | | --- | --- | | ActivitiesFailed | 실패한 활동 수입니다. | | ActivitiesHeartbeatTimedOut | 하트비트 제한 시간으로 인해 시간이 초과된 활동 수입니다. | | ActivitiesScheduled | 예약된 활동 수입니다. | | ActivitiesStarted | 시작된 활동 수입니다. | | ActivitiesSucceeded | 성공적으로 완료된 활동 수입니다. | | ActivitiesTimedOut | 종료 시간이 초과된 활동 수입니다. | | ActivityRunTime | 활동 시작 시간과 종료 시간 사이의 시간 간격(밀리초)입니다. | | ActivityScheduleTime | 활동이 예약 상태를 유지하는 시간 간격(밀리초)입니다. | | ActivityTime | 활동 예약 시간과 종료 시간 사이의 시간 간격(밀리초)입니다. | ### Step Functions 활동 지표의 차원 | 차원 | 설명 | | --- | --- | | ActivityArn | 활동 ARN | ## Lambda 함수 지표 `AWS/States` 네임스페이스에는 Task 상태 정의의 리소스 필드에서 **직접** 참조되는 Lambda 함수에 대한 다음 지표가 포함됩니다. 레거시 상태 머신에서 이러한 지표를 찾을 수 있습니다. 최신 상태 머신에서는 서비스 통합 지표를 내보내는 최적화된 Lambda 통합을 사용하는 것이 좋습니다. | 지표 | 설명 | | --- | --- | | LambdaFunctionRunTime | Lambda 함수 시작 시간과 종료 시간 사이의 시간 간격(밀리초)입니다. | | LambdaFunctionScheduleTime | Lambda 함수가 예약 상태를 유지하는 시간 간격(밀리초)입니다. | | LambdaFunctionTime | Lambda 함수 예약 시간과 종료 시간 사이의 시간 간격(밀리초)입니다. | | LambdaFunctionsFailed | 실패한 Lambda 함수 수입니다. | | LambdaFunctionsScheduled | 예약된 Lambda 함수 수입니다. | | LambdaFunctionsStarted | 시작된 Lambda 함수 수입니다. | | LambdaFunctionsSucceeded | 성공적으로 완료된 Lambda 함수 수입니다. | | LambdaFunctionsTimedOut | 종료 시간이 초과된 Lambda 함수 수입니다. | ### Step Functions Lambda 함수 지표의 차원 | 차원 | 설명 | | --- | --- | | LambdaFunctionArn | Lambda 함수의 ARN입니다. | **참고** Lambda 함수 지표를 ` Resource` 필드에 Lambda 함수 ARN을 지정하는 Task 상태에 내보냅니다. `"Resource": "arn:aws:states:::lambda:invoke"`를 사용하는 Task 상태에서 대신 서비스 통합 지표를 내보냅니다. 자세한 내용은 [Step Functions를 사용하여 AWS Lambda 함수 호출](connect-lambda.md) 단원을 참조하십시오. ## 서비스 통합 지표 `AWS/States` 네임스페이스에는 Step Functions 서비스 통합에 대한 다음과 같은 지표가 포함되어 있습니다. 자세한 내용은 [Step Functions에서 서비스 통합](integrate-services.md) 단원을 참조하십시오. | 측정치 | 설명 | | --- | --- | | ServiceIntegrationRunTime | 서비스 작업이 시작되는 시간과 종료되는 시간 사이의 시간 간격(밀리초)입니다. | | ServiceIntegrationScheduleTime | 서비스 작업이 예약 상태를 유지하는 시간 간격(밀리초)입니다. | | ServiceIntegrationTime | 서비스 작업이 예약되는 시간과 종료되는 시간 사이의 시간 간격(밀리초)입니다. | | ServiceIntegrationsFailed | 실패한 서비스 작업 수입니다. | | ServiceIntegrationsScheduled | 예약된 서비스 작업 수입니다. | | ServiceIntegrationsStarted | 시작된 서비스 작업 수입니다. | | ServiceIntegrationsSucceeded | 성공적으로 완료된 서비스 작업 수입니다. | | ServiceIntegrationsTimedOut | 종료 시간이 초과된 서비스 작업 수입니다. | ### Step Functions 서비스 통합 지표의 차원 | 차원 | 설명 | | --- | --- | | ServiceIntegrationResourceArn | 통합 서비스의 리소스 ARN입니다. | ## 서비스 지표 `AWS/States` 네임스페이스에는 Step Functions 서비스 지표에 대한 다음 지표가 포함됩니다. **계정 수준 지표** 상태 시스템 ARN이 없으면 다음 지표가 **계정 수준에서** 보고됩니다. 상태 시스템 ARN을 제공하여 상태 시스템 수준에서 보고합니다. | 지표 | 설명 | | --- | --- | | ConsumedCapacity | 초당 요청 수입니다. | | ProvisionedBucketSize | 초당 사용 가능한 요청 수입니다. | | ProvisionedRefillRate | 버킷에 허용되는 초당 요청 수입니다. | | ThrottledEvents | 조절된 요청 수입니다. | ### Step Functions 서비스 지표의 차원 | 차원 | 설명 | | --- | --- | | ServiceMetric | StateTransition을 표시하도록 데이터를 필터링합니다. | | StateMachineArn | 데이터를 필터링하여 특정 상태 시스템에 대한 전환을 표시합니다. | ## API 사용량 지표 `AWS/States` 네임스페이스에는 Step Functions API에 대한 다음과 같은 지표가 포함되어 있습니다. | 지표 | 설명 | | --- | --- | | ThrottledEvents | 조절된 요청 수입니다. | | ProvisionedBucketSize | 초당 사용 가능한 요청 수입니다. | | ProvisionedRefillRate | 버킷에 허용되는 초당 요청 수입니다. | | ConsumedCapacity | 초당 요청 수입니다. | ### Step Functions API 지표의 차원 | 차원 | 설명 | | --- | --- | | APIName | 지정한 API 이름의 API에 대한 데이터를 필터링합니다. |