Use the PromQL assistant - Managed Service for Grafana: Central de Documentação do Alibaba Cloud

O assistente de PromQL é uma ferramenta baseada em IA integrada ao Grafana que converte linguagem natural em instruções da Prometheus Query Language (PromQL). Use esse recurso para consultar dados do Prometheus e configure regras de alerta com eficiência. Descreva sua necessidade de consulta em linguagem simples e o assistente gerará o código PromQL automaticamente, sem exigir conhecimento prévio de sintaxe.

Importante

O assistente de PromQL está disponível para todos os workspaces compartilhados do Grafana. Caso ainda não tenha ativado o Managed Service for Grafana, experimente as demonstrações sem login abaixo.

Demonstrações

Demonstração de source de dados APM — consulte métricas de monitoramento de aplicações com PromQL.
Demonstração de source de dados de contêineres — consulte métricas de contêineres com PromQL.

Funcionamento

Insira uma pergunta em linguagem natural que inclua a palavra-chave PromQL, como "Escreva instruções PromQL para consultar as 10 aplicações com maior tempo médio de resposta".
O assistente recupera automaticamente nomes de métricas relevantes, operadores do Prometheus, instruções PromQL e descrições correspondentes.
A ferramenta retorna a instrução PromQL gerada com uma descrição e comentários inline explicando cada parte do código.

Primeiros passos

Faça login no console do ARMS. No painel de navegação à esquerda, escolha Managed Service for Grafana > Workspace Management.
Faça login no console do Managed Service for Grafana. No painel de navegação à esquerda, clique em Workspace Management.
Acesse um painel compartilhado do Grafana e clique em no ícone de robô no canto inferior direito.
No painel exibido, insira sua pergunta. Ela deve incluir obrigatoriamente a palavra-chave PromQL. Exemplo: Escreva instruções PromQL para consultar as 10 aplicações com maior tempo médio de resposta. Para mais informações sobre descrições comuns de consultas PromQL, consulte a seção Cenários suportados e exemplos de prompts.

Nota
O assistente retorna resultados em inglês apenas quando as perguntas são feitas em inglês.
Clique em Send. O assistente retorna o PromQL gerado em alguns segundos.

Nota
Se o resultado não corresponder à sua intenção, clique em Submit Text2 PromQL Feedback para relatar o problema.
Copie o PromQL retornado e cole-o na área Explore do Grafana. Verifique se a source de dados do seu painel contém as métricas referenciadas na consulta.

Você também pode usar o widget de PromQL para gerar instruções destinadas à configuração de regras de alerta.

Tutorial em vídeo

Assista ao vídeo abaixo para acompanhar o fluxo de trabalho completo:

Como escrever prompts eficazes

A qualidade do PromQL gerado depende diretamente da formulação da sua pergunta. Siga as diretrizes abaixo para obter melhores resultados.

Seja específico, não vago

Recomendado	Evitar
Escreva instruções PromQL para consultar a utilização de CPU de cada nó Kubernetes.	PromQL para CPU.
Escreva instruções PromQL para consultar as 10 operações de API com maior tempo médio de resposta na Aplicação A.	PromQL para APIs lentas.

Inclua contexto

Especifique o nome da aplicação, namespace, endereço IP, intervalo de tempo ou escopo da métrica. Quanto mais contexto você fornecer, mais preciso será o resultado.

Recomendado	Evitar
Escreva instruções PromQL para consultar o uso de memória do nó Kubernetes 172.16.xx.xx:9100.	PromQL para memória de um nó.
Escreva instruções PromQL para consultar o número de chamadas de API de cada aplicação na última hora e agrupe as chamadas por máquina.	PromQL para contagem de chamadas.

Comece simples e refine depois

Se o resultado inicial estiver próximo, mas não exato, tente reformular sua pergunta com restrições mais específicas:

Escreva instruções PromQL para consultar a taxa de erro de cada operação de API.
Escreva instruções PromQL para consultar a taxa de erro de cada operação de API na Aplicação A durante o último minuto.

Cenários suportados e exemplos de prompts

O assistente de PromQL suporta mais de 20 cenários comuns de consulta. Clique em no PromQL widget para navegar por todos os cenários suportados e exemplos de prompts disponíveis no assistente.

Todo prompt deve incluir a palavra-chave PromQL.

Métricas de serviço de contêineres

