Configurer la sonde Shazzam

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture
  • Lorsque vous exécutez Découverte, la sonde Shazzam recherche vos périphériques réseau actifs en analysant les ports spécifiés sur les plages d'adresses IP spécifiées. Si la liste des plages IP en cours d'analyse est volumineuse, vous pouvez configurer le codage JSON sur la charge utile Shazzam afin de réduire sa taille.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Pour contrôler le comportement des sondes Shazzam individuelles, utilisez des paramètres de base et avancés.

    Pour obtenir des instructions sur la configuration des paramètres de sonde, consultez Configurer les paramètres de sonde.

    Remarque :
    La charge utile Shazzam est contrôlée par les propriétés du serveur MID suivantes. Il n'est pas nécessaire d'ajouter ces propriétés au MID Server. La sonde Shazzam sélectionne automatiquement leurs valeurs par défaut.
    • La propriété shazzam.chunk_size contrôle le nombre maximal d'adresses IP que Shazzam peut analyser en parallèle.
    • La propriété mid.shazzam.regulator.interval_ms définit l'intervalle dans lequel Shazzam peut lancer des paquets.
    • La propriété mid.shazzam.regulator.packets_per_interval définit le nombre de paquets que Shazzam peut lancer durant cet intervalle.

    Procédure

    1. Accédez à la Tout > Définition de découverte > Probes.
    2. Sélectionnez Shazzam.
    3. Ajoutez ou modifiez des paramètres dans la liste connexe Paramètres de sonde.
    4. Configurez les paramètres Shazzam.
      Ces paramètres sont disponibles pour affiner la sonde Shazzam. Ces valeurs sont définies uniquement dans l'enregistrement de sonde.
      Tableau 1. Paramètres Shazzam avancés
      Paramètre Description
      BannerTCP_waitForConnectMS Définit le délai d'attente d'une connexion et d'une bannière, en millisecondes, de la part du scanner BannerTCP.

      Valeur par défaut : 1 500

      debug Active la journalisation du débogage si la valeur est définie sur vrai.

      Valeur par défaut : faux

      delay_wbem Retarde la classification des systèmes avec un port WBEM ouvert jusqu'à la tâche de capteur Shazzam finale. Si de nombreux ports WBEM sont détectés, retarder la classification jusqu'à la dernière tâche de capteur risque d'entraîner une quantité insuffisante de mémoire sur le nœud. La définition de ce paramètre sur faux permet la classification de ces systèmes sur toutes les tâches de capteur Shazzam.

      Valeur par défaut : vrai

      DNS_alternativePort Déconseillé
      DNS_waitForResponseMS Définit le temps de réponse au scanner DNS, en millisecondes.

      Valeur par défaut : 1 000

      GenericTCP_waitForConnectMS Définit le temps de connexion du scanner TCP générique, en millisecondes.

      Valeur par défaut : 1 000

      HTTP_waitForConnectMS Définit le temps de connexion du scanner HTTP, en millisecondes.

      Valeur par défaut : 500

      HTTP_waitForResponseMS Définit le temps de réponse au scanner HTTP, en millisecondes.

      Valeur par défaut : 500

      NBT_alternativePort Déconseillé
      NBT_waitForResponseMS Définit le temps de réponse au scanner NBT, en millisecondes.

      Valeur par défaut : 500

      shazzam_report_inactive Si ce paramètre est défini sur vrai, il signale les appareils fonctionnels, mais inactifs. Par exemple, un appareil n'a pas de ports ouverts, mais refuse au moins une demande de connexion de port.

      Valeur par défaut : vrai

      scanner_log Active la journalisation du scanner si la valeur est définie sur vrai. Ces informations de journalisation apparaissent dans la réponse de sonde Shazzam.

      Valeur par défaut : faux

      shazzam_report_dead Si ce paramètre est défini sur vrai, il signale les appareils avec des adresses IP inactives. C'est le cas notamment d'un appareil dont tous les ports sont fermés.

      Valeur par défaut : faux

      SNMP_alternativePort Déconseillé
      SNMP_tapIntervalMS Définit le temps d'attente du scanner SNMP entre les connexions, en millisecondes.

      Valeur par défaut : 1 000

      SNMP_taps Définit le nombre de tentatives de connexions (demandes) du scanner SNMP.

      Valeur par défaut : 2

      SNMP_waitForResponseMS Définit le temps de réponse au scanner SNMP après la dernière connexion, en millisecondes.

      Valeur par défaut : 1 000

      TLS_keepOriginalCertificate Lorsque ce paramètre est défini sur vrai et que Discovery est en cours d'exécution, le champ certificate_file dans cmdb_ci_certificate est renseigné avec le certificat d'origine. Cela peut augmenter la taille de votre charge utile.

      Valeur par défaut : faux

    Contrôler la taille de la charge utile Shazzam

    Une propriété système convertit les charges utiles Shazzam en chaînes JSON, ce qui réduit considérablement leur taille. Ce paramètre évite la saturation de la mémoire sur les nœuds lorsqu'une planification unique détecte un grand nombre de plages IP.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La propriété glide.discovery.shazzam_ranges_json est définie sur vrai pour les nouvelles instances. Ce paramètre code la charge utile sous forme de chaîne JSON. La propriété peut être configurée par les administrateurs et est disponible dans le Définition de découverte > Propriétés module. Dans ce module, cette propriété est appelée Utiliser JSON pour les plages IP dans Shazzam.

    Cette propriété est définie sur faux dans les instances mises à niveau et n'est pas visible par défaut. L’ajout manuel de la propriété à votre instance mise à niveau active la fonctionnalité, mais ne l’ajoute pas à Définition de découverte > Propriétés module. Pour activer le codage JSON et l'ajouter au module, importez l'ensemble de mises à jour joint à l'article KB0687626.

    Procédure

    1. Dans le filtre de navigation, saisissez sys_properties.list, puis appuyez sur la touche Entrée.
    2. Dans la liste des propriétés système, cliquez sur Nouveau.
    3. Renseignez le formulaire à l'aide des valeurs de champ suivantes :
      • Nom : glide.discovery.shazzam_ranges_json
      • Description : code la charge utile Shazzam au format JSON.
      • Valeur : vrai
    4. Cliquez sur Envoyer.