Débuter avec Log Analytics : Partie 7 – Améliorer le design de vos workbooks

Dans cet article, nous allons continuer notre série avec Log Analytics et voir comment donner un meilleur design à vos rapports Log Analytics.

La série d’articles

• Partie 1 : Création du workspace Log Analytics
• Partie 2 : Importation d’informations dans le workspace
• Partie 3 : Création du workbook
• 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 (vous êtes ici)

Article précédent

Dans l’article précédent, nous avons importé de fausses données dans un Custom Log.
Les données étaient localisées dans un CSV et ont été automatiquement intégrées à Log Analytics.
L’idée est d’avoir un Custom Log avec des données afin de jouer avec Workbook, KQL et les requêtes.

Notre workbook

Nous allons créer un faux workbook de mise à jour du BIOS.
Nous avons les données suivantes de notre CSV :

Que voulons-nous ?
La première étape consiste à réfléchir à ce que nous voulons afficher dans le classeur.
Nous voulons les choses suivantes :

• Un camembert avec le nombre d’appareils à jour ou non
• Les nombres d’appareils non à jour par modèle
• Les appareils comptent avec le BIOS non mis à jour par version du BIOS
• Un tableau avec les détails de laayant les plus vieux BIOS
• Un tableau des appareils dont le BIOS n’est pas à jour
• Un tableau des appareils dont le BIOS date de plus de 2 ans

Chaque partie mentionnée précédemment peut être réalisée en ajoutant des requêtes.

Ajout de requêtes

Camembert de l’état de la mise à jour du BIOS

L’idée est d’afficher un camembert montrant l’état de la mise à jour du BIOS avec deux valeurs possibles :

• À jour
• Pas à jour

Voir ci-dessous le résultat attendu :

Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query

2. Allez dans l’onglet Settings

3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous :

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| summarize LenovoBIOSreport_CL = count() by BIOSStatus_s, DeviceModel_s

5. Si vous avez renommé le nom du journal personnalisé ou le changement de colonne ici
6. Allez à Visualisation
7. Sélectionnez Pie Chart

8. Cliquez sur Done Editing
9. Voir ci-dessous le résultat que nous obtenons :

Nombre d’appareils non à jour par modèle

L’idée est d’afficher un graphique à secteurs montrant les périphériques dont le BIOS n’est pas à jour par modèle.
Voir ci-dessous le résultat attendu :

Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query
2. Allez dans l’onglet Settings
3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| where BIOSStatus_s == "notuptodate"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| summarize LenovoBIOSreport_CL = count() by DeviceModel_s

5. Allez à Visualisation
6. Sélectionnez Tiles

7. Cliquez sur Done Editing
8. Voir ci-dessous le résultat que nous obtenons

Camembert avec BIOS non à jour par nombre de jours

L’idée est d’afficher un graphique à secteurs montrant le nombre d’appareils dont le BIOS n’est pas à jour par jours, par exemple nous avons 10 appareils qui ont un BIOS de plus de 2 ans ou 10 appareils avec un BIOS de plus de 2 mois…
Voir ci-dessous le résultat attendu :
Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query
2. Allez dans l’onglet Settings
3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| where BIOSStatus_s == "notuptodate"
| where DateDiffDelay_s <> ""
| where DateDiffDelay_s <> "730"
| where DateDiffDelay_s <> "1_365"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| summarize LenovoBIOSreport_CL = count() by DateDiffDelay_s, DeviceModel_s
| where DeviceModel_s has_any ({ComputerModel})

5. Allez à Visualisation
6. Sélectionnez Pie Chart
7. Cliquez sur Done Editing
8. Voir ci-dessous le résultat que nous obtenons

Un tableau avec les détails de la mise à jour du BIOS

L’idée est d’afficher un tableau avec les informations dont nous disposons.
C’est pour les deux appareils avec BIOS qui sont à jour et non à jour.
Voir ci-dessous le résultat attendu :

Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query
2. Allez dans l’onglet Settings
3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| project ['BIOS state ?']=BIOSStatus_s, Computer=ComputerName_s, User=UserName_s, Model=DeviceModel_s, ['Not updated since (in days']=NotUpdatedSince_s,
['Current BIOS version']=CurrentVersionBIOS_s,['New BIOS version']=NewVersionBIOS_s
| where "{ComputerName:escape}" == "*" or Computer contains "{ComputerName:escape}" or "{ComputerName:escape}" == "All devices"

