Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configuration des options de débogage et de traçage des chemins de données

Comprendre le débogage de chemin de données pour les équipements SRX Series

La prise en charge du débogage du chemin de données, ou débogage de bout en bout, fournit le suivi et le débogage au niveau de plusieurs unités de traitement le long du chemin de traitement des paquets. Le filtre de paquets peut être exécuté avec un impact minimal sur le système de production.

Si votre objectif est de collecter des captures de paquets, nous vous recommandons vivement d’utiliser la capture de paquets en mode opérationnel introduite dans Junos OS version 19.3R1. Reportez-vous à la section Capture de paquets à partir du mode opérationnel.

Sur un pare-feu SRX Series, un paquet passe par une série d’événements impliquant différents composants, du traitement entrant au traitement sortant.

Grâce à la fonctionnalité de débogage du chemin de données, vous pouvez tracer et déboguer (capturer des paquets) à différents points de données le long du chemin de traitement. Les événements disponibles dans le chemin de traitement des paquets sont les suivants : Entrée NP, thread d’équilibrage de charge (LBT), jexec, thread de commande de paquets (POT) et sortie NP. Vous pouvez également activer le suivi du module de flux si l’indicateur de suivi du flux de sécurité d’un certain module est défini.

À chaque événement, vous pouvez spécifier l’une des quatre actions (nombre, vidage de paquets, résumé de paquets et trace). Le débogage des chemins de données fournit des filtres pour définir les paquets à capturer, et seuls les paquets correspondants sont tracés. Le filtre de paquets peut filtrer les paquets en fonction de l’interface logique, du protocole, du préfixe de l’adresse IP source, du port source, du préfixe de l’adresse IP de destination et du port de destination.

Le débogage du chemin de données est pris en charge sur SRX4600, SRX5400, SRX5600 et SRX5800.

Pour activer le débogage de bout en bout, vous devez effectuer les opérations suivantes :

  1. Définissez le fichier de capture et spécifiez la taille maximale de capture.

  2. Définissez le filtre de paquets pour ne tracer qu’un certain type de trafic en fonction des besoins.

  3. Définissez le profil d’action en spécifiant l’emplacement sur le chemin de traitement d’où capturer les paquets (par exemple, entrée LBT ou NP).

  4. Activez le débogage du chemin d’accès aux données.

  5. Capturez le trafic.

  6. Désactivez le débogage du chemin de données.

  7. Affichez ou analysez le rapport.

Le comportement de filtrage des paquets pour les options de port et d’interface est le suivant :

  • Le filtre de paquets suit à la fois le trafic IPv4 et IPv6 if only port est spécifié.

  • Le filtre de paquets trace le trafic IPv4, IPV6 et non-IP if only interface est spécifié.

Capture de paquets à partir du mode opérationnel

Le débogage de chemin de données ou le débogage de bout en bout fournit le suivi et le débogage à plusieurs unités de traitement le long du chemin de traitement des paquets. La capture de paquets est l’une des fonctions de débogage du chemin de données. Vous pouvez exécuter la capture de paquets à partir du mode opérationnel avec un impact minimal sur le système de production sans valider les configurations.

Vous pouvez capturer les paquets à l’aide de filtres pour définir les paquets à capturer. Le filtre de paquets peut filtrer les paquets en fonction de l’interface logique, du protocole, du préfixe de l’adresse IP source, du port source, du préfixe de l’adresse IP de destination et du port de destination. Vous pouvez modifier le nom de fichier, le type de fichier, la taille du fichier et la taille de capture de la sortie de capture de paquets. Vous pouvez également étendre les filtres en deux filtres et permuter les valeurs des filtres.

La capture de paquets à partir du mode opérationnel est prise en charge sur SRX4600, SRX5400, SRX5600 et SRX5800.

