Débuter avec Log Analytics : Partie 3 – Création du workbook

Dans cet article nous allons continuer la série d’articles sur Log Analytics en créant notre 1er rapport, workbook, en utilisant les données importées avec Intune et PowerShell.

La série d’article

  • Partie 1 : Création du workspace Log Analytics
  • Partie 2 : Importation d’informations dans le workspace
  • Partie 3 : Création du workbook (vous êtes ici)
  • Partie 4 : Interroger Log Analytics avec PowerShell et Graph (à venir)

Les données importées

Dans l’article précédent, nous avons :

  • Créé un script PowerShell permettant de récupérer certaines informations depuis des postes
  • Créé un package de remédiation Intune pour exécuter ce script sur les postes
  • Envoyé ces informations dans Log Analytics au travers de Intune

Les données que nous importons depuis les postes sont les suivantes :

  • Nom de la machine
  • Utilisateur connecté
  • Modèle du poste
  • Version de BIOS
  • Taille totale du disque
  • Espace libre du disque
  • Espace libre en pourcentage
  • Statut de Bitlocker

Pour rappel, ces données sont localisées dans le Custom Log: TestReport_CL précédemment créé, voir ici pour plus d’infos.

Notre workbook

Maintenant que nous avons récupéré les informations depuis les postes, il est temps de les mettre en forme dans un dashboard explicite.

Dans ce dashboard nous souhaitons avoir:

  • Un camembert avec le nombre de postes avec ou sans BitLocker
  • Un camembert avec le nombre de postes par modèle
  • Un tableau avec toutes les informations

De plus dans ce tableau nous souhaitons:

  • Ajouter une icône d’alerte si BitLocker est désactivé
  • Mettre le fond en vert si le pourcentage d’espace libre du disque est > 20%
  • Mettre le fond en orange si le pourcentage d’espace libre du disque est < 20%

Sources à télécharger

Cliquez sur l’image ci-dessous pour récupérer le fichier Workbook_DeviceInfo.json
Ce fichier nous servira à créer le workbook.

Création manuelle du workbook

Dans cette partie nous allons créer étape par étape le workbook.
Vous pouvez également utiliser le workbook déjà existant, au format JSON (Workbook_DeviceInfo.json), disponible dans le dossier de téléchargement.

  1. Allez dans votre workspace Log Analytics
  2. Allez dans Workbooks
  1. Cliquez sur New
  1. Cliquez sur le bouton Save
  2. Saisissez un nom

Nous allons maintenant mettre en forme notre workbook.

Création des requêtes

Les requêtes vont nous permettre de créer des tableaux, camemberts… pour mettre en forme les données.
Pour rappel, dans notre workbook nous voulons:

  • Un camembert avec le nombre de postes avec ou sans BitLocker
  • Un camembert avec le nombre de postes par modèle
  • Un tableau avec toutes les informations de notre table TestReport_CL

Pie chart : Bitlocker activé ou non

  1. Cliquez sur Add query
  1. Ajoutez la requête suivante:
TestReport_CL
| summarize TestReport_CL = count() by BitlockerStatus_s
  1. Dans Visualization, choisissez Pie chart
  1. Cliquez sur Run query
  1. Dans Size, sélectionnez Tiny
  1. Allez dans Advanced settings
  1. Allez dans Chart title
  2. Saisissez un titre, tel que : Bitlocker status
  1. Allez dans Style
  2. Cochez Show border around content
  1. Cliquez sur Done editing
  1. Ci-dessous un aperçu :

Comprendre la requête

Dans cette requête, nous vérifions le contenu du Custom Log en utilisant la table : TestReport_CL.
Nous analysons le nombre d’appareil en fonction du champ BitlockerStatus_s, comme ci-dessous:
| summarize TestReport_CL = count() by BitlockerStatus_s

Changez les couleurs

Dans cet exemple, nous souhaitons configurer les couleurs suivantes:

  • Appareils avec BitLocker activé : vert
  • Appareils avec BitLocker désactivé : rouge
  1. Editez la requête
  1. Allez dans Chart settings
  1. Allez dans Series Settings
  1. Configurez comme ci-dessous :
  1. Cliquez sur Save and Close
  1. Ci-dessous un aperçu :

Pie chart : appareils par modèle

  1. Cliquez sur Add query
  2. Ajoutez la requête suivante :
TestReport_CL
| summarize TestReport_CL = count() by Model_s
  1. Dans Visualization, choisissez Pie chart
  2. Dans Size, sélectionnez Tiny
  3. Cliquez sur Run query
  1. Allez dans Advanced settings
  2. Allez dans Chart title
  3. Saisissez un titre tel que : Devices per model
  4. Allez dans Style
  5. Cochez Show border around content
  6. Cliquez sur Done editing

