Amazon CloudWatch를 사용한 Rekognition 모니터링 - Amazon Rekognition

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon CloudWatch를 사용한 Rekognition 모니터링

CloudWatch를 사용하면 개별 Rekognition 작업에 대한 지표 또는 계정에 대한 전역 Rekognition 지표를 가져올 수 있습니다. 지표를 사용하여 Rekognition 기반 솔루션의 상태를 추적하고 하나 이상의 지표가 정의된 임계값을 벗어날 때 통보하도록 경보를 설정할 수 있습니다. 예를 들어 발생한 서버 오류 수에 대한 측정치나 감지된 얼굴 수에 대한 측정치를 볼 수 있습니다. 또한 특정 Rekognition 작업이 성공한 횟수에 대한 지표도 볼 수 있습니다. 지표를 보려면 Amazon CloudWatch, Amazon AWS Command Line Interface, 또는 CloudWatch API를 사용할 수 있습니다.

또한 Rekognition 콘솔을 사용하여 선택한 기간 동안 집계된 지표를 볼 수 있습니다. 자세한 내용은 연습 4: 집계 지표 보기(콘솔) 섹션을 참조하세요.

Rekognition에 CloudWatch 지표 사용

측정치를 사용하려면 다음 정보를 지정해야 합니다.

  • 측정치 차원 또는 차원 없음. 차원은 지표를 고유하게 식별하는 데 도움이 되는 이름-값 페어입니다. Rekognition에는 작업이라는 하나의 차원이 있습니다. 이는 특정 작업에 대한 측정치를 제공합니다. 차원을 지정하지 않으면 지표의 범위가 계정 내의 모든 Rekognition 작업으로 지정됩니다.

  • UserErrorCount와 같은 지표 이름.

AWS Management Console, AWS CLI 또는 CloudWatch API를 사용하여 Rekognition의 모니터링 데이터를 가져올 수 있습니다. 또한 Amazon AWS 소프트웨어 개발 키트(SDK) 또는 CloudWatch API 도구 중 하나를 통해 CloudWatch API를 사용할 수 있습니다. 콘솔에는 CloudWatch API의 원시 데이터를 기초로 하는 일련의 그래프가 표시됩니다. 필요에 따라 콘솔에 표시되거나 API에서 가져온 그래프를 사용하는 것이 더 나을 수 있습니다.

다음은 몇 가지 일반적인 지표 사용 사례입니다. 모든 사용 사례를 망라한 것은 아니지만 시작하는 데 참고가 될 것입니다.

방법 관련 지표

인식되는 얼굴 수를 추적하려면 어떻게 해야 합니까?

DetectedFaceCount 측정치의 Sum 통계를 모니터링합니다.

내 애플리케이션이 초당 최대 요청 수에 도달했는지 여부를 어떻게 알 수 있습니까?

ThrottledCount 측정치의 Sum 통계를 모니터링합니다.

요청 오류는 어떻게 모니터링할 수 있습니까?

UserErrorCount 측정치의 Sum 통계를 사용합니다.

총 요청 수를 찾으려면 어떻게 해야 합니까?

ResponseTime 측정치의 ResponseTimeData Samples 통계를 사용합니다. 여기에는 오류를 초래하는 모든 요청이 포함됩니다. 성공한 작업 호출만 보려면 SuccessfulRequestCount 측정치를 사용합니다.

Rekognition 작업 호출의 지연 시간은 어떻게 모니터링할 수 있습니까?

ResponseTime 측정치를 사용합니다.

IndexFaces가 Rekognition 컬렉션에 성공적으로 얼굴을 추가한 횟수를 모니터링하려면 어떻게 해야 하나요?

SuccessfulRequestCount 측정치 및 IndexFaces 작업을 사용하여 Sum 통계를 모니터링합니다. Operation 차원을 사용하여 작업과 측정치를 선택합니다.

CloudWatch를 사용하여 Rekognition을 모니터링하려면 적절한 CloudWatch 권한이 있어야 합니다. 자세한 내용은 Amazon CloudWatch에 대한 인증 및 액세스 제어를 참조하세요.

Rekognition 지표 액세스

다음 예제는 CloudWatch 콘솔, AWS CLI 및 CloudWatch API를 사용하여 Rekognition 지표에 액세스하는 방법을 보여 줍니다.

