As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Use linguagem natural para gerar e atualizar consultas do CloudWatch Logs Insights
CloudWatch O Logs oferece suporte a um recurso de consulta em linguagem natural para ajudar você a gerar e atualizar consultas para [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) e. [CloudWatch Metrics Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html)
Com esse recurso, você pode fazer perguntas ou descrever os dados de CloudWatch registros que está procurando em inglês simples. O recurso de linguagem natural gera uma consulta com base em uma solicitação que você insere e fornece uma line-by-line explicação de como a consulta funciona. Você também pode atualizar a consulta para investigar melhor seus dados.
Dependendo do ambiente, você pode inserir prompts, como "Quais os 100 principais endereços IP de origem por bytes transferidos?" e "Encontre as dez solicitações de função do Lambda mais lentas".
**nota**
O recurso de consulta em linguagem natural é um serviço regional. Para algumas regiões, o recurso faz chamadas entre regiões para regiões nos Estados Unidos para processar os prompts de consulta. Para obter mais informações, consulte [Amazon CloudWatch expande o suporte regional para resumo de resultados de consultas em linguagem natural e geração de consultas](https://aws.amazon.com/about-aws/whats-new/2025/08/amazon-cloudwatch-region-support-query-result-summarization-query-generation/).
Para gerar uma consulta do CloudWatch Logs Insights com esse recurso, abra o editor de consultas do CloudWatch Logs Insights, selecione o grupo de registros que você deseja consultar e escolha **Gerar consulta**.
**Importante**
Para usar o recurso de consulta em linguagem natural, você deve estar conectado com as políticas [CloudWatchLogsFullAccess[CloudWatchLogsReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsReadOnlyAccess.html)](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsFullAccess.html), [AdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AdministratorAccess.html), ou [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html)do IAM, ou ter a `cloudwatch:GenerateQuery` permissão.
## Consultas de exemplo
Os exemplos nesta seção descrevem como gerar e atualizar consultas usando o recurso de linguagem natural.
**nota**
Para obter mais informações sobre o editor de consultas e a sintaxe do CloudWatch Logs Insights, consulte Sintaxe de [consulta do CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html).
### Exemplos: gerar uma consulta em linguagem natural
Para gerar uma consulta usando linguagem natural, insira um prompt e escolha **Gerar nova consulta**. Este exemplo mostra consultas que executam uma pesquisa básica.
**Prompt**
O exemplo de prompt a seguir instrui o recurso a pesquisar as dez invocações de funções do Lambda mais lentas.
```
Find the 10 slowest requests
```
**Consulta**
A seguir está a consulta usando a linguagem de consulta do CloudWatch Logs Insights que o recurso de linguagem natural gerou com base na solicitação. Observe como o prompt aparece em um comentário antes da consulta. Depois da consulta, você pode ler uma explicação que descreve como a consulta funciona.
```
# 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.
```
**nota**
Para desativar o surgimento do prompt e a explicação de como a consulta funciona, use o ícone de engrenagem no editor.
**Prompt**
Para gerar uma consulta OpenSearch SQL, selecione a guia OpenSearch SQL e, em seguida, abra a caixa de solicitação do gerador de consultas para inserir sua solicitação de linguagem natural. Veja a seguir um exemplo de um prompt que usa o recurso de linguagem natural para gerar uma consulta OpenSearch SQL.
```
Give me the number of errors and exceptions per hour
```
**Consulta**
A seguir está a consulta SQL gerada por esse prompt que você pode usar para encontrar o número de erros e exceções agregados por hora:
```
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
```
**Prompt**
Para gerar uma consulta OpenSearch PPL, selecione a guia OpenSearch PPL e, em seguida, abra a caixa de solicitação do gerador de consultas para inserir sua solicitação em linguagem natural. Veja a seguir um exemplo de um prompt que usa o recurso de linguagem natural para gerar uma consulta OpenSearch PPL.
```
Give me all unique exception messages
```
**Consulta**
Veja a seguir a consulta PPL gerada por esse prompt que você pode usar para encontrar as mensagens de exceção exclusivas em seus logs:
```
dedup @message
| fields @message
```
### Exemplo: atualizar uma consulta em linguagem natural
Você pode atualizar uma consulta editando o prompt inicial e escolhendo **Atualizar consulta**.
**Prompt atualizado**
O exemplo a seguir mostra uma versão atualizada do prompt anterior. Em vez de um prompt que pesquisa as dez invocações de funções do Lambda mais lentas, esse prompt agora instrui o recurso a pesquisar as vinte invocações de funções do Lambda mais lentas e a incluir outra coluna para eventos de log adicionais.
```
Show top 20 slowest requests instead and display requestId as a column
```
**Consulta atualizada**
Veja a seguir um exemplo da consulta atualizada usando a linguagem de consulta CloudWatch Logs Insights. Observe como o prompt atualizado aparece em um comentário antes da consulta atualizada. Depois da consulta, você pode ler uma explicação que descreve como a consulta original foi atualizada.
```
# 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.
```
## Optar por não usar seus dados para melhorar o serviço
Os dados dos prompts em linguagem natural que você fornece para treinar o modelo de IA e gerar consultas relevantes são usados exclusivamente para fornecer e manter seu serviço. Esses dados podem ser usados para melhorar a qualidade do CloudWatch Logs Insights. Sua confiança e privacidade, além da segurança do seu conteúdo, são nossas maiores prioridades. Para obter mais informações, consulte [Termos de Serviço da AWS](https://aws.amazon.com/service-terms/) e [AWS responsible AI policy](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
Você pode se recusar a ter seu conteúdo usado para desenvolver ou melhorar a qualidade das consultas em linguagem natural ao criar uma política de rejeição de serviços de IA. Para desativar a coleta de dados de todos os recursos do CloudWatch Logs AI, incluindo o recurso de geração de consultas, você deve criar uma política de exclusão para o Logs. CloudWatch Para obter mais informações, consulte [Políticas de exclusão dos serviços de IA](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html) no *Guia do usuário do AWS Organizations *.