Pour capturer des paquets à partir du mode opérationnel, vous devez effectuer les opérations suivantes :

  1. En mode opérationnel, définissez le filtre de paquets pour tracer le type de trafic en fonction de vos besoins à l’aide de la request packet-capture start commande CLI. Consultez request packet-capture start les options de filtre de capture de paquets disponibles.
  2. Capturez les paquets requis.
  3. Vous pouvez utiliser la commande CLI pour arrêter la capture de paquets ou après avoir collecté le nombre de paquets demandé, la request packet-capture stop capture de paquets s’arrête automatiquement.
  4. Affichez ou analysez le rapport de données de paquets capturés.

Les limites de la capture de paquets à partir du mode opérationnel sont les suivantes :

  1. La capture de paquets en mode configuration et la capture de paquets en mode opérationnel ne peuvent pas coexister.

  2. La capture de paquets en mode opérationnel est une opération unique et le système ne stocke pas l’historique de cette commande.

  3. Vous devez utiliser la capture de paquets en mode opérationnel dans les flux de trafic à faible débit.

Comprendre le débogage de la sécurité à l’aide des options de traçage

La fonction de trace de Junos OS permet aux applications d’écrire des informations de débogage de sécurité dans un fichier. Les informations qui apparaissent dans ce fichier sont basées sur des critères que vous avez définis. Vous pouvez utiliser ces informations pour analyser les problèmes des applications de sécurité.

La fonction trace fonctionne de manière distribuée, chaque thread écrivant dans son propre tampon de trace. Ces tampons de trace sont ensuite collectés en un point, triés et écrits dans des fichiers de trace. Les messages de trace sont transmis à l’aide du protocole IPC (InterProcess Communications). La priorité d’un message de trace est inférieure à celle des paquets de protocole de contrôle tels que BGP, OSPF et IKE, de sorte que la distribution n’est pas considérée comme aussi fiable.

Comprendre le débogage de flux à l’aide des options de traçage

Pour les options de traçage de flux, vous pouvez définir un filtre de paquets à l’aide des combinaisons de destination-port, , , , protocolsource-portdestination-prefixinterfaceet .source-prefix Si l’indicateur de trace de flux de sécurité d’un module donné est défini, le paquet correspondant au filtre de paquet spécifique déclenche le suivi de flux et écrit les informations de débogage dans le fichier de trace.

Débogage du chemin d’accès aux données (procédure CLI)

Le débogage du chemin d’accès aux données est pris en charge sur SRX5400, SRX5600 et SRX5800.

Pour configurer l’appareil pour le débogage du chemin d’accès aux données :

  1. Spécifiez la commande de requête suivante pour définir le débogage du chemin de données pour les unités de traitement multiples le long du chemin de traitement des paquets :
  2. Spécifiez les options de trace pour le chemin d’accès aux données à l’aide de la commande suivante :
  3. À l’aide de la commande request security packet-filter, vous pouvez définir le filtre de paquets pour spécifier les paquets associés afin d’effectuer l’action de débogage du chemin de données. Un maximum de quatre filtres sont pris en charge en même temps. Par exemple, la commande suivante définit le premier filtre de paquets :
  4. À l’aide de la commande request security action-profile, vous pouvez définir l’action de la correspondance de paquet pour un filtre spécifié. Seul le profil d’action par défaut est pris en charge, c’est-à-dire l’option de trace pour l’entrée, la sortie ezchip du processeur réseau, spu.lbt et spu.pot :

Définition des options de suivi de débogage de flux (procédure CLI)

Les exemples suivants illustrent les options que vous pouvez définir à l’aide de security flow traceoptions.

  • Pour faire correspondre le port de destination imap pour le filtre de paquets filter1, utilisez l’instruction suivante :

  • Pour définir l’adresse de préfixe IPv4 de destination 1.2.3.4 pour le filtre de paquets filter1, utilisez l’instruction suivante :

  • Pour définir l’interface logique fxp0 pour le filtre de paquets filter1, utilisez l’instruction suivante :

  • Pour faire correspondre le protocole IP TCP au filtre de paquets filter1, utilisez l’instruction suivante :

  • Pour faire correspondre le port source HTTP pour le filtre de paquets filter1, utilisez l’instruction suivante :

  • Pour définir l’adresse du préfixe IPv4 5.6.7.8 pour le filtre de paquets filter1, utilisez l’instruction suivante :