Utilize estes prompts em painéis do Grafana monitorados por instâncias do Prometheus para Container Service. Para mais informações, consulte Criar uma instância do Prometheus para monitorar um cluster ACK.

Recursos de nós

Exemplo de prompt

Escreva instruções PromQL para consultar a utilização de CPU de cada nó Kubernetes.

Escreva instruções PromQL para consultar o uso de memória do nó Kubernetes 172.16.xx.xx:9100.

Escreva instruções PromQL para acionar alertas caso um nó apresente anomalias no cluster atual.

Escreva instruções PromQL para consultar nós anômalos.

Recursos de Pods

Exemplo de prompt

Escreva instruções PromQL para acionar alertas se um pod for reiniciado mais de duas vezes em 5 minutos.

Escreva instruções PromQL para consultar a disponibilidade do pod namespace="arms", deployment="arms-pop-malaysia".

Escreva instruções PromQL para consultar o pod com mais exceções em um cluster Kubernetes.

Escreva instruções PromQL para consultar jobs com falha.

Recursos de contêineres

Exemplo de prompt

Escreva instruções PromQL para consultar o contêiner com maior utilização de CPU no namespace padrão.

Escreva instruções PromQL para consultar o uso de memória de cada contêiner em namespace="default", pod_name="arms-xtrace".

Escreva instruções PromQL para consultar os cinco contêineres com maior uso de memória.

Métricas do painel Lingjun

Exemplo de prompt

Escreva instruções PromQL para consultar a utilização de GPU de cada nó no painel Lingjun.

Escreva instruções PromQL para consultar a utilização de GPU de cada cluster no painel Lingjun.

Métricas de monitoramento de aplicações do ARMS

Use estes prompts nos painéis padrão do Grafana gerados pelo Application Real-Time Monitoring Service (ARMS) para monitoramento de desempenho de aplicações.

Tempo de resposta

Exemplo de prompt

Escreva instruções PromQL para consultar o tempo médio de resposta de cada operação de API.

Escreva instruções PromQL para consultar o tempo médio de resposta de cada operação de API na Aplicação A.

Escreva instruções PromQL para consultar as 10 operações de API com maior tempo médio de resposta na Aplicação A.

Escreva instruções PromQL para consultar as 10 aplicações com maior tempo médio de resposta.

Taxas de erro

Exemplo de prompt

Escreva instruções PromQL para consultar a taxa de erro de cada operação de API na Aplicação A durante o último minuto.

Escreva instruções PromQL para consultar as 10 aplicações com maior taxa de erro no ARMS.

Escreva instruções PromQL para consultar as 10 operações de API com maior taxa de erro na Aplicação A.

Escreva instruções PromQL para consultar as cinco operações de API com maior taxa de erro na máquina (endereço IP: 195.128.xx.xx) da Aplicação A nas últimas 2 horas.

Volume de chamadas

Exemplo de prompt

Escreva instruções PromQL para consultar as consultas por segundo (QPS) de um banco de dados Redis.

Escreva instruções PromQL para consultar o QPS do serviço Dubbo.

Escreva instruções PromQL para consultar o QPS de cada operação de API na Aplicação A.

Escreva instruções PromQL para consultar o número de chamadas de API de cada aplicação na última hora e agrupe as chamadas por máquina.

Escreva instruções PromQL para consultar o número de chamadas para cada operação de API da Aplicação A nos últimos 5 minutos no ARMS.

Escreva instruções PromQL para consultar o número de chamadas para as operações de API com a tag payment/coupon na Aplicação A nos últimos 5 minutos.

Escreva instruções PromQL para consultar as 10 operações de API com maior número de chamadas.

Escreva instruções PromQL para consultar as cinco operações de API com maior número de chamadas na Aplicação A.

Contagens de erros

Exemplo de prompt

Escreva instruções PromQL para consultar o número de erros de cada operação de API nos últimos 5 minutos.

Escreva instruções PromQL para consultar o total de erros de requisições HTTP na máquina com endereço IP 10.26.xx.xx nos últimos 5 minutos.

Escreva instruções PromQL para consultar a operação de API com maior número de erros na última hora.

Escreva instruções PromQL para consultar o total de erros de chamada ocorridos na máquina com endereço IP 10.26.xx.xx, onde o serviço ClothService está implantado, nos últimos 10 minutos.

Consultas SQL lentas

Exemplo de prompt

