Visualiser des données avec des tableaux de bord Azure Data Explorer

L’Explorateur de données Azure est un service d’exploration de données rapide et hautement évolutive pour les données des journaux et les données de télémétrie. Explorez vos données de bout en bout dans l’application web Azure Data Explorer, en commençant par l’ingestion des données, l’exécutionde requêtes et la création de tableaux de bord.

Un tableau de bord est une collection de vignettes, éventuellement organisées en pages, où chaque vignette a une requête sous-jacente et une représentation visuelle. À l’aide de l’interface utilisateur web, vous pouvez exporter en mode natif des requêtes Langage de requête Kusto (KQL) vers un tableau de bord en tant que visuels, puis modifier leurs requêtes sous-jacentes et leur mise en forme visuelle en fonction des besoins. Outre la facilité d’exploration des données, cette expérience de tableau de bord Azure Data Explorer entièrement intégrée offre des performances de requête et de visualisation améliorées.

Important

Vos données sont sécurisées. Les tableaux de bord et les métadonnées relatives aux tableaux de bord concernant les utilisateurs sont chiffrés au repos à l’aide de clés gérées par Microsoft.

L’image suivante montre un exemple de tableau de bord Azure Data Explorer :

Capture d’écran montrant un tableau de bord de l’interface utilisateur web Azure Data Explorer.

Pour explorer de manière interactive des exemples de tableaux de bord, consultez Démarrage rapide : Visualiser des exemples de tableaux de bord de données.

Prérequis

Créer un tableau de bord

  1. Dans la barre de navigation, sélectionnez Tableaux de bord>Nouveau tableau de bord.

    Nouveau tableau de bord.

  2. Entrez un nom de tableau de bord, puis sélectionnez Créer.

    Créer un tableau de bord.

Ajouter une source de données

Un tableau de bord unique peut afficher des visuels d’un ou de plusieurs clusters.

  1. Sélectionnez le menu Plus [...] >Sources de données

    Capture d’écran de l’ajout d’une source de données via le menu Plus.

  2. Dans le volet Sources de données, sélectionnez + Nouvelle source de données.

  3. Dans le volet Créer une nouvelle source de données :

    1. Entrer un Nom de source de données.
    2. Entrez la région de l’URI du cluster, puis sélectionnez Se connecter.
    3. Sélectionnez la Base de données dans la liste déroulante.
    4. Entrez une valeur pour l’âge maximal du cache des résultats de requête afin d’activer le cache des résultats de requête sur toutes les requêtes de cette source de données. L’âge maximal peut être exprimé en unités de secondes, d’heures ou de jours.
    5. Sélectionnez Create (Créer).

    Volet Source de données.

Ajouter une vignette

Les vignettes de tableau de bord utilisent des extraits de code Langage de requête Kusto pour récupérer des données et afficher des visuels. Chaque vignette/requête peut prendre en charge un seul visuel.

  1. Sélectionnez Ajouter une vignette dans le canevas du tableau de bord ou la barre de menus supérieure.

    Nouvelle requête.

  2. Dans le volet Requête :

    1. Sélectionnez la source de données dans le menu déroulant.

    2. Tapez la requête et sélectionnez Exécuter. Pour plus d’informations sur la génération de requêtes qui utilisent des paramètres, consultez Utiliser des paramètres dans votre requête.

    3. Sélectionner Visuel.

    Exécuter la requête.

  3. Dans l’onglet visuel, sélectionnez Type de visuel pour choisir le type de visuel.

  4. Sélectionnez Appliquer les changements pour épingler le visuel au tableau de bord.

    Ajouter un visuel à la requête.

  5. Vous pouvez redimensionner le visuel, puis sélectionner l’icône Enregistrer .

    enregistrer le tableau de bord.

Épingler la vignette de la requête

Vous pouvez également épingler une requête à partir de l’onglet requête de l’interface utilisateur web.