지표를 보려면(콘솔)
  1. https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. [Metrics]를 선택하고 [All Metrics] 탭을 선택한 후 [Rekognition]을 선택합니다.

  3. [Metrics with no dimensions]를 선택한 후 측정치를 선택합니다.

    예를 들어 얼마나 많은 얼굴이 감지되었는지 측정하려면 [DetectedFace] 측정치를 선택합니다.

  4. 날짜 범위 값을 선택합니다. 측정치 개수는 그래프에 표시됩니다.

일정 기간 동안 성공적으로 이루어진 DetectFaces 작업 호출 측정치를 보려면(CLI)
  • AWS CLI를 열고 다음 명령을 입력합니다.

    aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2

    이 예제는 일정 기간 동안 성공적으로 이루어진 DetectFaces 작업 호출을 보여 줍니다. 자세한 내용은 get-metric-statistics를 참조하십시오.

지표에 액세스하려면(CloudWatch API)

경보 만들기

경보 때문에 상태가 변경되면 Amazon Simple Notification Service(SNS) 메시지를 보내는 CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간에 단일 지표를 감시하고 여러 기간에 지정된 임계값에 대한 지표 값을 기준으로 작업을 하나 이상 수행합니다. 이 작업은 Amazon SNS 주제 또는 Auto Scaling 정책에 전송되는 알림입니다.

경보는 지속적인 상태 변경에 대해서만 작업을 호출합니다. CloudWatch 경보는 단순히 특정 상태에 있다고 해서 작업을 호출하지 않습니다. 상태가 변경되어 지정된 기간 수 동안 유지되어야 합니다.

경보를 설정하려면(콘솔)
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. 경보 생성(Create Alarm)을 선택합니다. 그러면 [Create Alarm Wizard]가 시작됩니다.

  3. [Metrics with no dimensions] 측정치 목록에서 [Rekognition Metrics]를 선택한 후 측정치를 선택합니다.

    예를 들어 감지된 얼굴의 최대 수에 대한 경보를 설정하려면 [DetectedFaceCount]를 선택합니다.

  4. [Time Range] 영역에서 호출한 얼굴 감지 작업이 포함된 날짜 범위 값을 선택합니다. Next(다음)를 선택합니다.

  5. [Name]과 [Description]을 입력합니다. [Whenever]에서 [>=]를 선택하고 원하는 최대값을 입력합니다.

  6. 경보 상태에 도달할 때 CloudWatch에서 이메일을 보내도록 하려면 이 경보가 발생할 경우 항상:에서 상태가 ALARM입니다를 선택합니다. 기존 Amazon SNS 주제에 경보를 전송하려면 다음 주소로 알림 전송:에서 기존 SNS 주제를 선택합니다. 새 이메일 구독 목록에 이름과 이메일 주소를 설정하려면 주제 생성을 선택합니다. 나중에 경보를 설정하는 데 사용할 수 있도록 CloudWatch가 목록을 저장하고 필드에 표시합니다.

    참고

    새 Amazon SNS 주제를 생성하기 위해 주제 생성을 사용할 경우 의도한 수신자가 알림을 받기 전에 이메일 주소가 확인되어야 합니다. Amazon SNS는 경보가 경보 상태에 진입할 때만 이메일을 전송합니다. 이러한 경보 상태 변경이 이메일 주소 확인 전에 발생할 경우, 의도된 수신자는 알림을 받지 못합니다.

  7. [Alarm Preview] 단원에서 경보를 미리 봅니다. 경보 생성(Create Alarm)을 선택합니다.

경보를 설정하려면(AWS CLI)
  • AWS CLI를 열고 다음 명령을 입력합니다. alarm-actions 파라미터의 값을 변경하여 이전에 만든 Amazon SNS 주제를 참조하세요.

    aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count

    이 예제는 5분 이내에 10회 이상 사용자 오류가 발생하는 경우의 경보를 생성하는 방법을 보여 줍니다. 자세한 내용은 put-metric-alarm을 참조하십시오.

경보를 설정하려면(CloudWatch API)

Rekognition의 CloudWatch 지표

이 섹션에는 Amazon Rekognition에 사용할 수 있는 Amazon CloudWatch 지표 및 작업 차원에 대한 정보가 나와 있습니다.

Rekognition 콘솔에서 Rekognition 지표의 집계 보기도 확인할 수 있습니다. 자세한 내용은 연습 4: 집계 지표 보기(콘솔) 섹션을 참조하세요.

Rekognition의 CloudWatch 지표

다음 표에는 Rekognition 지표가 요약되어 있습니다.

