DTLcompare - Manuel de référence
Référence descriptive de l'analyseur de comparaison de snapshots DTLknowsWhy.
Type : analyse comparativeLangage : PythonVersion : v1.0Rôle
DTLcompare compare deux snapshots JSON produits par DTLknowsWhy : un snapshot issu d'un poste où l'accès distant fonctionne, et un snapshot issu d'un poste où le même accès échoue. L'objectif est d'isoler les différences utiles et de transformer les données brutes en constats classés.
Modèle d'entrée
| Élément | Description |
|---|---|
| Snapshot fonctionnel | Fichier JSON représentant un diagnostic distant réussi. |
| Snapshot en échec | Fichier JSON représentant un diagnostic équivalent qui échoue. |
| Structure attendue | Données DTLknowsWhy, notamment remote_tests, system, cible, ping, TCP 445, partages SMB et informations d'identité. |
Domaines d'analyse
Cible et cohérence
L'outil vérifie que les deux diagnostics portent sur la même cible. Une différence de cible rend la comparaison peu fiable.
Transport réseau
Les tests de ping et de port TCP 445 permettent d'éliminer ou de retenir les causes liées à la joignabilité et au transport SMB.
SMB et authentification
La présence ou l'absence de partages visibles, les messages d'erreur et les marqueurs d'échec d'identification alimentent les hypothèses de droits, d'identifiants cachés ou de contexte de compte.
Contexte poste
Les différences de domaine, groupe de travail, rattachement Entra/Azure AD et filtres appliqués sont prises en compte pour expliquer les écarts entre postes.
Sorties produites
| Sortie | Usage |
|---|---|
| Rapport HTML | Lecture et partage avec support ou infrastructure. |
| Rapport TXT | Synthèse compacte, facilement copiable dans un ticket. |
| Rapport JSON | Exploitation automatisée ou archivage structuré. |
| Console | Résumé lisible de l'analyse pendant l'exécution. |
Dépendances
Le point d'entrée principal est comparative_analysis.py. Le script dépend du package expert.compare de DTLknowsWhy pour lire certains chemins, extraire les noms de partages, reconnaître les filtres et détecter le type de rattachement du poste.
Limites
- DTLcompare n'est pas un collecteur de diagnostics : il exploite des snapshots déjà produits.
- La comparaison est pertinente uniquement si les deux snapshots visent le même accès et la même cible.
- L'analyse reste dépendante du schéma JSON DTLknowsWhy.
- Les constats sont classés par pertinence, mais doivent être relus dans leur contexte technique.