Aligner les versions de sondes et de capteurs personnalisés

Si vous avez personnalisé une sonde ou un capteur et que vous avez mis à niveau une instance vers une nouvelle version, vous devez mettre à jour les versions de la sonde et du capteur personnalisés vers la version la plus récente.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Les sondes et les capteurs peuvent disposer d'une version majeure ou d'une version mineure.

Version majeure

La modification d'une version majeure indique une modification dans la sortie attendue d'une sonde, par exemple l'ajout ou la soustraction d'un attribut ciblé, un changement de format (XML par rapport à JSON) ou un changement de script de paramètre de sonde.

Version mineure

La modification d'une version mineure implique de petits correctifs qui n'ont pas d'impact sur le résultat ou le traitement des données.

Un capteur et sa sonde correspondante doivent disposer de la même version majeure. Il est également recommandé qu'ils disposent tous deux de la même version mineure. Cette correspondance de version garantit la compréhension des données renvoyées à partir de la sonde et leur traitement correct de la part du capteur. Tous les membres d'un groupe de multisondes doivent disposer de la même version majeure et de la même version mineure.

Par défaut, Discovery identifie les incompatibilités de versions majeures et les affiche dans la section Erreurs Discovery actives du tableau de bord Discovery et dans le journal de détection. Pour savoir si Discovery identifie ou non les incompatibilités de versions mineures, définissez la propriété Discovery Avertir en cas d'incompatibilité de version mineure (glide.discovery.warn_minor_version). Les incompatibilités de versions mineures sont consignées dans le journal de détection, mais ne figurent pas sur le tableau de bord Discovery.

Les versions des multisondes et multicapteurs sont vérifiées comme suit :

• Les versions des sondes individuelles contenues dans les multisondes sont comparées aux scripts Répond aux sondes qui traitent leurs données.
• Les versions des scripts Répond aux sondes et du script Multicapteurs principaux sont comparées.

Si une sonde et son capteur correspondant ne disposent pas de la même version majeure, un capteur ne traite pas les informations lors d'une détection et envoie des messages d'erreur au fichier journal. Ces erreurs s'affichent également sur le tableau de bord Discovery lorsque vous exécutez une tâche de détection. Si la version majeure est la même, mais que la version mineure diffère, un capteur traite les informations lors d'une détection.

Pour utiliser la version la plus récente d'une sonde :

Procédure

1. Enregistrez les personnalisations de votre sonde ou de votre capteur dans un fichier texte afin de pouvoir les réappliquer ultérieurement.
2. Accédez à la Découverte > Tableau de bord.
3. Recherchez les erreurs d'incompatibilité de version dans la section Erreurs Discovery actives, et notez la sonde ou le capteur ayant provoqué l'erreur.
4. Accédez à la Définition de découverte > Sondes ou Définition de découverte > Capteurs et sélectionnez la sonde ou le capteur que vous souhaitez mettre à niveau.
5. Ajoutez les champs Version majeure et Version mineure au formulaire si vous souhaitez afficher les versions sur le formulaire.
6. Dans un multicapteur, vous pouvez examiner la version majeure par rapport aux versions des sondes qui utilisent le capteur dans la liste connexe Répond aux sondes.

   Figure 1. Compatibilité de version entre la multisonde et le multicapteur

   

7. Cliquez sur la liste connexe Versions.
8. Recherchez la version dont l'état est défini sur Précédent et la source est définie sur Mises à niveau du système.
9. Cliquez sur le lien de date dans la colonne Créé de cette version pour ouvrir l'enregistrement de version.
10. Cliquez sur Restaurer cette version.
11. Revenez au formulaire de la sonde ou du capteur et vérifiez que la version majeure est correcte.
12. Réappliquez vos personnalisations à la sonde ou au capteur.
13. Vérifiez que vos personnalisations sont compatibles avec la nouvelle version de la sonde ou du capteur en exécutant une détection dans votre environnement de tests.