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, OpenSearch Service PPL, OpenSearch Service SQL e. CloudWatch Metrics Insights

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 inserida 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".

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.

Consultas de exemplo

Os exemplos nesta seção descrevem como gerar e atualizar consultas usando o recurso de linguagem natural.

Exemplos: gerar uma consulta em linguagem natural

Para gerar uma consulta usando linguagem natural, insira um prompt e escolha Gerar nova consulta. Esse exemplo mostra consultas que realizam 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.

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 registros:

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 e AWS 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 no Guia do usuário do AWS Organizations .