Metronod: Så här samlar du in loggar från metronoden

Steg för hur du utför följande uppgifter:

1. Vilka loggar krävs för att felsöka problem med metronoder?
2. 如何实现 samla in diagnostik i ett metronodkluster?
3. Validera de befintliga collect-diagnostics-paketen på hanteringsservrarna.
4. Hur avbryter och rensar jag en pågående insamlingsdiagnostik i en metronod?

A. Vilka loggar krävs för att felsöka problem med metronoder?

1. Kommandot som krävs för att samla in loggar från metronoden kallas "collect-diagnostics" och kan köras från valfri nod(*1) i metronodens konfiguration. Om du kör det här kommandot på en katalog för ett metronodkluster bör alla data från alla styrenheter, från alla noder i ett kluster, köras. Kör INTE det här kommandot på mer än en nod i taget.

   *1 NOTERA: Kör kommandot "collect-diagnostics" från endast en styrenhet, på endast ett kluster om det är en Metro-konfiguration, och vänta tills det är helt klart innan du samlar in cd-skivorna från en annan styrenhet eller från peer-klustret, om det behövs.

2. Kommandot "collect-diagnostics" skapar en komprimerad tar.gz loggfil som innehåller konfigurations- och loggfiler. Filen collect-diagnostics placeras i katalogen /diag/collect-diagnostics-out/ på den nod som den kördes från. När kommandot är klart använder du WINSCP eller ett motsvarande SCP-verktyg för att kopiera filen från noden och sedan kan den tillhandahållas som stöd för analys. Det finns mer information om användningen av detta kommando i avsnitt B nedan.

   Kommentarer:

   • Om kommandot "collect-diagnostics" körs utan alternativ genereras två filer, en basfil och en utökad fil. Detta kan ta ganska lång tid på skalade system.
   • Stöd för metronoder kräver i allmänhet bara basfilen, men i vissa fall kan prestandaproblem även be om den utökade filen.
   • Standardalternativ som kan uppmanas att användas när du kör insamlingsdiagnostik är,
     • ”--noextended": Det här alternativet utelämnar insamling av utökad diagnostik.
     • ”--last-logs": Det här alternativet samlar in loggar tillbaka x antal timmar eller dagar.
   • Om du vill ha mer information om kommandot kan du skriva "collect-diagnostics -h"

   Det här är exempel på hur dessa två filnamn ser ut, datum och tid, som visas som YYYY-MM-DD-HH.MM.SS, är från det datum och den tid då dessa samlades in:

   • Basfil: <Serial number>-c1-diag-YYYY-MM-DD-HH.MM.SS.tar.gz
   • Utökad fil: <Serial number>-c1-diag-ext-YYYY-MM-DD-HH.MM.SS.tar.gz

3. Prestandafrågor är komplexa och kräver att mycket specifik information samlas in. Som ett resultat av detta har vi ett frågeformulär som kunderna uppmanas att fylla i för att påskynda denna process. Frågeformuläret finns bifogat till denna kunskapsbasartikel i avsnittet för bifogade filer i slutet.

4. Vid vissa typer av prestandaproblem är det bra att skapa ytterligare en logg med namnet "fe_perf_stats". Loggarna genereras kontinuerligt, men samlas inte in av collect-diagnostics. Om du vill spara loggen cd (change directory) till /var/log/VPlex/cli på en nod från varje kluster kör du kommandot "tar cvzf fe-perf-stats.tar.gz fe_perf_stats*" för att komprimera filernas data till en tar-fil. Anslut till noden med WINSCP eller ett motsvarande SCP-verktyg och bläddra till /var/log/VPlex/cli. Kopiera fe-perf-stats.tar.gz-filen till systemet. Ladda upp tar-filen tillsammans med en eller flera collect-diagnostics-filer, om supporten begär det, till SR eller en FTP-länk som supporten tillhandahåller i SR och ett e-postmeddelande.