Définition des options de suivi de sécurité (procédure CLI)

Utilisez les instructions de configuration suivantes pour configurer les options de suivi de sécurité dans l’éditeur de configuration CLI.

  • Pour désactiver le suivi à distance, entrez l’instruction suivante :

  • Pour écrire des messages de suivi dans un fichier local, entrez l’instruction suivante. Le système enregistre le fichier de trace dans le /var/log/ répertoire.

  • Pour spécifier un nom pour le fichier de trace, entrez l’instruction suivante. Les valeurs valides sont comprises entre 1 et 1024 caractères. Le nom ne peut pas inclure d’espaces, de / ou de % caractères. Le nom de fichier par défaut est sécurité.

  • Pour spécifier le nombre maximal de fichiers de trace pouvant s’accumuler, entrez l’instruction suivante. Les valeurs valides sont comprises entre 2 et 1000. La valeur par défaut est 3.

  • Pour spécifier les critères de correspondance que vous souhaitez que le système utilise lors de la consignation des informations dans le fichier, entrez l’instruction suivante. Saisissez une expression régulière. Les caractères génériques (*) sont acceptés.

  • Pour permettre à n’importe quel utilisateur de lire le fichier de trace, entrez l’instruction world-readable . Dans le cas contraire, saisissez l’instruction no-world-readable .

  • Pour spécifier la taille maximale jusqu’à laquelle le fichier de trace peut croître, entrez l’instruction suivante. Une fois que le fichier atteint la taille spécifiée, il est compressé et renommé filename0.gz, le fichier suivant est nommé filename1.gz, et ainsi de suite. Les valeurs valides sont comprises entre 10240 et 1 073 741 824.

  • Pour activer les options de traçage et effectuer plusieurs opérations de suivi, définissez les indicateurs suivants.

  • Pour spécifier les groupes auxquels ces paramètres d’option de traçage s’appliquent ou non, entrez les instructions suivantes :

Affichage des fichiers journaux et de suivi

Entrez la monitor start commande pour afficher les ajouts en temps réel aux journaux système et aux fichiers de trace :

Lorsque l’appareil ajoute un enregistrement au fichier spécifié par filename, l’enregistrement s’affiche à l’écran. Par exemple, si vous avez configuré un fichier journal système nommé system-log (en incluant l’instruction syslog au niveau hiérarchique [edit system]), vous pouvez entrer la monitor start system-log commande pour afficher les enregistrements ajoutés au journal système.

Pour afficher la liste des fichiers surveillés, entrez la monitor list commande. Pour arrêter l’affichage des enregistrements d’un fichier spécifié, entrez la monitor stop filename commande.

Affichage de la sortie pour les options de traçage de sécurité

But

Afficher la sortie pour les options de traçage de sécurité.

Action

Utilisez la commande pour afficher la show security traceoptions sortie de vos fichiers de trace. Par exemple :

Le résultat de cet exemple est le suivant :

Affichage des opérations de traçage multicast

Pour surveiller et afficher les opérations de traçage multicast, entrez la mtrace monitor commande :

Cet exemple n’affiche que mtrace les requêtes. Cependant, lorsque l’appareil capture une mtrace réponse, l’affichage est similaire, mais la réponse complète mtrace apparaît également (exactement comme elle apparaît dans la sortie de la mtrace from-source commande).

Tableau 1 Récapitule les champs de sortie de l’affichage.

Tableau 1 : Résumé de la sortie de la commande mtrace monitor de l’interface de ligne de commande CLI

Champ

Description

Mtrace operation-type at time-of-day

  • operation-type—Type d’opération de traçage multicast : query ou response.

  • time-of-day: date et heure de capture de la requête ou de la réponse de trace multicast.

by

Adresse IP de l’hôte émetteur de la requête.

resp to address