5. Cliquez sur Done Editing

Un tableau des appareils dont le BIOS n’est pas à jour

C’est la même chose qu’avant mais uniquement pour les appareils dont le BIOS n’est pas à jour.
Voir ci-dessous le résultat attendu :

Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query
2. Allez dans l’onglet Settings
3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| where BIOSStatus_s == "notuptodate"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| project Computer=ComputerName_s,User=UserName_s, Model=DeviceModel_s, ['Not updated since (in days']=NotUpdatedSince_s,
['Current BIOS version']=CurrentVersionBIOS_s,['New BIOS version']=NewVersionBIOS_s
| where "{ComputerName:escape}" == "*" or Computer contains "{ComputerName:escape}" or "{ComputerName:escape}" == "All devices"
| where Model has_any ({ComputerModel})

5. Cliquez sur Done Editing

Un tableau des appareils dont le BIOS date de plus de 2 ans

Nous voulons afficher un tableau avec des informations sur les appareils dont le BIOS n’est pas à jour depuis plus de 2 ans.
Voir ci-dessous le résultat attendu :

Nous allons procéder comme ci-dessous :

1. Cliquez sur Add > Query
2. Allez dans l’onglet Settings
3. Accédez à la partie Logs Query
4. Copiez la requête ci-dessous

LenovoBIOSreport_CL
| where ScriptStatus_s == "Success"
| where BIOSStatus_s == "notuptodate"
| where DateDiffDelay_s == "730_More"
| summarize arg_max(TimeGenerated,*) by ComputerName_s
| project ['BIOS uptodate ?']=BIOSStatus_s, Computer=ComputerName_s,User=UserName_s, Model=DeviceModel_s, ['Not updated since (in days']=NotUpdatedSince_s,['Current BIOS version']=CurrentVersionBIOS_s,['New BIOS version']=NewVersionBIOS_s

5. Cliquez sur Done Editing

Donnez à votre workbook un meilleur design

Nous allons d’abord modifier toutes les requêtes afin de :

• Ajouter un titre
• Ajouter une bordure
• Changer la taille principale

Configuration du titre, de la bordure et de la taille

Pour ce faire nous allons procéder comme ci-dessous sur chaque requête :

1. Allez sur la requête
2. Cliquez sur Edit
3. Allez dans la partie Settings
4. Aller dans Size
5. Choisissez Tiny
6. Allez dans Advanced settings
7. Aller dans Chart title
8. Ajouter un titre
9. Aller dans Style
10. Cochez Show border around content

11. Cliquez sur Done editing

Voyons maintenant à quoi cela ressemble maintenant :

Ajout d’une barre de recherche pour le tableau

Ok c’est cool, maintenant ajoutons une barre de recherche au-dessus de chaque tableau.
Nous allons procéder comme ci-dessous :

1. Accédez à chaque requête de table
2. Cliquez sur Edit
3. Allez dans Advanced settings
4. Cochez Show filter field above grid

5. Cliquez sur Done editing
6. Voir ci-dessous le résultat :

Ajout de quelques icônes

Maintenant dans le tableau avec les informations sur les périphériques pour les mises à jour du BIOS et non.
Nous avons une colonne d’état du BIOS, donc l’idée est maintenant de remplacer les mots uptodate et notuptodate par des icônes.
Nous allons procéder comme ci-dessous :

1. Cliquez sur Edit
2. Allez dans Settings
3. Cliquez sur Column settings

4. Accédez à BIOS state
5. Allez dans Column renderer

6. Sélectionnez Thresholds

7. Sélectionnez Icons
8. Configurez-le comme ci-dessous :

9. Voir ci-dessous le résultat :

Ajout d’onglets

Allons maintenant plus loin.
Nous avons pour type d’informations :

• Graphiques
• Tableau

Nous souhaitons maintenant les afficher dans deux onglets :

• Aperçu des onglets avec tous les camemberts
• Détails de l’onglet avec tous les tableaux

