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 : Ajouter les données Intune dans un workspace Log Analytics
• Partie 5 : Utiliser l’API Log Analytics pour effectuer des requêtes KQL avec PowerShell
• Partie 6 : Créer votre lab à partir de fausses données
• Partie 7 : donner un meilleur look à vos workbook

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

3. Cliquez sur New

4. Cliquez sur le bouton Save
5. 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

2. Ajoutez la requête suivante:

TestReport_CL
| summarize TestReport_CL = count() by BitlockerStatus_s

3. Dans Visualization, choisissez Pie chart

4. Cliquez sur Run query

5. Dans Size, sélectionnez Tiny

6. Allez dans Advanced settings

7. Allez dans Chart title
8. Saisissez un titre, tel que : Bitlocker status

9. Allez dans Style
10. Cochez Show border around content

11. Cliquez sur Done editing

12. 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

2. Allez dans Chart settings

3. Allez dans Series Settings

4. Configurez comme ci-dessous :

5. Cliquez sur Save and Close

6. 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

3. Dans Visualization, choisissez Pie chart
4. Dans Size, sélectionnez Tiny
5. Cliquez sur Run query

6. Allez dans Advanced settings
7. Allez dans Chart title
8. Saisissez un titre tel que : Devices per model
9. Allez dans Style
10. Cochez Show border around content
11. 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

4. Cliquez sur Move > Move into group

5. Cliquez sur OK

6. Cliquez sur Done editing
7. Dans la partie Devices per model, cliquez sur Edit
8. Allez dans Style
9. Cochez Make this item a custom width
10. Cliquez sur Move > Move into group
11. 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

3. Ci-dessous le résultat :

4. Allez dans Advanced settings
5. Allez dans Chart title
6. Saisissez un titre tel que : Devices information
7. Allez dans Style
8. Cochez Show border around content
9. 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

3. Cliquez sur Bitlocker status

4. Dans Column renderer, sélectionnez Thresholds

5. Cochez Custom formating

6. Allez dans Thresholds Settings
7. Changez l’icône par défaut sur Warning

8. Configurez ensuite comme ci-dessous:

• Operator : ==
• Value : Enabled
• Icons : Success

9. Cliquez sur Save and Close
10. Ci-dessous un aperçu :

11. Cliquez à nouveau sur Column Settings
12. Sélectionnez Disk size

13. Cochez Custom formating
14. Dans Units, sélectionnez Megabytes

15. Sélectionnez Free space

16. Cochez Custom formating
17. Dans Units, sélectionnez Megabytes
18. Cliquez sur Save and Close
19. Ci-dessous un aperçu :

Pourcentage de disque

20. Sélectionnez Free space %
21. Cochez Custom formating
22. Dans Units, sélectionnez Percentage

23. Dans Column renderer sélectionnez Thresholds
24. Allez dans Thresholds Settings
25. Sélectionnez Colors

26. Changez la couleur par default sur None

27. Configurez ensuite comme ci-dessous :

• Operator : <
• Value : 20
• Color : Red(Bright)

28. Ajoutez une nouvelle règle comme ci-dessous :

• Operator : >
• Value : 20
• Color : Green(Bright)

29. Cliquez sur Done Editing
30. Cliquez sur Save and Close
31. 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