Escreva instruções PromQL para consultar as consultas SQL lentas geradas nos últimos 10 minutos.

Escreva instruções PromQL para consultar a operação de API que causa o maior número de consultas SQL lentas na Aplicação A nos últimos 10 minutos.

Escreva instruções PromQL para consultar as 10 operações de API que causam o maior número de consultas SQL lentas na Aplicação A.

Escreva instruções PromQL para consultar as consultas SQL lentas geradas na última hora.

Erros de banco de dados

Exemplo de prompt

Escreva instruções PromQL para consultar as operações de API com falha de chamada em um banco de dados Redis no último minuto.

Escreva instruções PromQL para consultar as cinco operações de API com falha de chamada em um banco de dados MySQL no último minuto.

Códigos de status HTTP

Exemplo de prompt

Escreva instruções PromQL para contar o número de erros 4xx ou 5xx.

Escreva instruções PromQL para contar o número de erros 400 e 500.

Escreva instruções PromQL para consultar o número de requisições que retornaram 4xx para a Aplicação A.

Coletas completas de lixo da JVM

Exemplo de prompt

Escreva instruções PromQL para consultar o número de full GCs ocorridos no último dia.

Escreva instruções PromQL para consultar o número de full GCs ocorridos em cada máquina na última hora.

Escreva instruções PromQL para consultar as máquinas onde ocorreram full GCs na Aplicação A.

Escreva instruções PromQL para consultar as máquinas onde ocorreram mais de cinco full GCs.

Duração de full GC da JVM

Exemplo de prompt

Escreva instruções PromQL para consultar o tempo consumido por full GCs em cada máquina.

Escreva instruções PromQL para consultar as cinco máquinas onde os full GCs consomem mais tempo.

Escreva instruções PromQL para consultar os serviços nos quais os full GCs consomem mais de 1 segundo.

Tendências de QPS

Exemplo de prompt

Escreva instruções PromQL para consultar as aplicações cujo número de requisições de acesso aumenta em 10 minutos.

Escreva instruções PromQL para consultar a aplicação cujo número de requisições de acesso mais aumentou no último dia.

Escreva instruções PromQL para consultar a operação de API cujo número de requisições de acesso aumenta mais rapidamente na Aplicação A na última semana.

Métricas incrementais

Exemplo de prompt

Escreva instruções PromQL para monitorar a métrica arms_mysql_requests_error_count e envie um alerta se o valor da métrica aumentar subitamente.

Escreva instruções PromQL para monitorar o incremento de jvm_threads_live_threads.

Comparações de tendências

Exemplo de prompt

Escreva instruções PromQL para verificar se o número de erros aumentou ou diminuiu em relação a ontem.

Escreva instruções PromQL para consultar o aumento ou diminuição do número de requisições em relação à última hora.

Escreva instruções PromQL para verificar se o número de exceções aumentou ou diminuiu em relação a ontem.

Escreva instruções PromQL para verificar se o tempo médio consumido pelas aplicações aumentou ou diminuiu em relação à última hora.

Escreva instruções PromQL para consultar o aumento ou diminuição do tempo médio consumido pelas aplicações.

Impacto de full GC e SQL lento

Exemplo de prompt

Escreva instruções PromQL para consultar as aplicações afetadas por full GCs.

Escreva instruções PromQL para consultar as operações de API afetadas por full GCs.

Escreva instruções PromQL para consultar as aplicações que apresentam consultas SQL lentas.

Escreva instruções PromQL para consultar as operações de API que causam consultas SQL lentas.

Novas exceções e erros

Exemplo de prompt

Escreva instruções PromQL para consultar as aplicações cujo número de erros está aumentando.

Escreva instruções PromQL para consultar as máquinas cujo número de erros está aumentando.

Escreva instruções PromQL para consultar as operações de API cujo número de erros está aumentando na Aplicação A.

Utilização de CPU

Exemplo de prompt

Escreva instruções PromQL para consultar a utilização de CPU de cada máquina.

Escreva instruções PromQL para consultar as cinco máquinas com maior utilização de CPU nos últimos 5 minutos.

Escreva instruções PromQL para consultar as máquinas cuja utilização de CPU excede 70% na Aplicação A nos últimos 5 minutos.

Escreva instruções PromQL para consultar as cinco máquinas cuja utilização de CPU aumenta mais rapidamente nos últimos 5 minutos e liste a utilização de CPU.