9. Tutoriel - Configurer le reporting¶
Indication
Cette page est un guide de démarrage rapide destiné à vous aider à prendre en main le module WAPT Reporting. Pour une documentation complète et détaillée (structure de la base de données, connexion externe à PostgreSQL, tableaux de bord Grafana, etc.), consultez la page Utiliser la fonctions de requête dans WAPT .
Note
La fonctionnalité de création de rapports est disponible dans WAPT Enterprise. Veuillez vous assurer que vous disposez de la licence appropriée avant de commencer ce tutoriel.
9.1. Présentation générale¶
La fonctionnalité Reporting de WAPT vous permet de créer vos propres requêtes SQL sur la base de données de votre flotte et d’afficher les résultats directement dans la console WAPT.
Personne ne sait mieux que vous de quelles informations vous avez besoin. Les rapports vous permettent, par exemple :
Répertorier les machines sur lesquelles un logiciel donné est installé (même si celui-ci n’a pas été déployé via WAPT) ;
Identifier les hôtes qui n’ont pas été détectés depuis un certain temps ;
Obtenir des statistiques sur votre parc (ventilation par système d’exploitation, par type de machine, etc.) ;
Créez des filtres dynamiques dans l’onglet
Inventaire, en fonction des résultats de vos requêtes.
Note
L’accès à la base de données PostgreSQL de WAPT s’effectue en mode lecture seule depuis le module Reporting : vos requêtes ne peuvent donc en aucun cas modifier, supprimer ou insérer des données. Vous pouvez effectuer des tests en toute liberté, sans risque d’endommager votre flotte.
9.2. Comment importer et créer des requêtes¶
9.2.1. Importer une requête existante¶
Accédez à l’onglet Rapports (1) → Importer… (2) → Depuis une URL (3). Cela vous permet de récupérer des requêtes prêtes à l’emploi depuis le Dépôt de Tranquil IT.
Pour commencer, sélectionnez la requête Espace libre par ordinateur (1) → cliquez sur Importer les requêtes sélectionnées (2)
La requête apparaît dans la console et s’exécute automatiquement ; vous pouvez l’enregistrer en cliquant sur Enregistrer. (1)
Saisissez un nom pour la requête (ou conservez le nom proposé) (1) puis cliquez sur OK (2).
Pour commencer, nous allons créer un fichier au format .json, que nous appellerons : inactive_hosts_8d.json.
contenu du fichier inactive_hosts_8d.json
[
{
"id": 17,
"name": "Inactive hosts 8d",
"query": "SELECT\n uuid,\n computer_name,\n last_seen_on\nFROM hosts\nWHERE TO_TIMESTAMP(last_seen_on, 'YYYY-MM-DD') < CURRENT_TIMESTAMP - INTERVAL '8 days'\nORDER BY last_seen_on;",
"settings": {
"columns": [
{
"text": "uuid",
"width": 250,
"visible": true,
"position": 0,
"propertyname": "uuid",
"chartsettings": ""
},
{
"text": "computer_name",
"width": 200,
"visible": true,
"position": 1,
"propertyname": "computer_name",
"chartsettings": ""
},
{
"text": "last_seen_on",
"width": 150,
"visible": true,
"position": 2,
"propertyname": "last_seen_on",
"chartsettings": ""
}
],
"sortcolumn": 2,
"sortdirection": 1
}
}
]
Une fois celui-ci créé, retournez dans la console WAPT.
Accédez à l’onglet Rapports (1) → Importer des requêtes… (2) → Depuis un fichier (3), puis sélectionnez le fichier.
Sélectionnez le fichier inactive_hosts_8d.json (1) dans le répertoire où il a été créé, en cliquant sur Ouvrir (2).
Importez la requête en la sélectionnant (1), puis en cliquant sur importer les requêtes sélectionnées (2) :
Cliquez sur le nouvel onglet intitulé : Hôtes inactifs depuis 8 jours. (1) puis enregistrez-le (2).
Saisissez un nom pour la requête (1) puis cliquez sur OK (2).
Une fois la requête créée, elle apparaît dans le panneau de gauche (1). Pour réexécuter une requête, cliquez simplement sur le bouton Exécuter. (2) Vous avez maintenant testé l’import de requêtes via une URL ou un fichier.
9.2.2. Créer sa première requête¶
Pour commencer, accédez à l’onglet Rapports (1) → Nouvelle requête (2). Un nouvel onglet intitulé Nouvelle requête s’ouvre (3).
Nous allons saisir le contenu suivant dans cette nouvelle requête :
SELECT
computer_name,
os_name,
uuid,
os_version
FROM hosts
WHERE os_name LIKE 'Windows 11%%'
Cette requête a pour objectif de lister toutes les machines du parc fonctionnant sous Windows 11.
Enregistrez ensuite la requête (1), donnez-lui un nom (2), puis cliquez sur OK (3).
Une fois la requête créée, elle apparaît dans le panneau de gauche (1). Pour réexécuter une requête, cliquez simplement sur le bouton Exécuter. (2)
.png)
9.3. Exploiter le rendu¶
9.3.1. Résultat dans la fenêtre de requête¶
Le résultat s’affiche directement dans la fenêtre de requête. Vous pouvez :
l’exporter vers un tableur (bouton Exporter vers tableur, génère un fichier .csv) ;
le dupliquer, le partager, ou l’exporter vers un fichier pour le transmettre à un collègue.
9.3.2. Créer un filtre dans l’onglet Inventaire¶
Vous pouvez transformer une requête en filtre dynamique dans l’onglet Inventaire, pour afficher directement les machines correspondantes.
Assurez-vous que votre requête retourne une colonne identifiant chaque machine (typiquement
host_idouuuid). (1)Dans le résultat de la requête, faites un clic droit sur cette colonne, puis cliquez sur Choisir comme Host UUID. (2)
Enregistrez la requête. (3)
Accédez à l’onglet Inventaire (1), cochez
Plus d'options(2) dans le panneau, puis sélectionnez votre requête dans le champ de filtre Requête SQL (3).
Vous obtenez alors une liste de machines dynamique, basée sur le résultat de votre requête.
9.4. Pour aller plus loin¶
Cette page couvre uniquement la prise en main du Reporting. La documentation complète (Utiliser la fonctions de requête dans WAPT ) détaille notamment :
la mise en place de tableaux de bord Grafana connectés à la base WAPT, pour un suivi visuel de votre parc ;
la normalisation des noms de logiciels, pour regrouper sous un même nom des logiciels qui apparaissent différemment selon leur version ou leur architecture, et ainsi fiabiliser vos requêtes de suivi de version ;
D’autres exemples de requêtes (machines par type de châssis, logiciels les plus installés, machines non vues depuis longtemps, etc.).