기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Translate 모니터링
모니터링은 Amazon Translate 및 솔루션의 안정성, 가용성 및 성능을 유지하는 데 중요한 부분입니다.는 Amazon Translate를 모니터링하는 데 사용할 수 있는 다양한 도구를 AWS 제공합니다. 솔루션을 모니터링하도록 이러한 도구를 구성할 수 있습니다. 모니터링 작업은 최대한 자동화하는 것이 좋습니다.
Amazon Translate는 사전 구성된 그래프를 통해 해당 솔루션에 가장 중요한 지표를 보여 줍니다. 각 그래프는 솔루션 성능의 특정 측면을 제시합니다. 그래프에 표시되는 시간 범위를 변경하여 시간 변화에 따른 솔루션 성능을 다양한 시각으로 바라볼 수 있습니다.
Amazon CloudWatch를 사용하여 Amazon Translate를 모니터링할 수도 있습니다. 로 솔루션의 특정 지표를 자동으로 모니터링해 보세요. 어떤 지표가 설정된 임계값을 벗어날 때마다 알림을 보내 줍니다. CloudWatch API로 필요에 맞는 사용자 지정 모니터링 애플리케이션을 만들 수도 있습니다. 자세한 내용은 Amazon CloudWatch 사용 설명서에서 [Amazon CloudWatch란 무엇인가요?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) 섹션을 참조하세요.**
다음 표에서는 Amazon Translate의 사전 구성된 그래프를 각각 설명합니다.
| 그래프 | 설명 |
| --- | --- |
| ![\[성공한 요청 수를 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-successful-request-count.png) | 성공한 요청 수 지정된 기간 동안 Amazon Translate에 보내어 성공한 요청 수입니다. |
| ![\[제한된 요청 수를 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-throttled-request-count.png) | 제한된 요청 수지정된 기간 동안 Amazon Translate에 보내어 제한된 요청 수입니다. 이 정보로 애플리케이션이 Amazon Translate에 요청을 보내는 간격이 너무 빠른지 여부를 알아볼 수 있습니다. |
| ![\[평균 응답 시간을 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-average-response-time.png) | 평균 응답 시간 지정된 기간 동안 Amazon Translate가 요청을 처리하는 데 걸린 평균 시간입니다. |
| ![\[문자 수를 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-character-count.png) | 문자 수지정된 기간 동안 Amazon Translate에 보낸 총 문자 수입니다. 이 문자 수에 따라 요금이 청구됩니다. |
| ![\[사용자 오류 수를 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-user-error-count.png) | 사용자 오류 개수지정된 기간 동안 발생한 사용자 오류 수입니다. 사용자 오류의 HTTP 오류 코드 범위는 400-499입니다. |
| ![\[시스템 오류 수를 보여주는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/translate/latest/dg/images/metric-system-error-count.png) | 시스템 오류 개수지정된 기간 동안 발생한 시스템 오류 수입니다. 시스템 오류의 HTTP 오류 코드 범위는 500-599입니다. |
## Amazon Translate 모니터링
Amazon CloudWatch를 사용하면 해당 계정의 개별 Amazon Translate 작업 지표 또는 전역 Amazon Translate 지표를 얻을 수 있습니다. 이 지표를 사용하여 Amazon Translate 솔루션의 상태를 추적하고, 하나 이상의 지표가 정의된 임계값을 벗어나면 이를 알리도록 경보를 설정할 수 있습니다. 예를 들어 특정 기간 동안 Amazon Translate에 보낸 요청 수를 모니터링하거나, 요청의 지연 시간을 보거나, 오류가 임계값을 초과하면 경보를 발령할 수 있습니다.
### Amazon Translate에 대한 CloudWatch 지표
Amazon Translate 작업의 지표를 확인하려면 다음 정보를 지정해야 합니다.
+ 지표 측정기준. 측정기준은 지표를 식별하는 데 사용하는 이름-값 페어 집합입니다.** Amazon Translate에는 두 가지 측정기준이 있습니다.
+ `Operation`
+ `Language pair`
+ `SuccessfulRequestCount` 또는 `RequestCharacters`와 같은 지표 이름. 전체 지표 목록은 [Amazon Translate의 CloudWatch 지표](translate-cloudwatch.md#translate-cloudwatch-metrics) 섹션을 참조하세요.
AWS CLI, 또는 CloudWatch API를 사용하여 Amazon Translate AWS Management Console에 대한 지표를 가져올 수 있습니다. Amazon AWS 소프트웨어 개발 키트(SDK) 또는 CloudWatch API 도구 중 하나를 통해 CloudWatch API를 사용할 수 있습니다.
아래 표에 CloudWatch 지표의 몇 가지 일반적인 용도가 나와 있습니다. 모든 사용 사례를 망라한 것은 아니지만 시작하는 데 참고가 될 것입니다.
| 방법 | 이 지표 모니터링 |
| --- | --- |
| 성공한 요청 수 추적 | SuccessfulRequestCount 지표의 sum 통계입니다. |
| 내 애플리케이션이 최대 처리량에 도달했는지 여부 확인 | ThrottledCount 지표의 sum 통계입니다. |
| 내 애플리케이션의 응답 시간 찾기 | ResponseTime 지표의 average 통계입니다. |
| 내 애플리케이션의 오류 수 찾기 | ServerErrorCount 및 UserErrorCount 지표의 sum 통계입니다. |
| 요금이 청구되는 문자 수 찾기 | CharacterCount 지표의 sum 통계입니다. |
CloudWatch를 사용하여 Amazon Translate를 모니터링하려면 적절한 CloudWatch 권한이 있어야 합니다. 자세한 내용은 Amazon CloudWatch 사용 설명서의 [Amazon CloudWatch에 대한 인증 및 액세스 제어](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) 섹션을 참조하세요.**
### Amazon Translate 지표 보기
CloudWatch 콘솔에서 Amazon Translate 지표를 봅니다.
**지표 보기(CloudWatch 콘솔)**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. **지표**와 **모든 지표**를 선택한 다음 **AWS/Translate**(AWS/번역)를 선택합니다.
1. 측정기준과 지표 이름을 선택한 다음 **그래프에 추가**를 선택합니다.
1. 날짜 범위 값을 선택합니다. 지정한 날짜 범위의 지표 개수가 그래프에 표시됩니다.
# 를 사용하여 Amazon Translate API 호출 로깅 AWS CloudTrail
Amazon Translate는 Amazon Translate에서 IAM 엔터티 또는 AWS CloudTrail서비스가 수행한 작업에 대한 레코드를 제공하는 AWS 서비스와 통합됩니다. CloudTrail은 Amazon Translate에 대한 모든 API 호출을 이벤트로 캡처합니다. 여기에는 Amazon Translate 콘솔 호출과 Amazon Translate API 작업에 대한 코드 호출이 포함됩니다. CloudTrail 추적을 생성하면 Amazon Translate에 대한 이벤트를 포함한 CloudTrail 이벤트를 Amazon Simple Storage Service(S3) 버킷에 지속적으로 전송할 수 있습니다. 추적을 구성하지 않은 경우에도 **이벤트 기록**에서 CloudTrail 콘솔의 최신 이벤트를 볼 수 있습니다. CloudTrail에서 수집한 정보를 사용하여 Amazon Translate에 수행된 요청, 요청이 수행된 IP 주소, 요청을 수행한 사람, 요청이 수행된 시간 및 추가 세부 정보를 확인할 수 있습니다.
CloudTrail에 대한 자세한 내용은 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/) 섹션을 참조하세요.
**Topics**
+ [Amazon Trail의 Amazon Translate 정보](#translate-info-in-cloudtrail)
+ [Amazon Translate 로그 파일 항목 이해](#understanding-translate-entries)
## Amazon Trail의 Amazon Translate 정보
CloudTrail은 AWS 계정을 생성할 때 계정에서 활성화됩니다. Amazon Translate에서 활동이 발생하면 해당 활동이 **이벤트 기록**의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. AWS 계정에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다. 자세한 설명은 [CloudTrail 이벤트 기록으로 이벤트 보기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)를 참조하세요.
Amazon Translate 이벤트를 포함하여 AWS 계정에 이벤트를 지속적으로 기록하려면 추적을 생성합니다. CloudTrail은 *추적*을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 콘솔에서 추적을 생성하면 기본적으로 모든 AWS 리전에 추적이 적용됩니다. 추적은 AWS 파티션에 있는 모든 리전의 이벤트를 로깅하고 지정된 S3 버킷으로 로그 파일을 전송합니다. CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 조치를 취하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 다음 자료를 참조하세요.
+ [추적 생성 개요](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 지원 서비스 및 통합](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail에 대한 Amazon SNS 알림 구성](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [여러 리전에서 CloudTrail 로그 파일 받기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) 및 [여러 계정에서 CloudTrail 로그 파일 받기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
모든 Amazon Translate 작업은 CloudTrail에서 로깅되며 [API 참조 섹션](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html)에 설명되어 있습니다. 예를 들어 `DeleteTerminology`, `ImportTerminology`, `TranslateText` 작업을 직접 호출하면 CloudTrail 로그 파일에 항목이 생성됩니다.
모든 이벤트 또는 로그 항목에는 요청을 생성했던 사용자에 관한 정보가 포함됩니다. 이 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.
+ 요청을 루트 사용자의 보안 인증 정보로 했는지 여부
+ 역할 또는 페더레이션 사용자에 대한 임시 보안 자격 증명을 사용하여 요청이 생성되었는지 여부
+ 요청이 다른 AWS 서비스에서 이루어졌는지 여부
자세한 내용은 [CloudTrail userIdentity 요소](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) 섹션을 참조하세요.
## Amazon Translate 로그 파일 항목 이해
추적**이란 지정한 Amazon S3 버킷에 이벤트를 로그 파일로 입력할 수 있게 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함될 수 있습니다. 이벤트는 모든 소스로부터의 단일 요청을 나타내며 요청 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 정보가 들어 있습니다. CloudTrail 로그 파일은 퍼블릭 API 직접 호출의 주문 스택 트레이스가 아니므로 특정 순서로 표시되지 않습니다.
다음 예제는 `TranslateText` 작업을 보여주는 CloudTrail 로그 항목이 나타냅니다.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/Administrator",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "Administrator"
},
"eventTime": "2019-09-03T20:32:50Z",
"eventSource": "translate.amazonaws.com",
"eventName": "TranslateText",
"awsRegion": "us-west-2",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197",
"requestParameters": {
"text": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"responseElements": {
"translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"requestID": "f56da956-284e-4983-b6fc-59befa20e2bf",
"eventID": "1dc75278-84d7-4bb2-861a-493d08d67391",
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# Amazon Translate에 대한 CloudWatch 지표 및 측정기준
솔루션의 성능을 모니터링하려면 Amazon Translate에 대한 Amazon CloudWatch 지표 및 측정기준을 사용합니다.
## Amazon Translate의 CloudWatch 지표
| 지표 | 설명 |
| --- | --- |
| CharacterCount | 요금이 청구되는 요청의 문자 수입니다. 유효한 측정기준: 언어 쌍, 작업 유효한 통계: 평균, 최대, 최소, 합계 단위: 수 |
| ResponseTime | 요청에 응답하는 데 걸린 시간입니다. 유효한 측정기준: 언어 쌍, 작업 유효한 통계: 데이터 샘플, 평균 단위: 데이터 샘플은 개수. 평균 통계는 밀리초입니다. |
| ServerErrorCount | 서버 오류 수. 서버 오류의 HTTP 응답 코드 범위는 500 - 599입니다. 유효한 측정기준: 작업 유효한 통계: Average, Sum 단위: 수 |
| SuccessfulRequestCount | 성공한 번역 요청 수입니다. 성공한 요청의 응답 코드는 200 - 299입니다. 유효한 측정기준: 작업 유효한 통계: Average, Sum 단위: 수 |
| ThrottledCount | 스로틀되는 요청 수입니다. `ThrottledCount`로 애플리케이션이 해당 계정에 설정된 요청 수락 속도보다 더 빨리 Amazon Translate에 요청을 보내고 있는지 알아볼 수 있습니다. 자세한 내용은Amazon Web Services 일반 참조의 [Amazon Translate 제한 사항](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate)을 참조하세요.** 유효한 측정기준: 작업 유효한 통계: Average, Sum 단위: 수 |
| UserErrorCount | 발생한 사용자 오류 수입니다. 사용자 오류의 HTTP 응답 코드 범위는 400 - 499입니다. 유효한 측정기준: 작업 유효한 통계: Average, Sum 단위: 수 |
## Amazon Translate에 대한 CloudWatch 측정기준
다음 측정기준을 사용하여 Amazon Translate 지표를 필터링합니다. 소스 언어와 대상 언어로 지표를 그룹화합니다.
| 측정기준 | 설명 |
| --- | --- |
| LanguagePair | 지정한 언어가 포함된 지표만 사용하도록 제한합니다. |
| Operation | 지정한 작업이 있는 지표만 사용하도록 제한합니다. |
# Amazon EventBridge를 사용하여 Amazon Translate 이벤트 모니터링
Amazon Translate는 Amazon EventBridge와 통합되어 번역 작업 및 병렬 데이터 리소스에 영향을 주는 변경 사항을 사용자에게 알립니다. AWS 서비스의 이벤트는 거의 실시간으로 EventBridge로 전달됩니다. 원하는 이벤트만 표시하도록 간단한 규칙을 작성한 후 규칙과 일치하는 이벤트 발생 시 실행할 자동화 작업을 지정할 수 있습니다. 예를 들어 자동으로 시작할 수 있는 작업은 다음과 같습니다.
+ AWS Lambda 함수 호출
+ AWS Systems Manager Run Command 호출
+ Amazon Kinesis Data Streams로 이벤트 릴레이
+ AWS Step Functions 상태 시스템 활성화
+ SNS 주제 또는 Amazon SQS 대기열 알림
자세한 내용을 알아보려면 Amazon EventBridge 사용 설명서**의 [이벤트에 응답하는 Amazon EventBridge 규칙 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)을 참조하세요.
## Amazon Translate 이벤트
다음은 Amazon Translate의 예제 이벤트입니다.
### 배치 번역 작업을 위한 이벤트
Amazon Translate 콘솔 또는 [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html) 작업을 사용하여 배치 번역 작업을 실행합니다. Amazon Translate는 이러한 작업이 성공하든 실패하든 관계없이 작업이 완료되면 이벤트를 전송합니다. 이러한 이벤트는 다음 예제와 비슷합니다.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate TextTranslationJob State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [],
"detail": {
"jobId": "01234567-0123-0123-0123-012345678901",
"jobStatus": "STATUS"
}
}
```
`jobStatus` 속성 값은 Amazon Translate가 이벤트를 전송한 대상 작업 상태에 따라 달라집니다. `jobStatus` 값은 다음과 같습니다.
+ `COMPLETED` – 작업이 성공적으로 완료되었으며 출력을 사용할 수 있습니다.
+ `COMPLETED_WITH_ERROR` – 작업이 완료되었지만 오류가 발생했습니다. 작업 출력에서 오류를 분석할 수 있습니다.
+ `STOPPED` – 작업이 중단되었습니다.
+ `FAILED` – 작업이 완료되지 않았습니다. 세부 정보를 보려면 [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html) 작업을 사용하세요.
### 병렬 데이터 리소스에 대한 이벤트
Amazon Translate를 사용하여 병렬 데이터 리소스를 생성하거나 업데이트하면 이벤트가 전송되어 작업의 성공 또는 실패 여부를 나타냅니다.
Amazon Translate 콘솔 또는 [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html) 작업을 사용하여 병렬 데이터 리소스를 생성합니다. 이렇게 하면 Amazon Translate에서 다음과 같은 이벤트를 보냅니다.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "CreateParallelData",
"name": "ExampleParallelData",
"status": "STATUS"
}
}
```
`status` 속성 값은 다음과 같습니다.
+ `ACTIVE` – `CreateParallelData ` 작업이 성공했으며 리소스를 사용할 준비가 되었습니다.
+ `FAILED` – `CreateParallelData` 작업이 실패했습니다.
Amazon Translate 콘솔 또는 [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html) 작업을 사용하여 병렬 데이터 리소스를 업데이트합니다. 이렇게 하면 Amazon Translate에서 다음과 같은 이벤트를 보냅니다.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "UpdateParallelData",
"name": "ExampleParallelData",
"status": "STATUS",
"latestUpdateAttemptStatus": "STATUS",
"latestUpdateAttemptAt": "2017-04-22T03:31:47Z"
}
}
```
`status` 속성은 업데이트로 대체되는 이전 버전의 병렬 데이터 리소스 상태를 제공합니다. 유효한 값:
+ `ACTIVE` – 이전 버전이 성공적으로 생성되거나 업데이트되었습니다.
+ `FAILED` – 이전 버전을 만들거나 업데이트하지 못했습니다.
`latestUpdateAttemptStatus` 속성은 업데이트로 생성되는 새로운 버전의 병렬 데이터 리소스 상태를 제공합니다. 유효한 값:
+ `ACTIVE` – `UpdateParallelData` 작업이 성공했으며 업데이트된 리소스를 사용할 준비가 되었습니다.
+ `FAILED` – `UpdateParallelData` 작업이 실패했습니다.