Utiliser l'assistant PromQL - Managed Service for Grafana - Centre de documentation Alibaba Cloud

L'assistant PromQL est un outil basé sur l'IA, intégré à Grafana, qui convertit le langage naturel en instructions Prometheus Query Language (PromQL). Il permet d'interroger efficacement les données Prometheus et de configurer aisément des règles d'alerte. Décrivez votre besoin en langage courant pour obtenir automatiquement le code PromQL correspondant, sans aucune connaissance syntaxique préalable.

Important

L'assistant PromQL est disponible pour tous les espaces de travail Grafana partagés. Si vous n'avez pas encore activé Managed Service for Grafana, testez les démos sans connexion ci-dessous.

Démos

Démo de source de données APM : interrogez les métriques de surveillance applicative avec PromQL.
Démo de source de données conteneur : interrogez les métriques de conteneurs avec PromQL.

Fonctionnement

Saisissez une question en langage naturel contenant le mot-clé PromQL, par exemple « Rédige des instructions PromQL pour interroger les 10 applications ayant le temps de réponse moyen le plus long ».
L'assistant récupère automatiquement les noms de métriques pertinents, les opérateurs Prometheus, les instructions PromQL ainsi que leurs descriptions associées.
Il renvoie l'instruction PromQL générée, accompagnée d'une description et de commentaires intégrés expliquant chaque partie.

Prise en main

Connectez-vous à la console ARMS. Dans le volet de navigation de gauche, choisissez Managed Service for Grafana > Workspace Management.
Connectez-vous à la console Managed Service for Grafana. Dans le volet de navigation de gauche, cliquez sur Workspace Management.
Connectez-vous à un tableau de bord Grafana partagé et cliquez sur l'icône du robot dans le coin inférieur droit.
Dans le panneau qui s'affiche, saisissez votre question. Celle-ci doit impérativement contenir le mot-clé PromQL. Exemple : Rédige des instructions PromQL pour interroger les 10 applications ayant le temps de réponse moyen le plus long. Pour plus d'informations sur les requêtes PromQL courantes, consultez la section Scénarios pris en charge et exemples de prompts.

Remarque
L'assistant ne retourne des résultats en anglais que si vous posez vos questions en anglais.
Cliquez sur Send. L'assistant renvoie le code PromQL généré en quelques secondes.

Remarque
Si le résultat ne correspond pas à votre intention, cliquez sur Submit Text2 PromQL Feedback pour signaler le problème.
Copiez le code PromQL retourné et collez-le dans la fonctionnalité Explore de Grafana. Vérifiez que la source de données de votre tableau de bord contient bien les métriques référencées dans la requête.

Tutoriel vidéo

Regardez la vidéo suivante pour découvrir le flux de travail complet :

Rédiger des prompts efficaces

La qualité du code PromQL généré dépend de la formulation de votre question. Suivez les recommandations ci-dessous pour obtenir de meilleurs résultats.

Soyez précis plutôt que vague

À privilégier	À éviter
Rédige des instructions PromQL pour interroger l'utilisation CPU de chaque nœud Kubernetes.	PromQL pour CPU.
Rédige des instructions PromQL pour interroger les 10 opérations API ayant le temps de réponse moyen le plus long dans l'Application A.	PromQL pour APIs lentes.

Fournissez du contexte

Spécifiez le nom de l'application, le namespace, l'adresse IP, la plage horaire ou le périmètre des métriques. Plus le contexte fourni est riche, plus le résultat sera précis.

À privilégier	À éviter
Rédige des instructions PromQL pour interroger l'utilisation mémoire du nœud Kubernetes 172.16.xx.xx:9100.	PromQL pour mémoire d'un nœud.
Rédige des instructions PromQL pour interroger le nombre d'appels API par application au cours de la dernière heure, regroupés par machine.	PromQL pour nombre d'appels.

Commencez simplement, puis affinez

Si le résultat initial est proche mais inexact, reformulez votre question en ajoutant des contraintes plus spécifiques :

Rédige des instructions PromQL pour interroger le taux d'erreur de chaque opération API.
Rédige des instructions PromQL pour interroger le taux d'erreur de chaque opération API de l'Application A au cours de la dernière minute.

Scénarios pris en charge et exemples de prompts

L'assistant PromQL prend en charge plus de 20 scénarios de requête courants. Cliquez sur le PromQL widget pour parcourir tous les scénarios pris en charge et les exemples de prompts disponibles dans l'assistant.

Chaque prompt doit inclure le mot-clé PromQL.

Métriques du service de conteneurs

Utilisez ces prompts sur les tableaux de bord Grafana surveillés par des instances Prometheus pour Container Service. Pour plus d'informations, consultez Créer une instance Prometheus pour surveiller un cluster ACK.

Ressources des nœuds

