Netskope Client Mode débogage

Le mode de débogage de Netskope Client offre un moyen simple et efficace de consolider toutes les informations nécessaires au dépannage. En cas de problème, activez le mode débogage et reproduisez le problème. Lorsque le problème survient, arrêtez le mode de débogage et partagez le fichier d'archive généré avec Netskope.

Lorsque le mode de débogage Netskope Client est activé, il effectue les opérations suivantes :

• Capture de paquets internes avec plusieurs rotations de fichiers.

• Capture de paquets extérieurs avec rotation multiple des fichiers.

• Les journaux de débogage du service Netskope Client sont répartis dans plusieurs fichiers.

• Lancez le mode débogage avec des privilèges administratifs pour collecter les informations suivantes :

  Exécutez la commande nsdiag en tant qu'administrateur sous Windows et sudo sous MacOS.

  • Sur Mac, récupérez le journal sysdiagnose (ce processus peut prendre quelques minutes).

  • Sous Windows,

    • Générer des vidages de mémoire pour le service Netskope Client (stAgentSvc.exe) et l'interface utilisateur du locataire actuel (stAgentUI.exe).

       Si Protect Client configuration and resources est activé, le mode débogage ne collecte pas les vidages de mémoire.

    • Collecter les journaux d'événements des applications et du système Windows.

• Désactive l'option Save Logs dans l'interface utilisateur du client.

• Désactive les fonctionnalités de l'interface utilisateur du client Advanced Debugging telles que Set Log Level, Save Driver Logs, Inner Packet Capture, et Outer Packet Capture.

• Désactive nsdiag commande pour la définition des niveaux de journal, l’initiation des captures de paquets internes et externes depuis l’interface Netskope Client, et l’augmentation de la taille du fichier journal.

Commande du mode débogage

• Fenêtres

  nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB] -c [disable | CPU sample interval in second] -r [enable | disable driver log] -t [duration of time in minutes] -o <output archive path>

• macOS

  nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB] -c [disable | CPU sample interval in second] -d [enable | disable sysdiagnose log] -t [duration of time in minutes] -o <output archive path>

• Linux

  nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | warning | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB]-t [duration of time in minutes] -o <output archive path>

