Partager via

Créer et exécuter un notebook avec Journaux Azure Monitor (Préversion)

  • Article

Important

Azure Data Studio sera mis hors service le 28 février 2026. Nous vous recommandons d’utiliser Visual Studio Code. Pour plus d’informations sur la migration vers Visual Studio Code, visitez Qu’est-ce qui se passe dans Azure Data Studio ?

Cet article explique comment créer et exécuter un notebook Azure Data Studio en utilisant l’extension Journaux Azure Monitor pour vous connecter à un espace de travail Log Analytics et visualiser les résultats pour une base de données Azure SQL.

Une fois l’extension Journaux Azure Monitor installée, vous pouvez vous connecter à vos espaces de travail Journaux Azure Monitor, parcourir les tables, écrire/exécuter des requêtes KQL sur des espaces de travail et écrire/exécuter des notebooks connectés au noyau Log Analytics.

Avec l’extension Journaux Azure Monitor, vous pouvez définir l’option de noyau sur Log Analytics.

Actuellement, cette fonctionnalité est uniquement disponible en tant que version préliminaire.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte Azure gratuit avant de commencer.

Les prérequis suivants sont également obligatoires :

Se connecter à un espace de travail Journaux Azure Monitor (Log Analytics)

Il existe deux tables principales dans l’espace de travail Azure Log Analytics (Journaux Azure Monitor) qui capturent les événements Azure SQL :

Dans les exemples ci-dessous, cet article utilise la table AzureDiagnostics et la table AzureMetric dans un espace de travail Log Analytics, qui stocke des données d’événement Azure SQL. Nous avons auparavant configuré Azure SQL pour qu’il écrive ses événements sélectionnés dans un espace de travail Log Analytics. Découvrez comment faire cela ici.

Vous pouvez vous connecter à un espace de travail Log Analytics.

Créer un notebook Journaux Azure Monitor

Les étapes suivantes montrent comment créer un fichier de notebook dans Azure Data Studio :

  1. Dans Azure Data Studio, connectez-vous à votre espace de travail Log Analytics.

  2. Accédez au volet Connexions et, sous la fenêtre Serveurs, cliquez avec le bouton droit sur l’espace de travail Log Analytics et sélectionnez Nouveau notebook. Vous pouvez également accéder à Fichier>Nouveau Notebook.

    Capture d’écran d’Ouvrir un notebook.

  3. Sélectionnez Log Analytics pour Noyau. Vérifiez que le menu Attacher à est défini sur le nom de l’espace de travail.

    Capture d’écran de Définir le noyau et Attacher à.

Vous pouvez enregistrer le notebook à l’aide de la commande Enregistrer ou Enregistrer sous du menu Fichier.

Pour ouvrir un notebook, vous pouvez utiliser la commande Ouvrir le fichier du menu Fichier, sélectionner Ouvrir le fichier dans la page Bienvenue, ou utiliser la commande Fichier : Ouvrir dans la palette de commandes.

Changer la connexion

Pour changer la connexion Journaux Azure Monitor pour un notebook :

  1. Sélectionnez le menu Attacher à dans la barre d’outils du notebook, puis sélectionnez Changer la connexion.

    Capture d’écran de Changer de connexion.

    Remarque

    Vérifiez que la valeur de l’espace de travail est renseignée. Les notebooks de Journaux Azure Monitor doivent avoir l’ID d’espace de travail spécifié dans le champ Serveur.

  2. Vous pouvez maintenant sélectionner un serveur de connexion récent ou entrer les détails d’une nouvelle connexion pour vous connecter.

    Capture d’écran de Sélectionner un autre cluster.

Exécuter une cellule de code

Vous pouvez créer des cellules contenant des requêtes KQL que vous pouvez exécuter en cliquant sur le bouton Exécuter la cellule situé à gauche de la cellule. Les résultats sont affichés dans le notebook après l’exécution de la cellule.

Par exemple :

Ajoutez une nouvelle cellule de code en sélectionnant la commande + Code dans la barre d’outils.

Capture d’écran d’un bloc de code de noyau.

Interroger les résultats du journal pour une base de données Azure SQL

Vous pouvez vous connecter à vos espaces de travail Log Analytics pour parcourir les tables, écrire des requêtes KQL sur des espaces de travail et créer des notebooks connectés au noyau Log Analytics.

Remarque

Attendez environ 15 minutes, le temps que les résultats des journaux apparaissent.

Des exemples de requêtes sont listés ci-dessous.

AzureMetrics

Voici un exemple de requête pour visualiser les résultats d’AzureMetrics.

AzureMetrics

Capture d’écran des résultats des cellules de code des métriques Azure.

AzureDiagnostics

Voici un exemple de requête pour visualiser les résultats d’AzureDiagnostics.

La table AzureDiagnostics a tendance à contenir plus de détails que la table AzureMetrics.

AzureDiagnostics
| project-away TenantId, ResourceId, SubscriptionId, _ResourceId, ResourceGroup // hide sensitive info
| take 10

Capture d’écran des résultats des cellules de code des diagnostics Azure.

Analyser les événements par paramètres de diagnostic

Voici une requête pour analyser le nombre d’événements par nom d’opération.

Remarque

Chaque ligne d’AzureDiagnostic représente un événement pour une opération ou une catégorie spécifique. Certaines actions SQL peuvent entraîner la génération de plusieurs événements de différents types.

AzureDiagnostics
| summarize count() by OperationName

Capture d’écran des diagnostics Azure récapitulant les résultats des cellules de code.

Vous pouvez essayer d’autres exemples du dépôt d’exemple Journaux Azure Monitor.

Contenu connexe