Amazon Textract Textract에 CloudWatch 지표 사용 Amazon Textract Textract용 지표 경보 만들기

Amazon Textract 모니터링

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

Amazon Textract Textract에 CloudWatch 지표 사용

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

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

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

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

방법	관련 지표
내 애플리케이션이 초당 최대 요청 수에 도달했는지 여부를 어떻게 알 수 있습니까?	`ThrottledCount` 측정치의 `Sum` 통계를 모니터링합니다.
요청 오류는 어떻게 모니터링할 수 있습니까?	`UserErrorCount` 측정치의 `Sum` 통계를 사용합니다.
총 요청 수를 찾으려면 어떻게 해야 합니까?	`ResponseTime` 측정치의 `SampleCount` 통계를 사용합니다. 여기에는 오류를 초래하는 모든 요청이 포함됩니다. 성공한 작업 호출만 보려면 `SuccessfulRequestCount` 측정치를 사용합니다.
Amazon Textract Textract의 작업 호출의 지연 시간은 어떻게 모니터링할 수 있습니까?	`ResponseTime` 측정치를 사용합니다.

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

Amazon Textract Textract용 지표

다음 예제에서는 CloudWatch 콘솔인AWS CLI을 사용하여 CloudWatch API를 사용할 수 있습니다.

지표를 보려면(콘솔)

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
선택지표를 선택합니다.모든 지표탭을 선택한 다음Amazon Textract.
선택작업에 의한 작업[] 를 선택한 다음 측정치를 선택합니다.

예를 들어, 다음을 선택합니다.StartDocumentAnalysis비동기 문서 분석이 시작된 횟수를 측정하는 메트릭입니다.
날짜 범위 값을 선택합니다. 측정치 개수는 그래프에 표시됩니다.

성공에 대한 지표를 보려면`StartDocumentAnalysis`일정 기간 동안 이루어진 작업 호출 (CLI)

AWS CLI를 열고 다음 명령을 입력합니다.


aws cloudwatch get-metric-statistics \
    --metric-name SuccessfulRequestCount \
    --start-time 2019-02-01T00:00:00Z \
    --period 3600 \
    --end-time 2019-03-01T00:00:00Z \
    --namespace AWS/Textract \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --statistics Sum

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

측정치에 액세스하려면 (CloudWatch API)

을 호출합니다..GetMetricStatistics 자세한 내용은 단원을 참조하십시오.Amazon CloudWatch API 레퍼런스.

경보 만들기

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

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

경보를 설정하려면(콘솔)

AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
탐색 창에서 [] 를 선택합니다.경보을 선택하고경보 생성. 이 열립니다.Create Alarm 마법사.
지표 선택(Select metric)을 선택하세요.
에서모든 지표탭, 선택Textract.
선택작업에 의한 작업[] 를 선택한 다음 측정치를 선택합니다.

예를 들어, 다음을 선택합니다.StartDocumentAnalysis을 눌러 최대 비동기 문서 분석 작업에 대한 경보를 설정합니다.
그래프로 표시된 지표(Graphed metrics) 탭을 선택합니다.
Statistic(통계)에서 Sum(합계)를 선택합니다.
지표 선택(Select metric)을 선택하세요.
[Name]과 [Description]을 입력합니다. [Whenever]에서 [>=]를 선택하고 원하는 최대값을 입력합니다.
경보 상태에 도달할 때 CloudWatch에서 이메일을 보내도록 하려면이 알람 때마다:, 선택상태는 알람입니다.. 기존 Amazon SNS 주제에 경보를 전송하려면다음 주소로 알림 보내기:에서 기존 SNS 주제를 선택합니다. 새 이메일 구독 목록에 대한 이름 및 이메일 주소를 설정하려면새 목록. CloudWatch는 목록을 저장하고 필드에 표시하므로 나중에 경보를 설정하는 데 사용할 수 있습니다.

참고
사용하는 경우새 목록새 Amazon SNS 주제를 생성하려면, 의도한 수신자가 알림을 받기 전에 이메일 주소를 확인해야 합니다. Amazon SNS 경보가 경보 상태에 진입할 때만 이메일을 전송합니다. 이러한 경보 상태 변경이 이메일 주소 확인 전에 발생할 경우, 의도된 수신자는 알림을 받지 못합니다.
경보 생성(Create Alarm)을 선택합니다.

경보를 설정하려면(AWS CLI)

AWS CLI를 열고 다음 명령을 입력합니다. 의 값을 변경합니다.alarm-actions파라미터는 이전에 만든 Amazon SNS 주제를 참조합니다.


aws cloudwatch put-metric-alarm \
    --alarm-name StartDocumentAnalysisUserErrors \
    --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
    --metric-name UserErrorCount \
    --namespace AWS/Textract \
    --statistic Sum \
    --period 300 \
    --threshold 10 \
    --comparison-operator GreaterThanThreshold \
    --evaluation-periods 1 \
    --unit Count \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic

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

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

을 호출합니다..PutMetricAlarm 자세한 내용은 단원을 참조하십시오.Amazon CloudWatch API 레퍼런스.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

로깅 및 모니터링

Amazon Textract의 CloudWatch 지표