기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
자연어를 사용하여 CloudWatch Logs Insights 쿼리 생성 및 업데이트
CloudWatch Logs는 CloudWatch Logs Insights 및 CloudWatch Metrics Insights에 대한 쿼리를 생성하고 업데이트하는 데 도움이 되는 자연어 쿼리 기능을 지원합니다.
이 기능을 사용하면 원하는 CloudWatch 로그 데이터에 대해 질문을 하거나 일반 영어로 설명할 수 있습니다. 자연어 기능은 입력하는 프롬프트를 기반으로 쿼리를 생성하고 쿼리 작동 방식에 대한 설명을 제공합니다 line-by-line. 쿼리를 업데이트하여 데이터를 더 자세히 조사할 수도 있습니다.
환경에 따라 '전송된 바이트 기준으로 상위 100개의 소스 IP 주소는?' 및 ‘가장 느린 Lambda 함수 요청 10개를 찾아 줘.’ 같은 프롬프트를 입력할 수 있습니다.
참고
자연어 쿼리 기능은 일반적으로 10개 리전에서 사용할 수 있습니다. 일부 리전의 경우 이 기능은 쿼리 프롬프트를 처리하기 위해 미국 내 리전에서 리전 간 호출을 수행합니다. 다음 표에는 지원되는 리전이 나열되어 있으며, 각 리전이 프롬프트를 처리하는 위치가 나와 있습니다.
| 지원되는 리전 | 프롬프트가 처리되는 리전 |
|---|---|
|
미국 동부(버지니아 북부) |
미국 동부(버지니아 북부) |
|
미국 동부(오하이오) |
미국 동부(버지니아 북부) |
|
미국 서부(오리건) |
미국 서부(오레곤) |
|
아시아 태평양(홍콩) |
미국 서부(오레곤) |
|
아시아 태평양(싱가포르) |
미국 서부(오레곤) |
|
아시아 태평양(시드니) |
미국 서부(오레곤) |
|
아시아 태평양(도쿄) |
아시아 태평양(도쿄) |
|
유럽(프랑크푸르트) |
유럽(프랑크푸르트) |
|
유럽(아일랜드) |
미국 동부(버지니아 북부) |
|
유럽(스톡홀름) |
미국 동부(버지니아 북부) |
이 기능을 사용하여 CloudWatch Logs Insights 쿼리를 생성하려면 CloudWatch Logs Insights 쿼리 편집기를 열고 쿼리하려는 로그 그룹을 선택한 다음 쿼리 생성을 선택합니다.
중요
자연어 쿼리 기능을 사용하려면 , CloudWatchLogsFullAccess, CloudWatchLogsReadOnlyAccess AdministratorAccess또는 ReadOnlyAccess IAM 정책으로 로그인하거나 cloudwatch:GenerateQuery 권한이 있어야 합니다.
쿼리 예제
이 섹션의 예제에서는 자연어 기능을 사용하여 쿼리를 생성하고 업데이트하는 방법을 설명합니다.
참고
CloudWatch Logs Insights 쿼리 편집기 및 구문에 대한 자세한 내용은 CloudWatch Logs Insights 쿼리 구문을 참조하세요.
예제: 자연어 쿼리 생성
자연어를 사용하여 쿼리를 생성하려면 프롬프트를 입력하고 새 쿼리 생성을 선택합니다. 이 예제는 기본 검색을 수행하는 쿼리를 보여줍니다.
프롬프트
다음은 가장 느린 Lambda 함수 간접 호출 10개를 검색하도록 기능에 지시하는 프롬프트의 예입니다.
Find the 10 slowest requests
Query
다음은 프롬프트를 기반으로 자연 언어 기능이 생성하는 쿼리의 예입니다. 쿼리 전에 댓글에 프롬프트가 어떻게 나타나는지 확인합니다. 쿼리가 끝나면 쿼리 작동 방식을 설명하는 설명을 읽을 수 있습니다.
# Find the 10 slowest requests fields @timestamp, @message, @duration | sort @duration desc | limit 10 # This query retrieves the timestamp, message and duration fields from the logs and sorts them in descending order by duration to find the 10 slowest requests.
참고
프롬프트 표시 및 쿼리 작동 방식에 대한 설명을 끄려면 편집기의 톱니바퀴 아이콘을 사용합니다.
예제: 자연어 쿼리 업데이트
초기 프롬프트를 편집한 다음, 쿼리 업데이트를 선택하여 쿼리를 업데이트할 수 있습니다.
업데이트된 프롬프트
다음 예제는 이전 프롬프트의 업데이트된 버전을 보여줍니다. 이 프롬프트는 가장 느린 Lambda 함수 간접 호출 10개를 검색하는 프롬프트 대신 이제 가장 느린 Lambda 함수 간접 호출 20개를 검색하고 추가 로그 이벤트를 위한 다른 열을 포함하도록 기능에 지시합니다.
Show top 20 slowest requests instead and display requestId as a column
업데이트된 쿼리
다음은 업데이트된 쿼리의 예제입니다. 업데이트된 쿼리가 나오기 전에 댓글에 업데이트된 프롬프트가 어떻게 나타나는지 확인합니다. 쿼리가 끝나면 원래 쿼리가 어떻게 업데이트되었는지에 대한 설명을 읽을 수 있습니다.
# Show top 20 slowest requests instead and display requestId as a column fields @timestamp, @message, @requestId, @duration | sort @duration desc | limit 20 # This query modifies the original query by replacing the @message field with the @requestId field and changing the limit from 10 to 20 to return the top 20 log events by duration instead of the top 10.
서비스 개선을 위한 데이터 사용 선택 해제
AI 모델을 학습시키고 관련 쿼리를 생성하기 위해 제공하는 자연어 프롬프트 데이터는 서비스를 제공하고 유지하는 용도로만 사용됩니다. 이 데이터는 CloudWatch Logs Insights의 품질을 개선하는 데 사용될 수 있습니다. 고객의 신뢰와 개인 정보 보호는 물론 콘텐츠 보안도 당사의 최우선 과제입니다. 자세한 내용은 AWS 서비스 약관
AI 서비스 옵트아웃 정책을 생성하여 콘텐츠가 자연어 쿼리의 개발 또는 품질 향상에 사용되는 것을 거부할 수 있습니다. 쿼리 생성 기능을 포함하여 모든 CloudWatch Logs AI 기능에 대한 데이터 수집을 옵트아웃하려면 CloudWatch Logs에 대한 옵트아웃 정책을 생성해야 합니다. 자세한 내용은 AWS Organizations 사용 설명서의 AI 서비스 옵트아웃 정책을 참조하세요.