Exemple de prompt
Rédige des instructions PromQL pour interroger l'utilisation CPU de chaque nœud Kubernetes.
Rédige des instructions PromQL pour interroger l'utilisation mémoire du nœud Kubernetes 172.16.xx.xx:9100.
Rédige des instructions PromQL pour déclencher des alertes si un nœud devient anormal dans le cluster actuel.
Rédige des instructions PromQL pour interroger les nœuds anormaux.

Ressources des pods

Exemple de prompt
Rédige des instructions PromQL pour déclencher des alertes si un pod redémarre plus de deux fois en 5 minutes.
Rédige des instructions PromQL pour interroger la disponibilité du pod `namespace="arms", deployment="arms-pop-malaysia"`.
Rédige des instructions PromQL pour interroger le pod présentant le plus d'exceptions dans un cluster Kubernetes.
Rédige des instructions PromQL pour interroger les jobs ayant échoué.

Ressources des conteneurs

Exemple de prompt
Rédige des instructions PromQL pour interroger le conteneur ayant la plus forte utilisation CPU dans le namespace par défaut.
Rédige des instructions PromQL pour interroger l'utilisation mémoire de chaque conteneur dans `namespace="default", pod_name="arms-xtrace"`.
Rédige des instructions PromQL pour interroger les cinq conteneurs ayant la plus forte utilisation mémoire.

Métriques du tableau de bord Lingjun

Exemple de prompt
Rédige des instructions PromQL pour interroger l'utilisation GPU de chaque nœud sur le tableau de bord Lingjun.
Rédige des instructions PromQL pour interroger l'utilisation GPU de chaque cluster sur le tableau de bord Lingjun.

Métriques de surveillance des applications ARMS

Utilisez ces prompts sur les tableaux de bord Grafana par défaut générés par Application Real-Time Monitoring Service (ARMS) pour la surveillance des performances applicatives.

Temps de réponse

Exemple de prompt
Rédige des instructions PromQL pour interroger le temps de réponse moyen de chaque opération API.
Rédige des instructions PromQL pour interroger le temps de réponse moyen de chaque opération API dans l'Application A.
Rédige des instructions PromQL pour interroger les 10 opérations API ayant le temps de réponse moyen le plus long dans l'Application A.
Rédige des instructions PromQL pour interroger les 10 applications ayant le temps de réponse moyen le plus long.

Taux d'erreur

Exemple de prompt
Rédige des instructions PromQL pour interroger le taux d'erreur de chaque opération API de l'Application A au cours de la dernière minute.
Rédige des instructions PromQL pour interroger les 10 applications ayant le taux d'erreur le plus élevé dans ARMS.
Rédige des instructions PromQL pour interroger les 10 opérations API ayant le taux d'erreur le plus élevé dans l'Application A.
Rédige des instructions PromQL pour interroger les cinq opérations API ayant le taux d'erreur le plus élevé sur la machine (adresse IP : 195.128.xx.xx) de l'Application A au cours des 2 dernières heures.

Volume d'appels

Exemple de prompt
Rédige des instructions PromQL pour interroger le nombre de requêtes par seconde (QPS) d'une base de données Redis.
Rédige des instructions PromQL pour interroger le QPS du service Dubbo.
Rédige des instructions PromQL pour interroger le QPS de chaque opération API dans l'Application A.
Rédige des instructions PromQL pour interroger le nombre d'appels API par application au cours de la dernière heure, regroupés par machine.
Rédige des instructions PromQL pour interroger le nombre d'appels à chaque opération API de l'Application A au cours des 5 dernières minutes dans ARMS.
Rédige des instructions PromQL pour interroger le nombre d'appels aux opérations API portant le tag payment/coupon dans l'Application A au cours des 5 dernières minutes.
Rédige des instructions PromQL pour interroger les 10 opérations API ayant le plus grand nombre d'appels.
Rédige des instructions PromQL pour interroger les cinq opérations API ayant le plus grand nombre d'appels dans l'Application A.

Nombre d'erreurs

Exemple de prompt
Rédige des instructions PromQL pour interroger le nombre d'erreurs de chaque opération API au cours des 5 dernières minutes.
Rédige des instructions PromQL pour interroger le nombre total d'erreurs de requêtes HTTP sur la machine dont l'adresse IP est 10.26.xx.xx au cours des 5 dernières minutes.
Rédige des instructions PromQL pour interroger l'opération API ayant généré le plus grand nombre d'erreurs au cours de la dernière heure.
Rédige des instructions PromQL pour interroger le nombre total d'erreurs d'appel survenues sur la machine dont l'adresse IP est 10.26.xx.xx et où le service ClothService est déployé, au cours des 10 dernières minutes.

Requêtes SQL lentes