Paramètres	Description
-b [start | stop | status | cleanup]	démarrer/arrêter/obtenir l'état/nettoyer le mode débogage
-l [ dump | debug | info | error | critical]	Définir le niveau de journalisation du mode débogage. La valeur par défaut est debug.
-s <longueur de la raclée><snap length>	Définissez la longueur de l'instantané de capture de paquets interne et externe en mode de débogage. La valeur par défaut est 0.
-m <nombre maximal de fichiers journaux de débogage><max debug log files>	Définissez le nombre maximal de fichiers journaux de débogage en mode débogage. La valeur par défaut est 10.
-i [disable | maxInnerPcapTotalSize en Mo]	Définit la taille totale de la capture de paquets internes en mode débogage. La valeur par défaut est de 600 Mo.
-e [disable | maxOuterPcapTotalSize in MB]	Définit la taille totale de la capture de paquets extérieurs en mode débogage. La valeur par défaut est 800MB.
-c [disable | Intervalle d'échantillonnage du CPU en secondes]	- Windows et Mac uniquement. - Prendre un instantané de l'utilisation de l'unité centrale de tous les processus toutes les (intervalles) secondes. Le résultat se trouve dans New nsDMCpuUsage.log dans le dossier Netskope Client log.
-r [activer | désactiver le journal du pilote]	- Windows uniquement. - Activer/désactiver l'enregistrement du pilote en mode débogage.
-d [enable | disable]	- macOS uniquement. - Activer/désactiver la collecte du journal sysdiagnose. Remarque : la collecte des détails du journal sysdiagnose prend quelques minutes.
-t [durée en minutes]	Optionnel : La valeur par défaut est de 2160 minutes ou 36 heures - La valeur minimale est de 1 (minute). - La valeur maximale est de 86 400 minutes ou 60 jours. - Netskope Client arrête automatiquement le mode de débogage et collecte les informations requises après la durée fixée.
-o <chemin complet de l'archive de sortie><output archive full path>	Requis : définir le chemin complet du fichier d'archive de sortie (.zip). - Netskope Client ajoute automatiquement les fichiers .zip si le fichier spécifié n'en a pas. - Si elle est configurée dans la commande -b start, elle n'est pas nécessaire dans la commande -b stop.

Commande d'arrêt du débogage

Le site Netskope Client continue à collecter des informations jusqu'à ce que l'utilisateur exécute la commande nsdiag -b stop pour quitter le mode débogage.

Exemples de commandes de débogage

Exemple 1

Les utilisateurs rencontrent fréquemment des problèmes avec Netskope Client. Pour résoudre ce problème, lancez le mode de débogage en utilisant les paramètres par défaut, puis essayez de reproduire le problème comme suit :

nsdiag -b start -o ~/debug/NSClientLogs.zip

Lorsque le problème survient, arrêtez immédiatement le mode débogage. Un fichier nommé NSClientLogs_timestamp.zip (par exemple, NSClientLogs_2025.04.03_16-16-35-0800.zip) est généré dans le dossier ~/debug. Partagez ce fichier avec le support Netskope.

nsdiag -b stop

Exemple 2

Les utilisateurs rencontrent parfois des problèmes qui ne sont pas facilement reproductibles à la demande ; il peut s'écouler plusieurs heures, voire plusieurs jours, avant que le problème ne se manifeste. Pour dépanner, ils peuvent lancer le mode de débogage comme suit :

nsdiag -b start -s 200 -i 1000 -e 1200 -m 50 -o ~/debug/NSClientLogs.zip

• Définissez la taille totale du pcap interne à 1000 millions d'octets.
• Définissez la taille totale du pcap externe à 1200M octets.
• Définissez un total de 50 fichiers journaux de débogage.

Lorsque le problème survient après plusieurs heures ou plusieurs jours, les utilisateurs peuvent rapidement désactiver le mode de débogage.

nsdiag -b stop

Exemple 3

Netskope Client connaît une instabilité qui peut se manifester par des blocages de processus ou des plantages. En tant qu'administrateur, exécutez les opérations suivantes :

nsdiag -b start -o “c:\debug\NSClientLogs.zip“

Lorsque le problème survient, arrêtez immédiatement le mode de débogage. Pour arrêter le mode de débogage, exécutez la commande suivante dans l'invite de commande :

nsdiag -b stop

Exemple 4

En cas de problème de performance dû au chargement du tunnel, exécutez la commande suivante dans l'invite de commande :

nsdiag -b start -l info -s 200 -i 1200 -e disable -r disable -c 3 -o "c:\debug\loadtest.zip"

Dans la commande précédente, définissez les paramètres suivants :

• Définissez le niveau de journalisation à "info"
• Fixer la valeur de snaplen à 200
• Définir la taille totale du pcap interne à 1200 millions d'octets
• Désactiver le pcap externe
• Désactiver le journal des pilotes

Vous pouvez évaluer l'utilisation de l'unité centrale toutes les trois secondes. Désactivez le mode de débogage une fois la validation terminée.

Exemple 5

Si l'administrateur souhaite lancer le mode de débogage dans un périphérique macOS et recueillir toutes les informations pertinentes, y compris le journal sysdiagnose, procédez comme suit :

​​sudo nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop

Exemple 6

Si l'administrateur souhaite lancer le mode de débogage sur un périphérique macOS sans collecter le journal sysdiagnose, effectuez l'une des opérations suivantes :

nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop

OR

sudo nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop -d disable

Exemple 7

Pour nettoyer tous les fichiers du mode débogage après avoir arrêté le mode débogage :

nsdiag.exe -b cleanup

Exemple 8

L'administrateur veut spécifier l'exécution du mode Debug pour seulement 60 minutes avec les paramètres par défaut.

-b start -t 60 -o outputFile(.zip)

Après 60 minutes, le mode Débogage s'arrête automatiquement et collecte les informations requises dans le fichier de sortie au format outputFile_YYYY.MM.DD_HH-MM-SS-UTC.zip.

Vérifier l'état de débogage

Pour vérifier l'état du mode débogage, vous pouvez utiliser l'une des deux méthodes suivantes :

• Utilisation de la ligne de commande : nsdiag -b status

• Utilisation de Netskope Client UI :

  1. Lorsque le mode débogage est activé, le menu Save Logs... apparaît en grisé.

     

  2. Cliquez sur Advanced Debugging.

     Les options Set Log Level, Save Driver Logs, Inner Packet Capture et Outer Packet Capture sont également grisées et affichent l'état actuel (Start ou Stop).