# Execução de consultas do PromQL no Query Studio (versão de pré-visualização)
<a name="CloudWatch-PromQL-QueryStudio"></a>

**nota**  
No momento, o Query Studio está disponível como um recurso de pré-visualização sem custo adicional. Para saber quais regiões são compatíveis, consulte [Regiões do AWS compatíveis](CloudWatch-PromQL.md#CloudWatch-PromQL-Regions).

O Query Studio é um ambiente de consulta interativo no console do CloudWatch, em que você pode escrever, executar e visualizar consultas do PromQL em relação às suas métricas do CloudWatch. Você pode usar o Query Studio para explorar métricas ingeridas via OTLP e métricas fornecidas pela AWS, criar visualizações, configurar alarmes e adicionar widgets aos seus painéis do CloudWatch.

Você pode executar consultas do PromQL de forma programática usando a API do CloudWatch ou de forma interativa no Query Studio.

## Execução de uma consulta do PromQL no Query Studio
<a name="CloudWatch-PromQL-QueryStudio-RunQuery"></a>

**Para executar uma consulta do PromQL no Query Studio**

1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Query Studio (pré-visualização)**.

1. Na ferramenta de edição de consultas, selecione **PromQL** no menu suspenso.

1. Use o modo **Builder** para procurar e selecionar nomes de métricas, rótulos e funções de agregação.

1. Ou insira sua consulta do PromQL por meio do modo **Editor**, por exemplo, `{"http.server.active_requests"}`.

1. (Opcional) Ajuste o intervalo de tempo usando o seletor de intervalo de tempo presente na parte superior da página.

1. Selecione **Executar** para executar a consulta e visualizar os resultados.

O Query Studio exibirá os resultados como um grafo de séries temporais. Você pode alternar entre as visualizações de grafo e tabela para analisar seus dados.

## Criar alarmes no Query Studio
<a name="CloudWatch-PromQL-QueryStudio-Alarms"></a>

Depois de executar uma consulta do PromQL que retorna uma única série temporal, você pode criar um alarme do CloudWatch diretamente no Query Studio. Escolha **Criar alarme** no menu ações para configurar limites de alarme, períodos de avaliação e ações de notificação com base nos resultados da consulta. Para obter mais informações, consulte [Uso do PromQL em alarmes](CloudWatch-PromQL-Alarms.md).

## Adição de visualizações a painéis
<a name="CloudWatch-PromQL-QueryStudio-Dashboards"></a>

Você pode adicionar qualquer visualização do Query Studio a um painel do CloudWatch. Depois de executar uma consulta e visualizar os resultados, escolha **Adicionar ao painel** para salvar a visualização como um widget do painel. O widget continua a executar a consulta do PromQL no intervalo de atualização do painel, mantendo seu painel atualizado.