기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 자연어를 사용하여 CloudWatch Logs Insights 쿼리를 생성하고 업데이트
CloudWatch Logs는 [CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html), [OpenSearch Service PPL](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_PPL.html), [OpenSearch Service SQL](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_SQL.html) 및 [CloudWatch Metrics Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html)에 대한 쿼리를 생성하고 업데이트하는 데 도움이 되는 자연어 쿼리 기능을 지원합니다.
이 기능을 사용하면 찾고 있는 CloudWatch Logs 데이터에 대해 일반적 영어로 질문하거나 설명할 수 있습니다. 자연어 기능은 사용자가 입력한 프롬프트에 따라 쿼리를 생성하고 쿼리 작동 방식을 한 줄씩 설명합니다. 쿼리를 업데이트하여 데이터를 더 자세히 조사할 수도 있습니다.
환경에 따라 '전송된 바이트 기준으로 상위 100개의 소스 IP 주소는?' 및 ‘가장 슬로우한 Lambda 함수 요청 10개를 찾아 줘.’ 같은 프롬프트를 입력할 수 있습니다.
**참고**
자연어 쿼리 기능은 리전 서비스입니다. 일부 리전의 경우 이 기능은 쿼리 프롬프트를 처리하기 위해 미국 내 리전에 교차 리전 직접 호출을 수행합니다. 자세한 내용은 [Amazon CloudWatch expands region support for natural language query result summarization and query generation](https://aws.amazon.com/about-aws/whats-new/2025/08/amazon-cloudwatch-region-support-query-result-summarization-query-generation/)을 참조하세요.
이 기능을 사용하여 CloudWatch Logs Insights 쿼리를 생성하려면 CloudWatch Logs Insights 쿼리 편집기를 열고 쿼리하려는 로그 그룹을 선택한 다음, **쿼리 생성**을 선택합니다.
**중요**
자연어 쿼리 기능을 사용하려면 [CloudWatchLogsFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsFullAccess.html), [CloudWatchLogsReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsReadOnlyAccess.html), [AdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AdministratorAccess.html) 또는 [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html) IAM 정책에 로그인하거나 `cloudwatch:GenerateQuery` 권한이 있어야 합니다.
## 예제 쿼리
이 섹션의 예제에서는 자연어 기능을 사용하여 쿼리를 생성하고 업데이트하는 방법을 설명합니다.
**참고**
CloudWatch Logs Insights 쿼리 편집기 및 구문에 대한 자세한 내용은 [CloudWatch Logs Insights 쿼리 구문](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)을 참조하세요.
### 예: 자연어 쿼리 생성
자연어를 사용하여 쿼리를 생성하려면 프롬프트를 입력하고 **새 쿼리 생성**을 선택합니다. 이 예제에서는 기본 검색을 수행하는 쿼리를 보여줍니다.
**프롬프트**
다음은 가장 느린 Lambda 함수 간접 호출 10개를 검색하도록 기능에 지시하는 프롬프트의 예입니다.
```
Find the 10 slowest requests
```
**Query**
다음은 자연어 기능이 프롬프트를 기반으로 생성한 CloudWatch Logs Insights 쿼리 언어를 사용하는 쿼리입니다. 쿼리 전에 코멘트에 프롬프트가 어떻게 나타나는지 확인합니다. 쿼리가 끝나면 쿼리 작동 방식을 설명하는 설명을 읽을 수 있습니다.
```
# 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.
```
**참고**
프롬프트 표시 및 쿼리 작동 방식에 대한 설명을 끄려면 편집기의 톱니바퀴 아이콘을 사용합니다.
**프롬프트**
OpenSearch SQL 쿼리를 생성하려면 OpenSearch SQL 탭을 선택한 다음 쿼리 생성기 프롬프트 상자를 열어 자연어 프롬프트를 입력합니다. 다음은 자연어 기능을 사용하여 OpenSearch SQL 쿼리를 생성하는 프롬프트의 예제입니다.
```
Give me the number of errors and exceptions per hour
```
**Query**
다음은 시간당 집계된 오류 및 예외 횟수를 찾는 데 사용할 수 있는 프롬프트에서 생성된 SQL 쿼리입니다.
```
SELECT DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH') AS hour,
COUNT(*) AS error_count
FROM `/aws/lambda/CloudWatchOdysseyQueryGen`
WHERE `@message` LIKE '%error%'
OR `@message` LIKE '%exception%'
GROUP BY DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH')
ORDER BY hour
```
**프롬프트**
OpenSearch PPL 쿼리를 생성하려면 OpenSearch PPL 탭을 선택한 다음 쿼리 생성기 프롬프트 상자를 열어 자연어 프롬프트를 입력합니다. 다음은 자연어 기능을 사용하여 OpenSearch PPL 쿼리를 생성하는 프롬프트의 예제입니다.
```
Give me all unique exception messages
```
**Query**
다음은 로그에서 고유한 예외 메시지를 찾는 데 사용할 수 있는 프롬프트에서 생성된 PPL 쿼리입니다.
```
dedup @message
| fields @message
```
### 예: 자연어 쿼리 업데이트
초기 프롬프트를 편집한 다음, **쿼리 업데이트**를 선택하여 쿼리를 업데이트할 수 있습니다.
**업데이트된 프롬프트**
다음 예제는 이전 프롬프트의 업데이트된 버전을 보여줍니다. 이 프롬프트는 가장 느린 Lambda 함수 간접 호출 10개를 검색하는 프롬프트 대신 이제 가장 느린 Lambda 함수 간접 호출 20개를 검색하고 추가 로그 이벤트를 위한 다른 열을 포함하도록 기능에 지시합니다.
```
Show top 20 slowest requests instead and display requestId as a column
```
**업데이트된 쿼리**
다음은 CloudWatch Logs Insights 쿼리 언어를 사용하여 업데이트된 쿼리의 예제입니다. 업데이트된 쿼리가 나오기 전에 코멘트에 업데이트된 프롬프트가 어떻게 나타나는지 확인합니다. 쿼리가 끝나면 원래 쿼리가 어떻게 업데이트되었는지에 대한 설명을 읽을 수 있습니다.
```
# 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 서비스 약관](https://aws.amazon.com/service-terms/)과 [AWS 책임감 있는 AI 정책](https://aws.amazon.com/machine-learning/responsible-ai/policy/)을 참조하세요.
AI 서비스 옵트아웃 정책을 생성하여 콘텐츠가 자연어 쿼리의 개발 또는 품질 향상에 사용되는 것을 거부할 수 있습니다. 쿼리 생성 기능을 포함하여 모든 CloudWatch Logs AI 기능의 데이터 수집을 거부하려면 CloudWatch Logs의 옵트아웃 정책을 생성해야 합니다. 자세한 내용은 **AWS Organizations 사용 설명서의 [AI 서비스 옵트아웃 정책](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html)을 참조하세요.