Nœud Metro : Comment collecter les journaux à partir de Metro Node

Étapes à suivre pour effectuer les tâches suivantes : 

1. Quels journaux sont nécessaires pour déboguer les problèmes de Metro Node ? 
2. Comment capturer collect-diagnostics sur un cluster Metro Node ? 
3. Comment valider les packages collect-diagnostics existants sur les serveurs de gestion ?  
4. Comment abandonner et nettoyer un collect-diagnostics en cours dans Metro Node ?  

Remarque : Si des journaux SupportAssist sont nécessaires, invitez le client à consulter la 000135669 de la base de connaissances « Comment exporter une collecte de journaux SupportAssist à partir de SupportAssist Enterprise ? » Connecté ou Déconnecté «


A. Quels sont les journaux requis pour déboguer les problèmes de Metro Node ? »  

1. La commande nécessaire à la collecte des journaux à partir du Metro Node s’appelle « collect-diagnostics » et peut être exécutée à partir de n’importe quel nœud ^[1] dans la configuration du Metro Node. L’exécution de cette commande sur un directeur d’un cluster Metro Node doit disposer de toutes les données de tous les directeurs et de tous les nœuds d’un cluster. N’exécutez PAS cette commande sur plusieurs nœuds à la fois.

2. La commande « collect-diagnostics » génère un fichier journal tar.gz compressé contenant les fichiers log et de configuration. Le fichier collect-diagnostics est placé dans le répertoire /diag/collect-diagnostics-out/ sur le nœud à partir duquel il a été exécuté. Une fois la commande terminée, utilisez WINSCP ou un utilitaire SCP équivalent pour copier le fichier hors du nœud, puis il peut être fourni à la prise en charge de l’analyse. Pour plus d’informations sur l’utilisation de cette commande, reportez-vous à la section B ci-dessous.

Remarques : 

• Si la commande « collect-diagnostics » est exécutée sans aucune option, deux fichiers sont générés, un fichier de base et un fichier étendu. Cela peut prendre beaucoup de temps sur les systèmes évolutifs. 
• La prise en charge de Metro Node ne nécessite généralement que le fichier de base, mais dans certaines circonstances, pour des raisons de performances, ils peuvent également demander le fichier étendu. 
• Les options standard à utiliser lors de l’exécution de collect-diagnostics sont les suivantes : 

• Pour plus de détails sur la commande, vous pouvez saisir « collect-diagnostics -h » 

Voici des exemples de ces deux noms de fichier. La date et l’heure, indiquées par YYYY-MM-DD-HH.MM.SS, seront à partir de la date et de l’heure auxquelles ils ont été collectés : 

• Fichier de base : <numéro> de série-c1-diag-YYYY-MM-DD-HH.MM.SS.tar.gz 
• Fichier étendu : <numéro> de série-c1-diag-ext-YYYY-MM-DD-HH.MM.SS.tar.gz 

3. Les problèmes de performances sont complexes et nécessitent la collecte d’un grand nombre d’informations spécifiques. Par conséquent, nous disposons d’un questionnaire sur les performances que les clients sont invités à remplir pour accélérer ce processus. Le questionnaire est joint à cet article de la base de connaissances dans la section des pièces jointes à la fin. 

4. Dans certains types de problèmes de performances, il est utile de capturer un journal supplémentaire appelé « fe_perf_stats ». Les journaux sont générés en continu, mais ne sont pas capturés par collect-diagnostics. Pour capturer ce journal, utilisez cd (changer de répertoire) sur /var/log/VPlex/cli sur un nœud de chaque cluster et exécutez la commande « tar cvzf fe-perf-stats.tar.gz fe_perf_stats* » pour compresser les données des fichiers dans un fichier tar. Connectez-vous au nœud avec WINSCP ou un utilitaire SCP équivalent, puis accédez à /var/log/VPlex/cli. Copiez le fichier « fe-perf-stats.tar.gz » sur votre système. Téléchargez le fichier tar avec le(s) fichier(s) collect-diagnostics, si vous y êtes invité par le support, sur la demande de service ou sur un lien ftp que le support vous fournira dans la demande de service, ainsi qu’un e-mail. 

