Amazon CloudWatch 를 사용한 Amazon Lex 모니터링 - Amazon Lex V1

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

Amazon CloudWatch 를 사용한 Amazon Lex 모니터링

Amazon Lex 봇의 상태를 추적하려면 Amazon CloudWatch 를 사용하십시오. CloudWatc를 사용하면 계정에 대한 개별 Amazon Lex 작업 또는 전역 Amazon Lex 작업에 대한 지표를 얻을 수 있습니다. 또한 하나 이상의 지표가 정의한 임계값을 초과하는 경우 알리도록 경보를 설정할 수도 있습니다. 예를 들어 특정 기간 동안 봇에 대한 요청 횟수를 모니터링하거나, 성공적인 요청의 지연 시간을 보거나, 오류가 임계값을 초과한 경우 경보를 실행할 수 있습니다.

Amazon Lex의 CloudWatch 지표

Amazon Lex 작업에 대한 지표를 얻으려면 다음 정보를 지정해야 합니다.

  • 지표 차원. 차원은 지표를 식별하는 데 사용하는 이름-값 페어 집합입니다. Amazon Lex에는 세 가지 차원이 있습니다.

    • BotAlias, BotName, Operation

    • BotAlias, BotName, InputMode, Operation

    • BotName, BotVersion, InputMode, Operation

  • MissedUtteranceCount 또는 RuntimeRequestCount와 같은 지표 이름

AWS Management Console, AWS CLI, 또는 CloudWatch API를 사용하여 Amazon Translate에 대한 지표를 가져올 수 있습니다. Amazon AWS 소프트웨어 개발 키트(SDK) 또는 CloudWatch API 도구 중 하나를 통해 CloudWatch API를 사용할 수 있습니다. Amazon Lex 콘솔에는 API의 원시 데이터를 기초로 하는 그래프가 표시됩니다.

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

Amazon Lex 지표 보기

Amazon Lex 콘솔 또는 CloudWatch 콘솔을 사용하여 Amazon Lex 지표를 볼 수 있습니다.

지표 보기(Amazon Lex 콘솔)
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/lex에서 Amazon Lex 콘솔을 엽니다.

  2. 봇 목록에서 확인할 지표 중 하나를 선택합니다.

  3. 모니터링을 선택합니다. 지표가 그래프로 표시됩니다.

지표 보기(CloudWatch 콘솔)
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. Metrics, All Metrics, AWS/Lex를 차례로 선택합니다.

  3. 차원과 지표 이름을 선택한 다음 그래프에 추가를 선택합니다.

  4. 날짜 범위 값을 선택합니다. 선택한 날짜 범위에 대한 지표 개수가 그래프에 표시됩니다.

알림 생성

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

경보는 상태가 변경되어 지정한 기간 동안 지속되는 경우에만 작업을 호출합니다.

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

  2. 알람를 선택한 다음 알람 생성을 선택합니다.

  3. AWS/Lex Metrics를 선택한 후 지표를 선택합니다.

  4. 시간 범위에서 모니터링할 시간 범위를 선택한 후, 다음를 선택합니다.

  5. 이름설명을 입력합니다.

  6. Whenever에서 >=를 선택하고 최대 값을 입력합니다.

  7. 경보 상태에 도달하면 CloudWatch가 이메일을 보내기를 원한다면, 작업 섹션에서 경보가 발생할 경우 항상에 대해 상태가 ALARM입니다를 선택합니다. 알림 보내기 대상에서 메일 발송 목록을 선택하거나 새 목록을 선택하여 새 목록을 만듭니다.

  8. 알람 미리보기 섹션에서 경보를 미리 볼 수 있습니다. 경보가 만족스러우면 경보 생성을 선택합니다.

Amazon Lex 런타임 의 CloudWatch 측정치

다음 표에서는 Amazon Lex 런타임 지표를 설명합니다.

지표 설명
KendraIndexAccessError

Amazon Lex가 Amazon Kendra 인덱스에 액세스할 수 없는 횟수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

KendraLatency

Amazon Kendra가 AMAZON.KendraSearchIntent의 요청에 응답하는 데 걸리는 시간입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효한 차원:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

단위: 밀리초

KendraSuccess

AMAZON.KendraSearchIntent에서 Amazon Kendra 인덱스로 성공적으로 보낸 요청 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효한 차원:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

단위: 수

KendraSystemErrors

Amazon Lex가 Amazon Kendra 인덱스에 액세스할 수 없는 횟수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

KendraThrottledEvents

Amazon Kendra가 AMAZON.KendraSearchIntent의 요청을 제한한 횟수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

MissedUtteranceCount

지정한 기간에 인식되지 않은 표현 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 SpeechInputMode 사용):

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효한 차원:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

RuntimeConcurrency

지정된 기간 동안 동시 연결 수. RuntimeConcurrencyStatisticSet로 보고됩니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • Operation, BotName, BotVersion, InputMode

  • Operation, BotName, BotAlias, InputMode

작업에 대한 유효 차원:

  • Operation, BotName, BotVersion, InputMode

  • Operation, BotName, BotAlias

단위: 수

RuntimeInvalidLambdaResponses

지정된 기간 동안 유효하지 않은 AWS Lambda (Lambda) 응답 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

RuntimeLambdaErrors

지정된 기간에 발생한 런타임 오류 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

RuntimePollyErrors

지정된 기간 동안 유효하지 않은 Amazon Polly 응답 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

RuntimeRequestCount