Pour épingler une requête :

  1. Créez et exécutez la requête dont vous souhaitez visualiser la sortie dans le tableau de bord.

  2. Sélectionnez Partager>Épingler au tableau de bord.

  3. Dans le volet Épingler au tableau de bord :

    1. Indiquez un nom de vignette.
    2. Le nom de la source de données est renseigné automatiquement à partir de la source de données de requête.
    3. Sélectionnez Utiliser une source de données existante si possible.
    4. Sélectionnez Créer nouveau.
    5. Entrez le nom du tableau de bord.
    6. Cochez la case Afficher le tableau de bord après sa création (s’il s’agit d’un nouveau tableau de bord).
    7. Sélectionnez Épingler.

    Capture d’écran du volet Épingler au tableau de bord.

Utilisation des paramètres

Les paramètres améliorent considérablement les performances de rendu des tableaux de bord et vous permettent d’utiliser des valeurs de filtre le plus tôt possible dans la requête. Le filtrage est activé quand le paramètre est compris dans la requête associée à vos vignettes. Pour plus d’informations sur la configuration et l’utilisation de différents types de paramètres, consultez Utiliser des paramètres dans les tableaux de bord Azure Data Explorer.

Afficher la requête

Vous pouvez afficher la requête en mode édition ou affichage. La modification de la requête sous-jacente d’une vignette n’est possible qu’en mode édition. En mode affichage, vous pouvez modifier la requête dans un nouvel onglet de requête, sans modifier la requête sous-jacente de la vignette du tableau de bord.

  1. Accédez à votre tableau de bord.

  2. Dans la vignette que vous souhaitez explorer, sélectionnez le menu Plus [...]>Afficher la requête.

    Un volet s’ouvre avec la requête et la table de résultats.

  3. Sélectionnez l’onglet Nouvelle requête. Continuez à modifier la requête dans le volet de requête de l’interface utilisateur web Azure Data Explorer.

Capture d’écran du volet afficher la requête avec la requête dans la moitié supérieure de l’écran et les résultats dans la moitié inférieure.

Notes

Les modifications apportées à la requête à l’aide de ce flux ne sont pas répercutées dans le tableau de bord d’origine.

Partager des tableaux de bord

Utilisez le menu Partager pour accorder des autorisations à un utilisateur Microsoft Entra ou Microsoft Entra groupe pour accéder au tableau de bord, modifier le niveau d’autorisation d’un utilisateur et partager le lien du tableau de bord.

Important

Pour accéder au tableau de bord, un afficheur de tableau de bord a besoin des éléments suivants :

  • Lien du tableau de bord pour l’accès
  • Autorisations du tableau de bord
  • Accès à la base de données sous-jacente dans le cluster Azure Data Explorer

Gérer les autorisations

  1. Sélectionnez l’élément de menu Partager dans la barre supérieure du tableau de bord.

  2. Sélectionnez Gérer les autorisations dans la liste déroulante.

    Liste déroulante de partage de tableau de bord.

Accorder des autorisations

Pour accorder des autorisations à un utilisateur dans le volet Autorisations du tableau de bord :

  1. Entrez le Microsoft Entra utilisateur ou Microsoft Entra groupe dans Ajouter de nouveaux membres.
  2. Dans le niveau Autorisation, sélectionnez l’une des valeurs suivantes : Peut voir ou Peut modifier.
  3. Sélectionnez Ajouter.

Gérer les autorisations du tableau de bord.

Changer le niveau d’autorisation d’un utilisateur

Pour changer le niveau d’autorisation d’un utilisateur dans le volet Autorisations du tableau de bord :

  1. Utilisez la zone de recherche ou faites défiler la liste des utilisateurs pour trouver l’utilisateur.
  2. Changez le niveau d’autorisation en fonction des besoins.

Pour partager le lien du tableau de bord, effectuez une des opérations suivantes :

  • Sélectionnez Partager, puis sélectionnez Copier le lien
  • Dans la fenêtre Autorisations du tableau de bord, sélectionnez Copier le lien.

