Les blocs de requêtes sont le composant principal des notebooks, vous permettant d'écrire des requêtes NRQL et de visualiser les résultats dans votre document. Vous pouvez ajouter plusieurs blocs de requêtes à un seul notebook pour construire un récit de données complet.
Bloc actif
Le bloc actif est l'unité interactive actuellement sélectionnée dans votre bloc-notes. Il vous sert d'espace de travail immédiat pour écrire du code, exécuter des requêtes ou ajouter de la documentation.
Le bloc actif est immédiatement visible, ce qui permet de le repérer facilement dans votre bloc-notes. Elle se distingue par deux indices visuels clés :
- Bordures transparentes: Le bloc actif est mis en évidence par une bordure de couleur distincte et transparente.
- Barre d'outils visible: C'est la seule cellule qui affiche les actions.
Les requêtes provenant de Data Explorer sont ajoutées au bloc actif si celui-ci est de type requête. Si le bloc actif est actuellement au format Markdown, un nouveau bloc de requête est ajouté.
Pour modifier un bloc actif, vous devez sélectionner ou ajouter un autre bloc dans le bloc-notes.
Lorsqu'un bloc Markdown est actif, il passe automatiquement en mode édition avec une mise en page à deux colonnes :
- Colonne d'édition (gauche): C'est ici que vous saisissez et mettez en forme votre code Markdown.
- Colonne d'aperçu en direct (à droite): Cette colonne affiche un aperçu visuel en temps réel de votre documentation formatée.
Barre d'outils Action
Pour vous aider à optimiser votre espace de travail et à conserver une vue dégagée, l'interface des ordinateurs portables comporte une barre d'outils d'actions. Il regroupe les actions de requête principales dans un menu compact à base d'icônes et regroupe les commandes secondaires dans un menu Actions dédié.
Actions principales (Haut du bloc de requête)
Ces actions essentielles et fréquemment utilisées sont accessibles en haut du bloc de requête :
- Exécuter la requête: Cette fonction est désormais représentée par une icône de lecture et exécute la requête en cours.
- Requêtes récentes: Permet d'accéder rapidement à vos 10 dernières requêtes exécutées lors de votre session actuelle et de les réutiliser.
- Requête recommandée: Fournit des suggestions de requête.
- Copier le lien de la requête: Génère un lien partageable vers la requête actuelle.
Menu Actions (Commandes secondaires)
Le menu Actions contient des commandes supplémentaires, moins fréquemment utilisées ou liées à l'organisation.
- Ajouter une autre requête: Insère un nouveau bloc de requête vide dans votre bloc-notes.
- Supprimer la requête: Supprime la requête des TIMESERIES multi-requêtes.
- Traducteur PromQL: Un utilitaire permettant de traduire des requêtes en PromQL (langage de requête Prometheus).
- Effacer: Supprime la requête de l'entrée de requête.
- Créer une alerte: Lance le processus de création d'une nouvelle alerte basée sur les résultats de la requête.
- Monter/descendre/en haut/en bas: Réorganise la position du bloc de requête actuel dans le bloc-notes.
- Supprimer le bloc: Supprime le bloc actif.
Ajouter un bloc de requête
Pour ajouter un bloc de requête à votre notebook :
- Ouvrez votre bloc-notes dans la console de requêtes.
- Cliquez + Query.
- Saisissez votre requêteNRQL dans l'éditeur de requêtes.
- Appuyez sur Run ou sur Enter pour lancer la requête et afficher les résultats.
Conseil
Toutes les requêtes NRQL prises en charge dans le générateur de requêtes standard fonctionnent dans des blocs de requêtes notebook. Vous pouvez requêter n'importe quel type de données, y compris les métriques, les événements, les logs et les traces. Tous les types de graphiques et les personnalisations disponibles dans le générateur de requêtes standard sont pris en charge dans les notebooks.
gestion des blocs de requêtes
Quelle est la prochaine étape ?
- Retournez à la page « Premiers pas avec les carnets » pour un aperçu.
- Explorez Dashboards pour créer des visualisations de données persistantes
- Découvrez plus d'informations sur les types de graphiques pour les options de visualisation.