address: adresse de destination de la réponse.

qid qid

qid: numéro d’identification de la requête.

packet from source to destination

  • source: adresse IP de la source de la requête ou de la réponse.

  • destination: adresse IP de la destination de la requête ou de la réponse.

from source to destination

  • source: adresse IP de la source de multidiffusion.

  • destination: adresse IP de la destination de multidiffusion.

via group address

address—Adresse de groupe en cours de traçage.

mxhop=number

number: réglage du saut maximum.

Affichage d’une liste de périphériques

Pour afficher une liste de périphériques entre le périphérique et un hôte de destination spécifié, entrez la commande avec la traceroute syntaxe suivante :

Tableau 2 Décrit les options de commande traceroute .

Tableau 2 : Options de commande traceroute de l’interface de ligne de commande

Option

Description

host

Envoie les paquets traceroute au nom d’hôte ou à l’adresse IP que vous spécifiez.

interface interface-name

(Facultatif) Envoie les paquets traceroute sur l’interface que vous spécifiez. Si vous n’incluez pas cette option, les paquets traceroute sont envoyés sur toutes les interfaces.

as-number-lookup

(Facultatif) Affiche le numéro du système autonome (AS) de chaque saut intermédiaire entre l’équipement et l’hôte de destination.

bypass-routing

(Facultatif) Contourne les tables de routage et envoie les paquets traceroute uniquement aux hôtes sur les interfaces directement associées. Si l’hôte n’est pas sur une interface directement connectée, un message d’erreur est renvoyé.

Utilisez cette option pour afficher un itinéraire vers un système local via une interface qui n’a pas de route à travers elle.

gateway address

(Facultatif) Utilise la passerelle que vous spécifiez pour le routage.

inet

(Facultatif) Force les paquets traceroute vers une destination IPv4.

inet6

(Facultatif) Force les paquets traceroute vers une destination IPv6.

no-resolve

(Facultatif) Supprime l’affichage des noms d’hôte des sauts le long du chemin.

routing-instance routing-instance-name

(Facultatif) Utilise l’instance de routage que vous spécifiez pour le traceroute.

source address

(Facultatif) Utilise l’adresse source que vous spécifiez dans le paquet traceroute.

tos number

(Facultatif) Définit la valeur de type de service (TOS) dans l’en-tête IP du paquet traceroute. Spécifiez une valeur comprise entre 0 .255

ttl number

(Facultatif) Définit la durée de vie (TTL) du paquet traceroute. Spécifiez un nombre de sauts de 0 à .128

wait seconds

(Facultatif) Définit le temps maximal d’attente d’une réponse.

Pour quitter la traceroute commande, appuyez sur Ctrl-C.

Voici un exemple de sortie d’une traceroute commande :

Les champs de l’affichage sont les mêmes que ceux affichés par l’outil de diagnostic traceroute J-Web.

Exemple : Configuration du débogage de bout en bout sur un équipement SRX Series

Cet exemple montre comment configurer et activer le débogage de bout en bout sur un pare-feu SRX Series avec un SRX5K-MPC.

Conditions préalables

Cet exemple utilise les composants matériels et logiciels suivants :

  • SRX5600 appareil équipé d’un SRX5K-MPC et d’un émetteur-récepteur CFP 100 Gigabit Ethernet

  • Junos OS version 12.1X47-D15 ou ultérieure pour les pare-feu SRX Series

Avant de commencer :

Aucune configuration spéciale au-delà de l’initialisation de l’appareil n’est requise avant de configurer cette fonctionnalité.

Présentation

Le débogage des chemins de données améliore les capacités de dépannage en fournissant le suivi et le débogage au niveau de plusieurs unités de traitement le long du chemin de traitement des paquets. Grâce à la fonctionnalité de débogage du chemin de données, vous pouvez tracer et déboguer (capturer des paquets) à différents points de données le long du chemin de traitement. À chaque événement, vous pouvez spécifier une action (nombre, vidage de paquets, résumé de paquets et trace) et définir des filtres pour définir les paquets à capturer.