5. En plus de collecter des diagnostics, il peut être utile de capturer les informations suivantes :

• open logging pour une session PuTTY,
• puis exécutez les commandes ci-dessous,
• puis collectez le journal Putty et téléchargez-le sur votre système,
• Joignez ensuite le journal PuTTY, collect-diagnostics
  et toutes les autres données demandées à la demande de service.

1. État du cluster 
2. ll clusters/**/storage-views/* --full 
3. ll ~ports 
4. show-use-hierarchy /clusters/**/virtual-volumes/* 
5. LL ~volumes système 
6. ls -t /clusters/*/directors/* ::serial-number [cette commande répertorie tous les DST pour chaque nœud]
7. ls -t /clusters/**/director-*/ ::hostname [les noms d’hôte affichés sont les adresses IP, ce qui est normal]

B. Comment capturer collect-diagnostics sur un cluster Metro Node ? 
 
Remarque : Le fichier de base, couvrant les 30 derniers jours, est suffisant pour examiner et résoudre la plupart des problèmes. Ces options doivent être utilisées, sauf instruction contraire du support.
Pour capturer ces données, exécutez une commande collect-diagnostics avec les balises suivantes « --noextended » et « --last-logs 30d ».

1. Établissez une session SSH à l’invite Linux d’un nœud directeur, par exemple service@director-1-1-a, puis connectez-vous à vplexcli. 

Exemple de résultat :

login as: service 
Keyboard-interactive authentication prompts from server: 
| Password: 
End of keyboard-interactive prompts from server 
Last login: <date and timestamp data> from x.x.x.x
service@director-1-1-a:~> 
service@director-1-1-a:~> vplexcli 
Trying ::1... 
Connected to localhost. 
Escape character is '^]'. 
 
VPlexcli:/> 

2. Pour démarrer collect-diagnostics, à partir de l’invite vplexcli, exécutez la commande « collect-diagnostics » avec les options dirigées, comme indiqué dans l’exemple ci-dessous. 

Exemple de sortie : 

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2024-02-09 19:55:12 UTC: ****Initializing collect-diagnostics... 
2024-02-09 19:55:13 UTC: No cluster-witness server found. 
2024-02-09 19:55:13 UTC: Free space = 88G 
2024-02-09 19:55:13 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection .. 

C. Comment valider les packages collect-diagnostics existants sur le directeur/nœud. 

1. Lorsque la commande collect-diagnostics se termine et revient à l’invite vplexcli, connectez-vous au directeur à partir duquel vous avez exécuté la commande à l’aide de winscp [ou de l’utilitaire SCP équivalent] et accédez au dossier /diag/collect-diagnostics-out/ 

2. Identifiez les fichiers journaux avec l’horodatage correct et téléchargez-les sur votre station de travail local. 

D. Comment abandonner un collect-diagnostics

en coursNote:  Il s’agit d’une activité sans perturbation. Étant donné qu’il n’existe aucune commande directe pour abandonner le processus de collecte, vous devrez redémarrer la console de gestion. Toutefois, avant d’abandonner un collect-diagnostics en cours d’exécution, contactez le support pour expliquer pourquoi vous souhaitez abandonner l’exécution du collect-diagnostics afin de vous assurer qu’il est correct, car des données peuvent être perdues. Ces données perdues ne seront plus disponibles pour la collecte lorsque collect-diagnostics est réexécuté après l’action d’abandon.

1. Si vous êtes toujours sur la session PuTTY où vous avez démarré collect-diagnostics, vous devriez voir la sortie collect-diagnostics en streaming et voir qu’elle est toujours en cours d’exécution. 