지정된 기간의 런타임 요청 수입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효한 차원:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

단위: 수

RuntimeSucessfulRequestLatency
중요

이 지표는 RuntimeSucessfulRequestLatency이며, RuntimeSuccessfulRequestLatency가 아닙니다.

요청 시간과 응답이 다시 전달된 시간 사이의 성공한 요청에 대한 지연 시간입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효한 차원:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

단위: 밀리초

RuntimeSystemErrors

지정된 기간에 발생한 시스템 오류 수입니다. 시스템 오류의 응답 코드 범위는 500~599입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

RuntimeThrottledEvents

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

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

RuntimeUserErrors

지정된 기간에 발생한 사용자 오류 수입니다. 사용자 오류의 응답 코드 범위는 400~499입니다.

PostContent 작업에 대한 유효한 차원(Text 또는 Speech InputMode 사용):

  • BotName, BotAlias, Operation, InputMode

PostText 작업에 대한 유효 차원:

  • BotName, BotAlias, Operation

단위: 수

Amazon Lex 실행 시간 지표는 AWS/Lex 네임스페이스를 사용하며, 다음 차원의 지표를 제공합니다. 지표는 콘솔에서 차원별로 그룹화할 수 있습니다.

차원 설명
BotName, BotAlias, Operation, InputMode 봇 별칭, 봇 이름, 작업(PostContent), 텍스트 입력 또는 음성 입력별로 지표를 그룹화합니다.
BotName, BotVersion, Operation, InputMode 봇 이름, 봇 버전, 작업(PostContent)과 텍스트 입력 또는 음성 입력별로 지표를 그룹화합니다.
BotName, BotVersion, Operation 봇 이름, 봇 버전 및 작업(PostText)별로 지표를 그룹화합니다.
BotName, BotAlias, Operation 봇 이름, 봇 별칭 및 작업(PostText)별로 지표를 그룹화합니다.

Amazon Lex 채널 연결에 사용되는 CloudWatch 지표

채널 연결은 Amazon Lex 와 메시징 채널(예: Facebook) 간의 연결입니다. 다음 표에서는 Amazon Lex 채널 연결 지표를 설명합니다.

지표 설명
BotChannelAuthErrors

지정한 기간에 메시징 채널에서 반환한 인증 오류 수입니다. 인증 오류는 채널 생성 중 제공된 비밀 토큰이 유효하지 않거나 만료되었음을 나타냅니다.

BotChannelConfigurationErrors

지정된 기간에 발생한 구성 오류 수입니다. 구성 오류는 채널에 대한 하나 이상의 구성 항목이 유효하지 않음을 나타냅니다.

BotChannelInboundThrottledEvents

지정된 기간에 메시징 채널이 보낸 메시지를 Amazon Lex가 제한한 수입니다.

BotChannelOutboundThrottledEvents

지정된 기간에 Amazon Lex에서 메시징 채널로 전송되는 아웃바운드 이벤트가 제한된 수입니다.

BotChannelRequestCount

지정된 기간에 채널에 대한 요청 수입니다.

BotChannelResponseCardErrors

지정된 기간에 Amazon Lex가 응답 카드를 게시하지 못한 횟수입니다.

BotChannelSystemErrors

지정된 기간에 Amazon Lex에서 채널에 대해 발생한 내부 오류 수입니다.

Amazon Lex 채널 연결 지표는 AWS/Lex 네임스페이스를 사용하며, 다음 차원에 대한 지표를 제공합니다. 지표는 CloudWatch 콘솔에서 차원별로 그룹화할 수 있습니다.

차원 설명
BotAlias, BotChannelName, BotName, Source 봇 별칭, 채널 이름, 봇 이름 및 트래픽 출처별로 지표를 그룹화합니다.

대화 로그에 대한 CloudWatch 지표

Amazon Lex는 대화 로깅에 다음 지표를 사용합니다.

지표 설명
ConversationLogsAudioDeliverySuccess

지정된 기간 동안 S3 버킷에 성공적으로 전달된 오디오 로그 수입니다.

단위: 개수

ConversationLogsAudioDeliveryFailure

지정된 기간 동안 S3 버킷에 전달하지 못한 오디오 로그 수입니다. 전달 실패는 대화 로그에 대해 구성된 리소스에 오류가 있음을 나타냅니다. 오류에는 권한 부족, 액세스할 수 없는 AWS KMS 키 또는 액세스할 수 없는 S3 버킷이 포함될 수 있습니다.

단위: 개수

ConversationLogsTextDeliverySuccess

지정된 기간 동안 CloudWatch에 성공적으로 전달된 텍스트 로그 수입니다.

단위: 개수

ConversationLogsTextDeliveryFailure

지정된 기간 동안 CloudWatch에 전달하지 못한 텍스트 로그 수입니다. 전달 실패는 대화 로그에 대해 구성된 리소스에 오류가 있음을 나타냅니다. 오류에는 권한 부족, 액세스할 수 없는 AWS KMS 키 또는 액세스할 수 없는 CloudWatch Logs 로그 그룹이 포함될 수 있습니다.

단위: 개수

Amazon Lex 대화 로그 지표는 AWS/Lex 네임스페이스를 사용하며 다음 차원에 대한 지표를 제공합니다. 지표는 콘솔에서 차원별로 그룹화할 수 있습니다.

차원 설명

BotAlias

봇의 별칭별로 지표를 그룹화.

BotName

봇의 이름별로 지표를 그룹화.

BotVersion

봇의 버전별로 지표를 그룹화.