5. Förutom att samla in diagnostik kan det vara bra att samla in följande information;

   • Öppen loggning för en putty-session,
   • Kör sedan kommandona nedan,
   • Samla sedan in PuTTY-loggen och ladda ner den till ditt system,
   • Bifoga sedan PuTTY-loggen, collect-diagnostics och andra data som begärs till SR.

   Följande kommandon ska köras från VPlexcli-kommandotolken.

   1. cluster status
   2. ll clusters/**/storage-views/* --full
   3. ll ~ports
   4. show-use-hierarchy /clusters/**/virtual-volumes/*
   5. ll ~system-volumes
   6. ls -t /clusters/*/directors/*::serial-number (det här kommandot visar en lista över alla DST:er för varje nod)
   7. ls -t /clusters/**/director-*/::hostname (värdnamnen som visas är IP-adresserna, detta förväntas)

B. 如何实现 samla in diagnostik i ett metronodkluster?

1. Upprätta en SSH-session vid en Linux-kommandotolk för Director-nod, till exempel service@director-1-1-a, och logga sedan in på vplexcli.

   Exempel på utdata:

   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. Om du vill starta collect-diagnostics kör du kommandot "collect-diagnostics" från vplexcli-prompten med de riktade alternativen som visas i exemplet nedan.

   Exempel på utdata:

   VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 
   
   ('WARNING:The collect-diagnostics command was issued with option --noextended.
   ',) 
   
   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. Hur du verifierar befintliga collect-diagnostics-paket på katalogen/noden.

1. När kommandot collect-diagnostics har slutförts och återgår till vplexcli-prompten ansluter du till katalogen som du körde kommandot från med hjälp av winscp [eller motsvarande SCP-verktyg] och bläddrar till mappen /diag/collect-diagnostics-out/

2. Identifiera en eller flera loggfiler med rätt tidsstämpel och ladda ned dem till din lokala arbetsstation.

D. Hur man avbryter en pågående insamlingsdiagnostik

1. Om du fortfarande är i PuTTY-sessionen där du startade collect-diagnostics bör du se utdataströmningen collect-diagnostics och visa att den fortfarande körs.

   Exempel på utdata:

   VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 
   
   ('WARNING:The collect-diagnostics command was issued with option --noextended.
   ',) 
   
   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. Öppna en duplicerad PuTTY-session och logga in på den regissör där du startade collect-diagnosticsen med hjälp av tjänstkontot.

   Exempel på utdata:

   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. När du är på katalogen startar du om hanteringskonsolen med följande kommando för att avbryta den collect-diagnostics som körs.

   Exempel på utdata:

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

4. Om du ser tillbaka på den första PuTTY-sessionen som har collect-diagnostics som körs när du startade om hanteringskonsolen bör du se collect-diagnostics-rapporten följande som de senast noterade utdata:

   "Connection closed by foreign host."

   Exempel på utdata (kontrollera den sista raden i utdata):

   VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 
   
   ('WARNING:The collect-diagnostics command was issued with option --noextended.
   ',) 
   
   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. När collect-diagnostics har stoppats, steg 3 ovan, gå tillbaka till den andra PuTTY-sessionen och "cd" till katalogen /diag, kör sedan "ll" så bör du se några extra kataloger,

   • collect-diagnostics-tmp
   • collect-diagnostics-jobs
   • collect-diagnostics-tmp-ext*
     *om utökade filer inte utelämnades

   Exempel på utdata:

   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. Om du tittar i var och en av dessa kataloger ser du filer med datum och tid då du startade den nu avbrutna insamlingsdiagnostiken. Dessa filer tar upp utrymme i partitionen /diag och bör tas bort.

7. Om du vill ta bort/ta bort filerna från katalogen /diag skriver du "rm -r collect-diagnostics-jobs" och "rm -r collect-diagnostics-tmp" och anger sedan "ll" igen för att säkerställa att katalogerna har tagits bort eller tagits bort.

   Exempel på utdata:

   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. Om det finns katalogen "collect-diagnostics-tmp-ext" tar du bort den genom att köra "rm -r collect-diagnostics-tmp-ext"

   Obs! Den utökade filen används vanligtvis för att undersöka nodkrascher. Om det finns en pågående undersökning av en nodkrasch och supporten inte har samlat in alla nödvändiga loggar kontrollerar du med supporten innan du rensar katalogen collect-diagnostics-tmp-ext eftersom det kan ta bort nödvändiga kärnfiler.