Nous allons d’abord créer nos deux onglets comme ci-dessous :

1. Cliquez sur Add > Adds links/tabs

2. Allez dans Style
3. Sélectionnez Tabs

4. Allez dans le champ de texte
5. Saisissez BIOS update resume
6. Allez dans Action
7. Choisissez Set a parameter value
8. Allez à Value
9. Saisissez SelectedTab
10. Allez dans Settings
11. Saisissez Resume
12. Accédez au champ de texte ci-dessous
13. Saisissez BIOS update details
14. Allez dans Action
15. Choisissez Set a parameter value
16. Allez dans Value
17. Saisissez SelectedTab
18. Allez dans Settings
19. Saisissez Details
20. Voir ci-dessous le résultat :

21. Cliquez sur Done editing
22. Cliquez sur les 3 points
23. Cliquez sur Move to top

Nous avons maintenant deux onglets mais si nous cliquons dessus, cela ne fait rien.
C’est parce que nous devons lier chaque requête sur l’onglet approprié.
Au point 10 & 18 avant nous avons configuré une valeur Paramètres.
Nous avons là CV et détails.
Nous ajouterons ces valeurs à nos requêtes pour les lier à l’onglet approprié.

Nous allons procéder comme ci-dessous :

1. Accédez à chaque requête
2. Cliquez sur Edit
3. Accédez à Advanced settings
4. Cochez Make this item conditionnaly visible
5. Cliquez sur Add condition
6. Dans Parameter name, tapez SelectedTab
7. Laissez equals
8. Allez dans Parameter value
9. Saisissez Resume ou Details
10. Cliquez sur Save

Maintenant, si vous cliquez sur « Reprendre », seuls les graphiques seront affichés et si vous cliquez sur « Détails », seuls les tableaux seront répertoriés.

Dans une prochaine étape, nous souhaitons ajouter des filtres qui seront utilisés pour filtrer les données sur tous les onglets et pas seulement sur une requête.

On veut par exemple :

• Filtre avec case à cocher pour filtrer sur les modèles
• Menu déroulant pour filtrer sur le nombre de jours anciens
• Une zone de texte pour filtrer sur le nom de l’appareil

Ajouter des filtres

Filtrage sur les modèles

Ce filtre doit être disponible pour les onglets CV et Détails.
Nous allons le créer comme ci-dessous :

1. Cliquez sur Add > Add parameters
2. Cliquez sur le bouton Add parameter
3. Dans Parameter name, tapez ComputerModel
4. Dans Display name, tapez Filter on device model
5. Dans Parameter type, choisissez
6. Cochez Allow multiple selections
7. Limitez multiple selections
8. Allez dans la partie Logs Query
9. Tapez la requête ci-dessous :
10. Cliquez sur Run query
11. Allez dans Include dans le menu déroulant
12. Cochez All
13. Aller dans Default selected item
14. Cochez All
15. Cliquez sur Save
16. Voir ci-dessous le résultat

Filtrage sur le nom de l’appareil

2. Cliquez sur le bouton Add parameter button
3. Tapez ComputerName
4. Allez sur Display name
5. Tapez Type a device name
6. Cliquez sur Save
7. Cliquez sur Done editing
8. Allez dans Advanced settings
9. Cochez Make this item conditionally visible
10. Cliquez sur Add condition
11. Dans Parameter name, tapez SelectedTab
12. Dans Parameter value, saisissez Détails
13. Cliquez sur Save
14. Cliquez sur Done editing
15. Voir ci-dessous le résultat

Nous avons ajouter le filtre mais cocher ou décocher les modèles ne fera rien.
C’est parce que nous devons lier l’action sur le filtre à notre graphique et nos tables.

Pour ce faire nous allons procéder comme ci-dessous :

1. Modifiez chaque requête de graphique
2. Allez dans la partie Settings
3. Tapez la ligne ci-dessous à la fin de la requête :
4. Cliquez sur Done editing
5. Modifiez chaque requête de table
6. Allez dans la partie Settings
7. Tapez la ligne ci-dessous à la fin de la requête :
8. Cliquez sur Done editing
9. Voir ci-dessous le résultat pour le filtrage des modèles

10. Voir ci-dessous le résultat pour le filtrage des noms