Exemple de sortie : 

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2022-02-09 19:55:12 UTC: ****Initializing collect-diagnostics... 
2022-02-09 19:55:13 UTC: No cluster-witness server found. 
2022-02-09 19:55:13 UTC: Free space = 88G 
2022-02-09 19:55:13 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection .. 

2. Ouvrez une session PuTTY en double et connectez-vous au directeur où vous avez démarré la collecte de diagnostics à l’aide du compte de service. 

  Exemple de sortie : 

login as: service 
Using keyboard-interactive authentication. 
Password: 
Last login: <date and time stamp data> from x.x.x.x 
service@director-1-1-b:~>

3. Une fois sur le directeur, redémarrez la console de gestion à l’aide de la commande suivante pour abandonner le collect-diagnostics en cours d’exécution.  

Exemple de sortie : 

   service@director-1-1-b :~> sudo systemctl restart VPlexManagementConsole.service 
 

4. Lors du redémarrage de la console de gestion, vous devriez consulter le rapport collect-diagnostics suivant comme dernière sortie notée : 

"Connection closed by foreign host."

Exemple de sortie (vérifiez la dernière ligne de la sortie) :

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2022-02-09 20:02:03 UTC: ****Initializing collect-diagnostics... 
2022-02-09 20:02:04 UTC: No cluster-witness server found. 
2022-02-09 20:02:04 UTC: Free space = 88G 
2022-02-09 20:02:04 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection ..                               ERROR 
Executing SMS log collection ..                               Connection closed by foreign host. <<<

5. Une fois que collect-diagnostics est arrêté, étape 3 ci-dessus, revenez à la deuxième session PuTTY et 'cd' dans le répertoire /diag, puis exécutez ' ll ' et vous devriez voir des répertoires supplémentaires, 

• collect-diagnostics-tmp
• collect-diagnostics-jobs 
• collect-diagnostics-tmp-ext*

      *si les fichiers étendus n’ont pas été omis

Exemple de résultat : 

service@director-1-1-b:/diag> ll 
total 32 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:03 collect-diagnostics-tmp-ext
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:03 collect-diagnostics-jobs 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:04 collect-diagnostics-out 
drwxr-xr-x 3 service groupSvc  4096 Feb  9 20:02 collect-diagnostics-tmp 
drwx------ 2 root    root     16384 Jan 27 16:54 lost+found 
drwx--x--x 3 service groupSvc  4096 Dec 17 03:08 share 
service@director-1-1-b:/diag> 

6. Si vous regardez à l’intérieur de chacun de ces répertoires, vous verrez des fichiers avec la date et l’heure auxquelles vous avez démarré la collecte de diagnostics maintenant annulée. Ces fichiers occupent de l’espace dans la partition /diag et doivent être supprimés. 

7. Pour retirer/supprimer les fichiers du répertoire /diag, saisissez « rm -r collect-diagnostics-jobs » et « rm -r collect-diagnostics-tmp », puis saisissez à nouveau 'll ' pour vous assurer que les répertoires ont été supprimés/supprimés. 

Exemple de résultat : 

service@director-1-1-b:/diag> rm -r collect-diagnostics-jobs 
service@director-1-1-b:/diag> rm -r collect-diagnostics-tmp 

service@director-1-1-b:/diag> ll 
total 24 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:04 collect-diagnostics-out 
drwx------ 2 root    root     16384 Jan 27 16:54 lost+found 
drwx--x--x 3 service groupSvc  4096 Dec 17 03:08 share 
service@director-1-1-b:/diag> 

8. S’il existe un répertoire « collect-diagnostics-tmp-ext », supprimez-le et exécutez « rm -r collect-diagnostics-tmp-ext »  

Remarque : Le fichier étendu est généralement utilisé pour enquêter sur les pannes de nœud. Si une enquête est en cours sur une panne de nœud et que le support n’a pas capturé tous les journaux nécessaires, contactez le support avant de nettoyer le répertoire collect-diagnostics-tmp-ext, car vous risquez de supprimer les fichiers mémoire nécessaires.