Comprendre la requête

Dans cette requête, nous vérifions le contenu du Custom Log en utilisant la table : TestReport_CL.
Nous analysons le nombre d’appareil en fonction du champ LocalAdminStatus_s, comme ci-dessous :
| summarize TestReport_CL = count() by LocalAdminStatus_s

Création d’un groupe

Maintenant que nous avons nos 2 camemberts, nous allons les assembler dans un groupe, afin des les afficher côte à côte.
Pour cela, nous allons procéder comme ci-dessous :

  1. Dans la partie Bitlocker status, cliquez sur Edit
  2. Allez dans Style
  3. Cochez Make this item a custom width
  1. Cliquez sur Move > Move into group
  1. Cliquez sur OK
  1. Cliquez sur Done editing
  2. Dans la partie Devices per model, cliquez sur Edit
  3. Allez dans Style
  4. Cochez Make this item a custom width
  5. Cliquez sur Move > Move into group
  6. Ci-dessous le résultat :

Tableau avec les informations

  1. Cliquez sur Add query
  2. Ajoutez la requête suivante :
TestReport_CL
| project Computer=ComputerName_s, User=User_s, Model=Model_s,
['BIOS version']=BIOSVersion_s,['Bitlocker status']=Bitclockerstatus_d,
['Disk size']=FullDiskSize_d,['Free space']=FreeDiskSpace_d,['Free space %']=FreeDiskPercent_d
  1. Ci-dessous le résultat :
  1. Allez dans Advanced settings
  2. Allez dans Chart title
  3. Saisissez un titre tel que : Devices information
  4. Allez dans Style
  5. Cochez Show border around content
  6. Ci-dessous un aperçu :

Comprendre la requête

Dans cette requête, nous vérifions le contenu du Custom Log en utilisant la table : TestReport_CL.

Ajout d’icône et couleurs

Dans cet exemple, nous souhaitons :

  • Ajouter une icône d’alerte si BitLocker est désactivé
  • Mettre le fond en vert si le pourcentage d’espace libre du disque est > 20%
  • Mettre le fond en orange si le pourcentage d’espace libre du disque est < 20%

Bitlocker status

  1. Editez la requête
  2. Cliquez sur Column Settings
  1. Cliquez sur Bitlocker status
  1. Dans Column renderer, sélectionnez Thresholds
  1. Cochez Custom formating
  1. Allez dans Thresholds Settings
  2. Changez l’icône par défaut sur Warning
  1. Configurez ensuite comme ci-dessous:
  • Operator: ==
  • Value: Enabled
  • Icons: Success
  1. Cliquez sur Save and Close
  2. Ci-dessous un aperçu :
  1. Cliquez à nouveau sur Column Settings
  2. Sélectionnez Disk size
  1. Cochez Custom formating
  2. Dans Units, sélectionnez Megabytes
  1. Sélectionnez Free space
  1. Cochez Custom formating
  2. Dans Units, sélectionnez Megabytes
  3. Cliquez sur Save and Close
  4. Ci-dessous un aperçu :

Pourcentage de disque

  1. Sélectionnez Free space %
  2. Cochez Custom formating
  3. Dans Units, sélectionnez Percentage
  1. Dans Column renderer sélectionnez Thresholds
  2. Allez dans Thresholds Settings
  3. Sélectionnez Colors
  1. Changez la couleur par default sur None
  1. Configurez ensuite comme ci-dessous :
  • Operator : <
  • Value : 20
  • Color : Red(Bright)
  1. Ajoutez une nouvelle règle comme ci-dessous :
  • Operator : >
  • Value : 20
  • Color : Green(Bright)
  1. Ci-dessous un aperçu :
  2. Cliquez sur Done Editing
  3. Cliquez sur Save and Close
  4. Ci-dessous un aperçu :

Ajout du workbook au format JSON

  1. Créez un nouveau workbook
  2. Allez dans Advanced editor
  3. Cherchez la ligne “fallbackResourceIds”: [
  4. Supprimez tout ce qui est au dessus
  5. Copiez le contenu de Workbook_DeviceInfo.json au dessus
  6. Cliquez sur Apply
  7. Le workbook s’affiche

A propos de l'auteur

Consultant Modern Workplace travaillant principalement sur ce qui tourne autour du poste de travail (MDT, SCCM, Intune, Graph...) et l’automatisation avec PowerShell. MVP Microsoft (depuis 5ans) et auteur pour ENI, il publie régulièrement sur son blog et gère différents groupes Facebook, PowerShell et WPF (~9000 membres), Windows Autopilot (~6900membres).

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée.