Nodo metro: Come raccogliere i log dal nodo metro

Procedura per eseguire le seguenti attività: 

1. Quali log sono necessari per eseguire il debug dei problemi del nodo metro? 
2. Come acquisire collect-diagnostics su un cluster nodo metro? 
3. Come confermare i pacchetti di raccolta della diagnostica esistenti sui server di gestione?  
4. Come interrompere e pulire una collect-diagnostics in corso in Metro Node?  

Nota: Se sono necessari i registri di SupportAssist, indirizzare il cliente all'articolo della KB 000135669 "Come esportare una raccolta di registri di SupportAssist da SupportAssist Enterprise? Connesso o Disconnesso "


 A. Quali registri sono necessari per eseguire il debug dei problemi di Metro Node? 

1. Il comando necessario per raccogliere i log dal nodo metro è denominato "collect-diagnostics" e può essere eseguito da qualsiasi^[1] nodo nella configurazione del nodo metro. L'esecuzione di questo comando su un director di un cluster nodo metro dovrebbe avere tutti i dati di tutti i director, di tutti i nodi di un cluster. NON eseguire questo comando su più di un nodo alla volta.

2. Il comando "collect-diagnostics" genera un file di log tar.gz compresso contenente i file di configurazione e log. Il file collect-diagnostics viene inserito nella directory /diag/collect-diagnostics-out/ nel nodo da cui è stato eseguito. Una volta completato il comando, utilizzare WINSCP o un'utilità SCP equivalente per copiare il file dal nodo in modo che possa essere fornito al supporto per l'analisi. Ulteriori informazioni sull'uso di questo comando sono disponibili nella sezione B riportata di seguito.

Note: 

• Se il comando "collect-diagnostics" viene eseguito senza opzioni, vengono generati due file, un file di base e un file esteso. Questa operazione può richiedere molto tempo sui sistemi in scala. 
• Il supporto del nodo metro richiede in genere solo il file di base, tuttavia, in alcune circostanze, potrebbero verificarsi problemi di prestazioni che potrebbero richiedere anche il file esteso. 
• Le opzioni standard che possono essere richieste quando si esegue collect-diagnostics sono: 

• Per ulteriori informazioni sul comando, è possibile digitare "collect-diagnostics -h" 

Questi sono esempi dell'aspetto di questi due nomi di file. La data e l'ora, mostrate come YYYY-MM-DD-HH.MM.SS, faranno riferimento alla data e all'ora in cui sono stati raccolti: 

• File di base - <Numero> di serie-c1-diag-YYYY-MM-DD-HH.MM.SS.tar.gz 
• File esteso - <Numero> di serie-c1-diag-ext-YYYY-MM-DD-HH.MM.SS.tar.gz 

3. I problemi relativi alle prestazioni sono complessi e richiedono la raccolta di molte informazioni specifiche. Di conseguenza, abbiamo un questionario sulle prestazioni che i clienti sono invitati a compilare per accelerare questo processo. Il questionario è disponibile in allegato a questo articolo della knowledge base nella sezione degli allegati alla fine. 

4. In alcuni tipi di problemi di prestazioni, è utile acquisire un registro aggiuntivo denominato "fe_perf_stats". I registri vengono generati continuamente, ma non acquisiti da collect-diagnostics. Per acquisire questo registro, passare a /var/log/VPlex/cli su un nodo di ciascun cluster ed eseguire il comando "tar cvzf fe-perf-stats.tar.gz fe_perf_stats*" per comprimere i dati dei file in un file tar. Connettersi al nodo con WINSCP o un'utilità SCP equivalente e passare a /var/log/VPlex/cli. Copiare il file "fe-perf-stats.tar.gz" sul sistema. Caricare il file tar insieme ai file collect-diagnostics, se richiesto dal supporto, nella SR o tramite un link FTP che verrà fornito all'utente nella SR e in un e-mail. 

5. Oltre a raccogliere dati diagnostici, può essere utile acquisire le seguenti informazioni:

• Aprire il logging per una sessione PuTTY,
• quindi eseguire i comandi riportati di seguito,
• quindi raccogli il registro PuTTY e scaricalo sul tuo sistema,
• quindi allegare il registro PuTTY,
  la diagnostica di raccolta e tutti gli altri dati richiesti alla SR.

1. Stato del cluster 
2. ll clusters/**/storage-views/* --full 
3. ll ~porte 
4. show-use-hierarchy /clusters/**/virtual-volumes/* 
5. ll ~volumi-sistema 
6. ls -t /clusters/*/directors/*::serial-number [questo comando elenca tutti i DST per ogni nodo]
7. ls -t /clusters/**/director-*/::hostname [i nomi host visualizzati saranno gli indirizzi IP, sono previsti]

B. Come acquisire collect-diagnostics su un cluster nodo metro? 
 
Nota: Il file di base, relativo agli ultimi 30 giorni, è sufficiente per analizzare e risolvere la maggior parte dei problemi. Queste opzioni devono essere utilizzate se non diversamente indicato dal supporto.
Per acquisire questi dati, eseguire un comando collect-diagnostics con i seguenti flag "--noextended" e "--last-logs 30d".

1. Stabilire una sessione SSH al prompt Linux di un nodo director, ad esempio service@director-1-1-a, quindi accedere a vplexcli. 

Output di esempio:

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. Per avviare collect-diagnostics, dal prompt vplexcli eseguire il comando "collect-diagnostics" con le opzioni indicate, come mostrato nell'esempio riportato di seguito. 

Output di esempio: 

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. Come convalidare i pacchetti collect-diagnostics esistenti sul director/nodo. 

1. Quando il comando collect-diagnostics termina e ritorna al prompt vplexcli, connettersi al director da cui è stato eseguito il comando utilizzando winscp [o utilità SCP equivalente] e passare alla cartella /diag/collect-diagnostics-out/ 

2. Identificare i file di registro con il timestamp corretto e scaricarli sulla workstation locale. 

D. Come interrompere una raccolta di diagnostica

in corsoNota:  Si tratta di un'attività che non comporta alcuna interruzione. Poiché non esistono comandi diretti per interrompere il processo di raccolta, sarà necessario riavviare la console di gestione. Tuttavia, prima di interrompere un'esecuzione di collect-diagnostics, contattare il supporto per spiegare perché si desidera interrompere l'esecuzione di collect-diagnostics per assicurarsi che sia corretta, in quanto potrebbero esserci dati che potrebbero andare persi. Questi dati persi non saranno nuovamente disponibili per la raccolta quando la diagnostica di raccolta viene eseguita nuovamente dopo l'azione di interruzione.

1. Se è ancora attiva la sessione PuTTY in cui è stata avviata collect-diagnostics, dovrebbe essere visualizzato il flusso dell'output collect-diagnostics, indicante che è ancora in esecuzione. 

Output di esempio: 

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. Aprire una sessione PuTTY duplicata e accedere al director in cui è stata avviata la diagnostica collect, utilizzando l'account di servizio. 

  Output di esempio: 

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. Una volta nel director, riavviare la console di gestione utilizzando il seguente comando per interrompere collect-diagnostics in esecuzione.  

Output di esempio: 

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

4. Tornando alla prima sessione PuTTY con collect-diagnostics in esecuzione al riavvio della console di gestione, dovrebbe essere visualizzato il report collect-diagnostics riportato come ultimo output annotato: 

"Connection closed by foreign host."

Output di esempio (controllare l'ultima riga dell'output):

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. Una volta che collect-diagnostics viene arrestato, passaggio 3 sopra, tornare alla seconda sessione PuTTY e 'cd' alla directory /diag, quindi eseguire ' ll ' e dovrebbero vedere alcune directory aggiuntive, 

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

      *se non sono stati omessi file estesi

Output di esempio: 

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. Se si esamina l'interno di ciascuna di queste directory, verranno visualizzati i file con la data e l'ora in cui è stato avviato collect-diagnostics, ora annullato. Questi file occupano spazio nella partizione /diag e devono essere rimossi. 

7. Per rimuovere/eliminare i file dalla directory /diag, digitare "rm -r collect-diagnostics-jobs" e "rm -r collect-diagnostics-tmp", quindi immettere nuovamente " ll " per assicurarsi che le directory siano state eliminate/rimosse. 

Output di esempio: 

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. Se esiste una directory 'collect-diagnostics-tmp-ext', rimuoverla e poi eseguire "rm -r collect-diagnostics-tmp-ext"  

Nota: Il file esteso viene in genere utilizzato per analizzare gli arresti anomali dei nodi. Se è in corso un'indagine su un arresto anomalo di un nodo e il supporto non ha acquisito tutti i registri necessari, contattare il supporto prima di pulire la directory collect-diagnostics-tmp-ext in quanto in questo modo i file core necessari potrebbero essere eliminati.