Este artigo descreve como gerar e coletar os vários registros que podem ser necessários para a solução de problemas do PowerStore.
Materiais de suporte
Arquivos de medição de desempenho
Dump Files
Logs de UI/REST do PowerStore
PowerStore X (logs do hypervisor)
Materiais de suporte
Os materiais de suporte ou coletas de dados (DCs) são os logs mais comuns para análise e solução de problemas. Há vários métodos para executar e coletar materiais de suporte. Use o método mais conveniente para você, dependendo do estado do sistema e do tipo de acesso que você tem a ele.
Notas:
Usando a interface do usuário do PowerStore Manager (recomendado)
- Faça login na interface do usuário (IU) do PowerStore Manager com seu nome de usuário e senha.
- Clique no menu Settings ou no nome do sistema.
- Vá para Gather Support Materials na seção Support.
- Pressione o botão Gather Support Materials. Um novo submenu é exibido no lado direito.
- As opções padrão devem ser:
- Descrição: Opcional
- Collection Timeframe (v3+ only): Deixe definido como Default (All), a menos que seja instruído pelo suporte técnico a selecionar algo mais.
- Object Type: de proteção de dados
- Objects to collect data for: Selecione all appliances.
- Send materials to Support when finished: Opcional (requer o SupportAssist).
- Advanced support materials collection options: Deixe desmarcado, a menos que o suporte o solicite. Nota: Ao selecionar as opções avançadas aumenta significativamente o tamanho dos arquivos dos materiais de suporte. Escolha essa opção somente quando instruído pelo representante de suporte.
- Pressione START. O processo pode demorar até 60 minutos, dependendo do tamanho da unidade.
- Você pode monitorar o andamento na seção Jobs do PowerStore Manager ou na seção Support Materials.
- Quando o processo acima tiver terminado, selecione o pacote que você deseja fazer download em Support Materials Library na seção Support Materials.
- Pressione DOWNLOAD ou SEND TO SUPPORT
- Um submenu é exibido no lado direito com um link de download para cada equipamento.
- Clique em Support material Collection para todos os equipamentos.
Usando ssh/cli
Antes de começar:
Como:
- Faça login no sistema via ssh com o usuário e a senha do serviço.
- O comando de serviço para gerar materiais de suporte é svc_dc.
Se você tiver um sistema de vários equipamentos, inclua todos eles na coleta, por exemplo, para um cluster de dois equipamentos:
Para uso detalhado, execute svc_dc -h
ou svc_dc run -h
- consulte o Guia de scripts de serviço do PowerStore disponível nas páginas do Suporte Dell.
- Quando os registros terminarem, você estará pronto para fazer download deles.
Para facilitar esse processo, os links para os logs são criados automaticamente no diretório base (/home/service/user) quando os logs terminam de ser executados. Você pode listá-los com ls -l. Se, por algum motivo, o link não for criado e você precisar listar os arquivos manualmente, isso deverá ser feito desta maneira:
Liste os materiais de suporte (DCs) disponíveis com o comando de serviço svc_dc list. Exemplo:
[SVC:service@xxxxxxx-A user]$ svc_dc list start_timestamp id status dump description profile appliances 2020-04-08 12:48:37 xxxx-xxxx-xxxx SUCCESS No essential FNM00xxxxx.. 2020-04-08 14:36:42 xxxx-xxxx-xxxx SUCCESS No Post NDU detailed,.. FNM00xxxxx.. 2020-04-09 13:33:57 xxxx-xxxx-xxxx SUCCESS No detailed FNM00xxxxx.. 2020-04-15 15:05:34 xxxx-xxxx-xxxx SUCCESS Yes 2020-04-15 Dail.. essential.. FNM00xxxxx.. 2020-04-16 15:23:07 xxxx-xxxx-xxxx SUCCESS No 2020-04-16 Dail.. essential FNM00xxxxx.. 2020-04-16 19:07:41 xxxx-xxxx-xxxx SUCCESS No Daily data coll.. essential FNM00xxxxx.. |
Aqui você pode ver as datas, ID, status, se houver dumps, descrição, perfis usados (svc_dc list_profiles) e o equipamento ao qual os registros correspondem.
Ao obter o ID, você pode executar o comando list com ele para poder ver todos os detalhes, incluindo locais de arquivos e assim por diante. Exemplo do comando (saída não mostrada):
[SVC:service@xxxxxxx-A user]$ svc_dc list xxxx-xxxx-xxxx |
Se o ID do pacote incluir registros para vários equipamentos, você também obterá o caminho completo para os arquivos na saída de cada respectivo equipamento.
- Faça download dos logs. Há várias maneiras de fazer download dos pacotes de arquivos de log por meio da CLI/SSH dos equipamentos. Aqui estão alguns.
Usando ferramentas como WinSCP
-
Devido ao rbash e a outras implementações de segurança no PowerStore, determinados comandos e operações não são permitidos, por exemplo, comandos como cd ou protocolos como SFTP. Ou seja, para WinSCP, você tem que escolher SCP como o protocolo de conexão.
-
Lembre-se de que, mesmo com o WinSCP, você só tem acesso ao diretório base, que é /home/service/user. No entanto, conforme descrito acima, os links para os logs são criados no diretório base.
-
Conecte-se ao sistema com o WinSCP e arraste e solte os respectivos links. Isso deve iniciar o download do arquivo. Uma mensagem de erro pop-up pode ser exibida, o que não afeta o download depois que você pressiona OK.
Usando svc_upload ou svc_dc download
Este é um comando de serviço para facilitar o download ou o upload do log. O uso depende do seu ambiente. Consulte o Guia de scripts de serviço disponível nas páginas de suporte ou uso
svc_dc download -h
ou
svc_dc upload -h
para obter todos os detalhes.
Usando o utilitário pscp do Windows
O Windows fornece uma ferramenta chamada pscp (no prompt de comando) que pode ser usada para fazer download ou carregar logs diretamente do sistema e para ele. Você precisa do local exato do arquivo no PowerStore Appliance (você pode usar os links no diretório base do usuário de serviço).
Sintaxe:
pscp -scp service@PowerStore-ip-address:/path/file C:\local_directory |
Exemplo do prompt de comando do Windows:
C:\>pscp -scp service@xx.xx.xx.xx:/home/service/user/powerstore_tag_clusterID_serial_2020-04-08_14-36-42_service-data.tgz C:\LOGS service@xx.xx.xx.xx's password: powerstore_tag_clusterID_.. | 320000 kB | 45714.3 kB/s | ETA: 00:00:05 | 54% |
Arquivos de medição de desempenho
Usando o PowerStore Manager
Isso só é possível para sistemas que executam o PowerStoreOS v3.x e superior. Se você estiver no PowerStoreOS v2, consulte a próxima seção.
- Faça login na interface do usuário (IU) do PowerStore Manager com seu nome de usuário e senha.
- Clique no menu Settings ou no nome do sistema.
- Vá para Metrics Archives na seção Support.
- Clique em Generate Metrics Archive > Generate.
- Você pode monitorar o andamento na seção Jobs do PowerStore Manager.
- Quando terminar, na seção Metrics Archives, selecione o arquivo gerado e clique em Download.
Usando ssh/cli
-
Use a PSTCLI para gerar medições de desempenho. O comando é
-service support_metrics_archive
(dentro ou fora do nó PSTCLI). Para obter detalhes completos sobre como usar a PSTCLI, consulte o
Guia da CLI do PowerStore.
Exemplo de como gerar um pacote de arquivos de desempenho de alguns dias (compensações em segundos). Exemplo usando a PSTCLI no nó:
pstcli -d self -u admin -p MyPassword -service support_metrics_archive generate -start_offset 172800 -end_offset 0 Success # | archive_id ----+-------------------------------------- 1 | 6e869e4e-2612-45ed-b531-6884fa4c802a |
Outros exemplos:
- Último dia até hoje: -start_offset 86400 -end_offset 0
- Somente do dia anterior: -start_offset 172800 -end_offset 86400
- Semana anterior até hoje: -start_offset 604800 (se -end_offset não for fornecido, os dados serão capturados até o momento atual).
Nota: Esses são apenas exemplos. Uma semana de dados de desempenho completa nem sempre está disponível. Se o evento de desempenho que você está tentando investigar tiver mais de dois dias, os dados de desempenho provavelmente não estarão mais disponíveis.
O arquivo de desempenho gerado é encontrado dentro do seguinte diretório, em que xxxx é uma pasta de data ou pastas específicas do seu sistema.
ls -lha /cyc_cfs/service/support_metrics/archived/xxxx |
O formato do arquivo é PowerStore_ClusterID_StartDate_EndDate_support-metrics.tar.gz.
Exemplo: PowerStore_abcdefg_2020-04-21T12-56-32_2020-04-28T12-56-32_support-metrics.tar.gz
-
Faça download do arquivo em uma máquina local diretamente com a
PSTCLI fora do nó, pscp conforme mostrado acima, ou copie o arquivo para
/home/service/user para fazer download com o WinSCP.
Usando a PSTCLI fora do nó:
Exemplo usando a PSTCLI fora do nó em uma máquina Windows com o ID acima:
pstcli -service -d -u -p support_metrics_archive -d "C:\Temp" -archive_id 6e869e4e-2612-45ed-b531-6884fa4c802a download Downloaded 81920000 (78.12M) at 3.39 MB/s ... Download complete. |
O arquivo é baixado para o caminho especificado (-d). Se nenhum caminho for especificado, o arquivo será baixado no caminho padrão de seu CMD (isso pode ser visto no próprio prompt de comando no CMD, por exemplo: C:\>Users\userX).
Usando a PSTCLI no nó ou copiando direto para fazer download com o WinSCP:
Se você estiver executando a PSTCLI diretamente do nó principal, poderá copiar o arquivo para o diretório base e, em seguida, transferir com o WinSCP.
Isso pode ser feito com o mesmo comando mostrado acima (sem o segundo switch -d ou com -d /home/service/user).
Você também pode copiar manualmente o arquivo para /home/service/user, conforme mostrado aqui:
Liste o arquivo ou os arquivos disponíveis executando
ls -lha /cyc_cfs/service/support_metrics/archived/
para determinar o nome exclusivo do subdiretório. E, em seguida:
[SVC:service@xxx-A user]$ ls -lha /cyc_cfs/service/support_metrics/archived/2021-03-09T12-09-50-512325/ total 183548 -rw-rw-r-- 1 root cycg 187945656 Mar 9 12:11 PowerStore_xxx_2021-03-02T12-09-50_2021-03-09T12-09-50_support-metrics.tar.gz |
Copie o arquivo em seu diretório atual (/home/service/user). O ponto (.) no final do comando denota o diretório de destino:
[SVC:service@xxx-A user]$ cp /cyc_cfs/service/support_metrics/archived/2021-03-09T12-09-50-512325/PowerStore_xxx_2021-03-02T12-09-50_2021-03-09T12-09-50_support-metrics.tar.gz . |
Depois que o arquivo for copiado, você poderá fazer download com o WinSCP.
Dump files
Usando o PowerStore Manager
Os dump files estarão disponíveis no PowerStore Manager exatamente como os materiais de suporte depois que você selecionar a entrada relevante e pressionar Download. A única diferença é que eles são listados como dump do material de suporte em vez de coleta de material de suporte.
Usando ssh/cli
A maneira mais fácil de encontrar e fazer download dos arquivos dump pelo ssh/cli é fazendo login no equipamento relevante como usuário de serviço e listando esses arquivos no diretório base. Como os materiais de suporte, os links são criados aqui para sua conveniência.
Você pode listá-los ou vê-los diretamente com o WinSCP ou executar comandos como ls *dump* para listar todos os dump files disponíveis no diretório base.
Se os dump files não estiverem listados no diretório base, você poderá usar os comandos de serviço svc_dc lista ou svc_dc list_dumps. As mesmas lógicas e princípios usados acima para os materiais de suporte se aplicam aqui.
Quando você obtém o ID do dump file, você pode usar svc_dc list para obter o local exato. Os mesmos mecanismos de download podem ser usados. Escolha o método mais conveniente para você.
Logs de UI/REST do PowerStore
Usando o PowerStore Manager
- Reproduza o problema na interface do usuário.
- Passe o mouse sobre o "?" Ícone de ajuda no canto superior direito da interface do usuário e digite Ctrl+Alt+Shift+botão esquerdo. (Isso faz com que uma opção de menu oculto seja exibida no menu Help)
- Selecione a opção "Download Network Requests" nesse menu e salve o arquivo de texto em seu sistema local.
Usando o navegador
- Com o navegador aberto, antes de iniciar o PowerStore Manager, pressione F12 para abrir a janela do desenvolvedor do navegador.
- Acesse a guia "Network".
- Inicie a interface do usuário e reproduza o problema.
- Na janela do desenvolvedor, clique com o botão direito em qualquer solicitação de rede no painel central e selecione "Save all as HAR with content".
PowerStore X (registros do hypervisor)
Usando o PowerStore Manager
A única maneira de coletar logs do hypervisor do PowerStore Manager é selecionando essa alternativa nas Advanced support materials collection options, conforme explicado na etapa 5 da seção acima: Como gerar um pacote de logs de materiais de suporte. No entanto, esse não é o método preferido, pois a seleção das opções avançadas aumenta muito o tamanho do pacote de registros.
Usando ssh/CLI
Na linha de comando do PowerStore, use svc_dc e inclua o perfil do hypervisor juntamente com o perfil normal (essencial):
svc_dc run -p essential,hypervisor |
Nota: os logs do vCenter não são coletados dessa maneira. Consulte a próxima seção (Usando o vSphere).
Depois que o pacote de material de suporte for baixado, os registros específicos do hypervisor poderão ser encontrados em:
./node_a/command_output/vmware/esx-*-host-1-*.tgz
./node_b/command_output/vmware/esx-*-host-2-*.tgz
No vSphere
Para coletar os logs do hypervisor (vm-support) do lado do vSphere, consulte a
KB 653 da VMware.
Se os logs do vCenter também forem necessários para a solução de problemas, selecione as opções relevantes, conforme explicado na KB da VMware.
generate support-bundle enable-all-plugin-options
|
Monitore até que eles sejam concluídos, conforme explicado no artigo da KB acima.
Uma vez concluído, se você não tiver uma maneira de fazer download dos logs dos switches, o suporte técnico Dell poderá fornecer um link de FTP temporário.
Use estes comandos para localizar e fazer download do pacote de logs:
copy supportbundle://your_bundle.tar.xz sftp://temp_username@ftp.emc.com/your_bundle.tar.xz
|
Em que "temp_username@ftp.emc.com" são os detalhes fornecidos pelo suporte técnico Dell se você não tiver um servidor FTP/SFTP. O endereço de FTP pode variar de acordo com sua localização.
Logs de importação do armazenamento externo
Plug-in de host do Linux
Formato: importcli log_show
Local do log: /var/log/import
Plug-in de host do Windows
Formato: Get-ImportKit-LoggingInfo
Local do log: C:\ProgramData\DELLEMC\log\
EqualLogic
Formato: ehcmcli log_show
Local do log: /var/log/equallogic
VPLEX e metro node