Exemple de prompt
Rédige des instructions PromQL pour interroger les requêtes SQL lentes générées au cours des 10 dernières minutes.
Rédige des instructions PromQL pour interroger l'opération API causant le plus grand nombre de requêtes SQL lentes dans l'Application A au cours des 10 dernières minutes.
Rédige des instructions PromQL pour interroger les 10 opérations API causant le plus grand nombre de requêtes SQL lentes dans l'Application A.
Rédige des instructions PromQL pour interroger les requêtes SQL lentes générées au cours de la dernière heure.

Erreurs de base de données

Exemple de prompt
Rédige des instructions PromQL pour interroger les opérations API dont l'appel a échoué sur une base de données Redis au cours de la dernière minute.
Rédige des instructions PromQL pour interroger les cinq opérations API dont l'appel a échoué sur une base de données MySQL au cours de la dernière minute.

Codes de statut HTTP

Exemple de prompt
Rédige des instructions PromQL pour compter le nombre d'erreurs 4xx ou 5xx.
Rédige des instructions PromQL pour compter le nombre d'erreurs 400 et 500.
Rédige des instructions PromQL pour interroger le nombre de requêtes ayant retourné un code 4xx pour l'Application A.

Full GC de la JVM

Exemple de prompt
Rédige des instructions PromQL pour interroger le nombre de full GC survenus au cours de la dernière journée.
Rédige des instructions PromQL pour interroger le nombre de full GC survenus sur chaque machine au cours de la dernière heure.
Rédige des instructions PromQL pour interroger les machines sur lesquelles des full GC sont survenus dans l'Application A.
Rédige des instructions PromQL pour interroger les machines sur lesquelles des full GC sont survenus plus de cinq fois.

Durée des full GC de la JVM

Exemple de prompt
Rédige des instructions PromQL pour interroger le temps consommé par les full GC sur chaque machine.
Rédige des instructions PromQL pour interroger les cinq machines où les full GC consomment le plus de temps.
Rédige des instructions PromQL pour interroger les services où les full GC durent plus d'une seconde.

Tendances du QPS

Exemple de prompt
Rédige des instructions PromQL pour interroger les applications dont le nombre de requêtes d'accès augmente sur une période de 10 minutes.
Rédige des instructions PromQL pour interroger l'application dont le nombre de requêtes d'accès a le plus augmenté au cours de la dernière journée.
Rédige des instructions PromQL pour interroger l'opération API dont le nombre de requêtes d'accès augmente le plus rapidement dans l'Application A au cours de la dernière semaine.

Métriques incrémentielles

Exemple de prompt
Rédige des instructions PromQL pour surveiller la métrique `arms_mysql_requests_error_count` et envoyer une alerte si sa valeur augmente soudainement.
Rédige des instructions PromQL pour surveiller l'incrément de `jvm_threads_live_threads`.

Comparaisons de tendances

Exemple de prompt
Rédige des instructions PromQL pour vérifier si le nombre d'erreurs augmente ou diminue par rapport à hier.
Rédige des instructions PromQL pour interroger la variation du nombre de requêtes par rapport à l'heure précédente.
Rédige des instructions PromQL pour vérifier si le nombre d'exceptions augmente ou diminue par rapport à hier.
Rédige des instructions PromQL pour vérifier si le temps moyen consommé par les applications augmente ou diminue par rapport à l'heure précédente.
Rédige des instructions PromQL pour interroger la variation du temps moyen consommé par les applications.

Impact des full GC et des requêtes SQL lentes

Exemple de prompt
Rédige des instructions PromQL pour interroger les applications affectées par des full GC.
Rédige des instructions PromQL pour interroger les opérations API affectées par des full GC.
Rédige des instructions PromQL pour interroger les applications concernées par des requêtes SQL lentes.
Rédige des instructions PromQL pour interroger les opérations API causant des requêtes SQL lentes.

Nouvelles exceptions et erreurs

Exemple de prompt
Rédige des instructions PromQL pour interroger les applications dont le nombre d'erreurs augmente.
Rédige des instructions PromQL pour interroger les machines dont le nombre d'erreurs augmente.
Rédige des instructions PromQL pour interroger les opérations API dont le nombre d'erreurs augmente dans l'Application A.

Utilisation CPU

Exemple de prompt
Rédige des instructions PromQL pour interroger l'utilisation CPU de chaque machine.
Rédige des instructions PromQL pour interroger les cinq machines ayant la plus forte utilisation CPU au cours des 5 dernières minutes.
Rédige des instructions PromQL pour interroger les machines dont l'utilisation CPU dépasse 70 % dans l'Application A au cours des 5 dernières minutes.
Rédige des instructions PromQL pour interroger les cinq machines dont l'utilisation CPU augmente le plus rapidement au cours des 5 dernières minutes, en affichant leur taux d'utilisation.