Usar linguagem natural para gerar e atualizar as consultas do CloudWatch Metrics Insights - Amazon CloudWatch

Usar linguagem natural para gerar e atualizar as consultas do CloudWatch Metrics Insights

O CloudWatch é compatível com um recurso de consulta em linguagem natural para ajudar você a gerar e atualizar consultas para o CloudWatch Metrics Insights e o CloudWatch Logs Insights.

Com esse recurso, você pode fazer perguntas ou descrever os dados do CloudWatch que está procurando em inglês simples. O recurso de linguagem natural gera uma consulta com base em um prompt que você envia e fornece uma explicação detalhada de como a consulta funciona. Você também pode atualizar a consulta para investigar melhor seus dados.

Dependendo do ambiente, você pode inserir solicitações, como “Qual instância do Amazon Elastic Compute Cloud tem a maior saída de rede?” e “Mostre-me as dez principais tabelas do Amazon DynamoDB por leituras consumidas”.

nota

O recurso de consulta em linguagem natural geralmente está disponível em dez regiões. Para algumas regiões, o recurso faz chamadas entre regiões para regiões nos Estados Unidos para processar os prompts de consulta. A tabela a seguir lista as regiões compatíveis e mostra onde cada região processa os prompts.

Regiões compatíveis Região em que o prompt é processado

Leste dos EUA (Norte da Virgínia)

Leste dos EUA (Norte da Virgínia)

Leste dos EUA (Ohio)

Leste dos EUA (N. da Virgínia)

Oeste dos EUA (Oregon)

Oeste dos EUA (Oregon)

Ásia-Pacífico (Hong Kong)

Oeste dos EUA (Oregon)

Ásia-Pacífico (Singapura)

Oeste dos EUA (Oregon)

Ásia-Pacífico (Sydney)

Oeste dos EUA (Oregon)

Ásia-Pacífico (Tóquio)

Ásia-Pacífico (Tóquio)

Europa (Frankfurt)

Europa (Frankfurt)

Europa (Irlanda)

Leste dos EUA (Norte da Virgínia)

Europa (Estocolmo)

Leste dos EUA (Norte da Virgínia)

Para gerar uma consulta do CloudWatch Metrics Insights com esse recurso, abra o editor de consultas do CloudWatch Metrics Insights na visualização do construtor ou do editor e escolha Gerar consulta.

Importante

Para usar o recurso de consulta em linguagem natural, você deve usar a política CloudWatchFullAccess, CloudWatchReadOnlyAccess, CloudWatchFullAccessV2, AdministratorAccess ou ReadOnlyAccess.

Você também pode incluir a ação cloudwatch:GenerateQuery em uma política nova ou atual gerenciada pelo cliente ou em uma política em linha.

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 Metrics Insights, consulte Componentes e sintaxe de consulta do CloudWatch Metrics Insights.

Exemplo: gerar uma consulta em linguagem natural

Para gerar uma consulta usando linguagem natural, insira um prompt e escolha Gerar nova consulta. Este exemplo mostra uma consulta que executa uma pesquisa básica.

Prompt

Veja a seguir um exemplo de um prompt que direciona o recurso para pesquisar as dez principais tabelas do DynamoDB que consomem a maior capacidade de leitura.

Show top 10 DynamoDB Tables by consumed reads
Consulta

Veja a seguir um exemplo de consulta que o recurso de linguagem natural gera com base no prompt. 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.

# Show top 10 DynamoDB Tables by consumed reads SELECT SUM("ConsumedReadCapacityUnits") FROM "AWS/DynamoDB" GROUP BY TableName ORDER BY SUM() DESC LIMIT 10 # This query selects the sum of consumed read capacity units for each DynamoDB table, groups the results by table name, orders the results from highest to lowest read capacity consumption, and limits the results to the top 10 tables.
nota

Para desativar o surgimento do prompt e a explicação de como a consulta funciona, use o ícone de engrenagem no editor.

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 principais tabelas do DynamoDB que consomem a maior capacidade de leitura, esse prompt agora direciona o recurso para classificar os resultados pelo número de bytes retornados.

Sort by bytes returned instead
Consulta atualizada

Veja a seguir um exemplo da consulta atualizada. 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.

# Sort by bytes returned instead SELECT SUM("ReturnedBytes") FROM "AWS/DynamoDB" GROUP BY TableName ORDER BY SUM() DESC LIMIT 10 # This query modifies the original query to select the sum of returned bytes instead of consumed read capacity units, and orders the results from highest to lowest sum of returned bytes, limiting the results to the top 10 tables.

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 Metrics 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 recusar a coleta de dados de todos os recursos de IA do CloudWatch, incluindo a geração de consultas, você deve criar uma política de recusa para o 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.