Dans cet exemple, vous définissez un filtre de trafic, puis vous appliquez un profil d’action. Le profil d’action spécifie une variété d’actions sur l’unité de traitement. Les entrées et les sorties sont spécifiées en tant qu’emplacements sur le chemin de traitement pour capturer les données relatives au trafic entrant et sortant.

Ensuite, vous activez le débogage du chemin d’accès aux données en mode opérationnel, et enfin vous affichez le rapport de capture de données.

REMARQUE :

Le débogage des chemins de données est pris en charge sur SRX1400, SRX3400, SRX3600, SRX5400, SRX5600 et SRX5800.

Configuration

Procédure

Configuration rapide de l’interface de ligne de commande

Pour configurer rapidement cet exemple, copiez les commandes suivantes, collez-les dans un fichier texte, supprimez les sauts de ligne, modifiez tous les détails nécessaires pour qu’ils correspondent à la configuration de votre réseau, copiez et collez les commandes dans l’interface de ligne de commande au niveau de la [edit] hiérarchie, puis passez commit en mode de configuration.

Procédure étape par étape

L’exemple suivant vous oblige à naviguer à différents niveaux dans la hiérarchie de configuration. Pour obtenir des instructions sur cette procédure, reportez-vous à la section Utilisation de l’éditeur CLI en mode configuration du Guide de l’utilisateur CLIJunos OS .

Pour configurer le débogage du chemin d’accès aux données :

  1. Modifiez l’option de débogage du chemin de données de sécurité pour les unités de traitement multiples le long du chemin de traitement des paquets :

  2. Activez le fichier de capture, le format de fichier, la taille du fichier et le nombre de fichiers.

  3. Configurez le profil d’action, le type d’événement et les actions pour le profil d’action.

Résultats

À partir du mode configuration, confirmez votre configuration en entrant la show security datapath-debug commande. Si la sortie n’affiche pas la configuration prévue, répétez les instructions de configuration de cet exemple pour la corriger.

Si vous avez terminé de configurer l’appareil, passez commit en mode de configuration.

Activation du débogage du chemin d’accès aux données

Procédure

Procédure étape par étape

Après avoir configuré le débogage du chemin de données, vous devez démarrer le processus sur l’appareil à partir du mode opérationnel.

  1. Activez le débogage du chemin d’accès aux données.

  2. Avant de vérifier la configuration et d’afficher les rapports, vous devez désactiver le débogage du chemin d’accès aux données.

    REMARQUE :

    Vous devez arrêter le processus de débogage une fois que vous avez terminé de capturer les données. Si vous tentez d’ouvrir les fichiers capturés sans arrêter le processus de débogage, les fichiers obtenus ne peuvent pas être ouverts par le biais d’un logiciel tiers (par exemple, tcpdump et wireshark).

Vérification

Vérifiez que la configuration fonctionne correctement.

Vérification des détails de capture des paquets de débogage du chemin de données

But

Vérifiez les données capturées en activant la configuration de débogage du chemin d’accès aux données.

Action

À partir du mode opérationnel, entrez la show security datapath-debug capture commande.

Par souci de concision, la sortie de la show commande est tronquée pour n’afficher que quelques échantillons. Des échantillons supplémentaires ont été remplacés par des ellipses (...).

Pour afficher les résultats, à partir du mode opérationnel de la CLI, accédez au shell UNIX local et accédez au répertoire /var/log/<file-name>. Le résultat peut être lu à l’aide de l’utilitaire tcpdump .

REMARQUE :

Si vous avez terminé le dépannage du débogage du chemin de données, supprimez tout traceoptions (sans vous limiter aux traceoptions de flux) et l’ensemble de la configuration de débogage du chemin de données, y compris la configuration de débogage du chemin de données pour la capture de paquets (vidage de paquets), qui doit être démarrée/arrêtée manuellement. Si une partie de la configuration de débogage reste active, elle continuera à utiliser les ressources de l’appareil (CPU/mémoire).