Exporter des tableaux de bord

Utilisez le menu Fichier pour exporter un tableau de bord vers un fichier JSON. L’exportation du tableau de bord peut être utile dans les scénarios suivants :

  • Gestion de versions : vous pouvez utiliser le fichier pour restaurer une version précédente du tableau de bord.
  • Modèle de tableau de bord : vous pouvez utiliser le fichier en tant que modèle pour créer des tableaux de bord.
  • Modification manuelle : vous pouvez modifier le fichier pour modifier le tableau de bord. Le fichier peut être réimporté dans le tableau de bord.

Pour exporter un tableau de bord, dans le tableau de bord, sélectionnez Fichier>Exporter vers un fichier.

Capture d’écran d’un tableau de bord montrant l’option d’exportation vers un fichier.

Le fichier contient les données du tableau de bord au format JSON, dont la structure est montrée dans l’extrait de code suivant.

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

Pour créer un tableau de bord à partir d’un fichier

Vous pouvez utiliser un fichier de tableau de bord pour créer un tableau de bord comme suit :

  1. Dans la page principale du tableau de bord, sélectionnez Nouveau tableau de bord>Importer à partir d’un fichier.

    Capture d’écran d’un tableau de bord montrant l’option d’importation à partir d’un fichier.

  2. Sélectionnez le fichier à importer.

  3. Entrez un nom de tableau de bord, puis sélectionnez Créer.

Pour mettre à jour ou restaurer un tableau de bord existant à partir d’un fichier

Vous pouvez mettre à jour un tableau de bord existant ou restaurer une version antérieure comme suit :

  1. Dans le tableau de bord, sélectionnez Fichier>Remplacer par le fichier.

    Capture d’écran d’un tableau de bord montrant l’option de remplacement par un fichier.

  2. Sélectionnez le fichier pour mettre à jour le tableau de bord.

  3. Sélectionnez Enregistrer les modifications.

Ajouter une page

Les pages sont des conteneurs facultatifs pour les vignettes. Vous pouvez utiliser des pages pour organiser les vignettes en groupes logiques, par exemple par source de données ou par zone d’objet. Vous pouvez également utiliser des pages pour créer un tableau de bord avec plusieurs vues, par exemple un tableau de bord avec une extraction d’une page de résumé vers une page de détails.

  1. Dans le volet Pages de gauche, sélectionnez + Ajouter une page.

  2. Pour nommer la page, sélectionnez le menu vertical Plus [...]>Renommer la page.

  3. Ajoutez des vignettes à la page.

Activer l’actualisation automatique

L’actualisation automatique est une fonctionnalité qui vous permet de mettre à jour automatiquement les données d’un tableau de bord sans recharger manuellement la page ou cliquer sur un bouton Actualiser.

Le taux d’actualisation automatique par défaut peut être défini par un éditeur de base de données. Les éditeurs et les visionneuses peuvent modifier le taux réel d’actualisation automatique lors de l’affichage d’un tableau de bord.

Capture d’écran des différents intervalles de temps disponibles dans l’actualisation automatique dans les tableaux de bord.

Toutefois, les éditeurs de base de données peuvent vouloir limiter la fréquence d’actualisation minimale que toute visionneuse peut définir afin de réduire la charge du cluster. Lorsque le taux d’actualisation minimal est défini, les utilisateurs de base de données ne peuvent pas définir un taux d’actualisation inférieur au minimum.

  1. Sélectionnez le menu Plus [...]>Actualisation automatique.

    Sélectionner l’actualisation automatique.

  2. Activez ou désactivez l’option pour activer l’actualisation automatique.

  3. Sélectionnez des valeurs pour Intervalle de temps minimal et Fréquence d’actualisation par défaut.

    Activer l’actualisation automatique.

  4. Sélectionnez Appliquer et enregistrez le tableau de bord.