지표 설명

SuccessfulRequestCount

성공한 요청 수. 성공적 요청의 응답 코드 범위는 200 - 299입니다.

단위: 수

유효한 통계: Sum,Average

ThrottledCount

조정된 요청 수. Rekognition은 계정에 대해 설정된 초당 트랜잭션 한도를 초과하는 요청이 수신되면 요청을 제한합니다. 계정에 대해 설정된 한도가 자주 초과되면 한도 증가를 요청할 수 있습니다. 증가를 요청하려면 AWS 서비스 한도를 참조하십시오.

단위: 수

유효한 통계: Sum,Average

ResponseTime

Rekognition이 응답을 계산하는 시간(밀리초)

단위:

  1. Data Samples 통계 개수

  2. Average 통계의 밀리초

유효한 통계: Data Samples,Average

참고

ResponseTime 지표는 Rekognition 지표 창에 포함되지 않습니다.

DetectedFaceCount

IndexFaces 또는 DetectFaces 작업으로 감지된 얼굴의 수.

단위: 수

유효한 통계: Sum,Average

DetectedLabelCount

DetectLabels 작업을 사용하여 감지된 레이블 수.

단위: 수

유효한 통계: Sum,Average

ServerErrorCount

서버 오류 수. 서버 오류의 응답 코드 범위는 500 - 599입니다.

단위: 수

유효한 통계: Sum, Average

UserErrorCount

사용자 오류 수(잘못된 파라미터, 잘못된 이미지, 권한 없음 등). 사용자 오류의 응답 코드 범위는 400~499입니다.

단위: 수

유효한 통계: Sum,Average

MinInferenceUnits StartProjectVersion 요청 중에 지정된 추론 단위의 최소 개수

단위: 수

유효한 통계: Average

MaxInferenceUnits StartProjectVersion 요청 중에 지정된 추론 단위의 최대 개수

단위: 수

유효한 통계: Average

DesiredInferenceUnits

Rekogniti이 스케일 업 또는 다운하는 추론 단위의 수

단위: 수

유효한 통계: Average

InServiceInferenceUnits

모델이 사용하는 추론 단위의 수

단위: 수

유효한 통계: Average

Average 통계를 사용하여 사용된 인스턴스 수에 대한 1분 평균을 구하는 것을 권장합니다.

Rekognition Streaming의 CloudWatch 지표

Rekognition에는 스트리밍 작업에 사용되는 두 번째 네임스페이스인 “Rekognition Streaming”도 있습니다. 다음 표에는 Rekognition Streaming 지표가 요약되어 있습니다.

지표 설명

SuccessfulRequestCount

성공한 요청 수. 성공적 요청의 응답 코드 범위는 200 - 299입니다.

단위: 수

유효한 통계: Sum,Average

CallCount

계정에서 수행된 지정된 작업 수

유효한 통계: Sum,Average

ThrottledCount

조정된 요청 수. Rekognition은 계정에 대해 설정된 초당 트랜잭션 한도를 초과하는 요청이 수신되면 요청을 제한합니다. 계정에 대해 설정된 한도가 자주 초과되면 한도 증가를 요청할 수 있습니다. 증가를 요청하려면 AWS 서비스 한도를 참조하십시오.

단위: 수

유효한 통계: Sum,Average

ServerErrorCount

서버 오류 수. 서버 오류의 응답 코드 범위는 500 - 599입니다.

단위: 수

유효한 통계: Sum, Average

UserErrorCount

사용자 오류 수(잘못된 파라미터, 잘못된 이미지, 권한 없음 등). 사용자 오류의 응답 코드 범위는 400~499입니다.

단위: 수

유효한 통계: Sum,Average

Rekognition에 대한 CloudWatch 차원

작업별 측정치를 검색하려면 Rekognition 네임스페이스를 사용하고 operation 차원을 제공합니다.

차원에 대한 자세한 설명은 CloudWatch Developer Guide차원을 참조하세요.

Rekognition Custom Labels에 대한 CloudWatch 차원

다음 표에는 Rekognition Custom Labels와 함께 사용할 수 있는 CloudWatch 차원이 나와 있습니다.

차원 설명
ProjectName CreateProject로 생성한 Rekognition Custom Labels 프로젝트의 이름
VersionName CreateProjectVersion으로 생성한 Rekognition Custom Labels 프로젝트 버전의 이름

차원에 대한 자세한 설명은 CloudWatch Developer Guide차원을 참조하세요.