NetWorker VMware Protection-vProxy: Como habilitar o log de depuração

Assista a este vídeo: Como habilitar o log de depuração do vProxy.

Métodos para aplicar a depuração do mecanismo vProxy:

Geralmente, é suficiente analisar os registros de política do servidor do NetWorker em /nsr/logs/policy/[policy name], mas ocasionalmente pode ser necessário analisar os logs do próprio equipamento vProxy e, além disso, aumentar o nível de log para depuração, a fim de obter uma ideia mais clara do motivo de uma falha. Geralmente, isso é apenas um requisito quando o suporte do NetWorker é acionado e o engenheiro de suporte solicita o conjunto de depuração para solucionar problemas como um processo específico. 

Os arquivos de log do NVP-vProxy no equipamento vProxy estão no seguinte diretório /opt/emc/vproxy/runtime/logs.

Há um subdiretório para cada um dos processos principais que são usados para operações do NetWorker no equipamento vProxy:

vbackupd

vflrd

vrapid

vrecoverd

Por exemplo, o vbackupd O subdiretório contém os seguintes logs:

[session-uuid].log             Processing details for a session
vbackupd-engine.log            Requests and problem events including error and panic messages from the session log.
vbackupd-boost.log             DD Boost logging.
vbackupd-snapmgr.log           Snapshot logging
vbackupd-vddk.log              VDDK logging -  VMware Virtual Disk Development Kit

Informações adicionais sobre o log e a coleta do vProxy podem ser encontradas no artigo Guia de triagem do NVP-vProxy: Visão geral de registros e triagem do NetWorker VMware Protection vProxy

Como aplicar o método de depuração de serviço 1:

Esse método se aplica à versão 4.3.x e posterior do vProxy. Ele pode ser usado para habilitar a depuração em serviços do vProxy (vrapid, vrecoverd, vbackupd, vflrd). Mais depuração pode ser habilitada para tráfego do DD Boost, kit de desenvolvimento de disco virtual (VDDK) e sistema de mensagens de snapshot (quando aplicável).

1. Conecte-se ao vProxy via SSH usando a conta de administrador do vProxy.
2. Alterne para root:

sudo su -

3. Altere para o diretório bin do agente vProxy:

cd /opt/emc/vproxy/bin

4. Para o serviço que requer depuração, execute os seguintes comandos:

Mecanismo de backup: vbackupd

./vProxy_debug.sh -s -d vbackupd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log

/opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log

./vProxy_debug.sh -s -d vbackupd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log

./vProxy_debug.sh -s -d vbackupd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.log

./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log

Mecanismo de recuperação: vrecoverd

./vProxy_debug.sh -s -d vrecoverd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log

/opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log

./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log

./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log

Mecanismo FLR: vflrd

./vProxy_debug.sh -s -d vflrd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log

/opt/emc/vrproxy/runtime/logs/vflr/FlrMountSession-<session-id>.log
Individual FLR Browse Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrBrowseSession-<session-id>.log
Individual FLR Recover Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrRecoverSession-<session-id>.log

/opt/emc/vrproxy/runtime/logs/recycle/vflrd

./vProxy_debug.sh -s -d vflrd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log

Servidor REST: vrapid

./vProxy_debug.sh -s -d vrapid -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log

Os comandos acima mostram como habilitar a depuração. Esses comandos podem ser executados novamente alterando o -l opção para redefinir para o padrão:

Opções:

• Para registro do programa:

• Para log do DD Boost:

• Para log do VDDK:

• Para log do Snapshot Manager:

Aplicando o método de depuração de serviço 2 (manualmente):

1. Faça log-in no equipamento vProxy como administrador via SSH ou console e alterne para root:

sudo su -

2. Acesse o systemd Diretório:

cd /usr/lib/systemd/system/ 

3. Abra o arquivo de serviço que requer configurações de depuração, por exemplo:

vi vbackupd.service 

4. Localize a linha com ExecStart= e acrescente com os parâmetros de depuração desejados:

vbackupd, vrecoverd, vflrd, and vrapid engine debug options: { debug | trace | info | warn } (default "trace")
--program-log-level=option

vbackupd, vrecoverd, and vflrd ddboost debug options: { none | error | warn | info | debug | all } (default "trace")
--boost-log-level=option

vbackupd snapshot manager debug options: { warn | info | trace | debug } (default "trace")
--snapmgr-log-level=option

Display version
--version

Multiple options could be used at once, for example if you needed to debug the vbackupd service, ddboost communication, and snapshot manager logging, the vbackupd.service file would include:
ExecStart=/opt/emc/vproxy/bin/vbackupd --program-log-level=debug --boost-log-level=all --snapmgr-log-level=debug

5. Salve as alterações ao arquivo.
6. Recarregue o arquivo de configuração da unidade digitando o comando:

systemctl daemon-reload

7. Confirme no NetWorker Management Console que nenhum backup está em execução e, em seguida, reinicie o vbackupd do servidor do NMC:

systemctl restart vbackupd.service

O processo acima é aplicável aos serviços vrapid, vrecoverd, vbackupd, vflrd.

Aplicando a depuração do VDDK (manualmente):

A depuração do VMware Disk Development Kit (VDDK) pode ser aplicada manualmente no VixDiskLib.config . Essa depuração só se aplica a vbackupd e vrecoverd Solucionando problemas. Não se aplica a vflrd.
 

1. Faça log-in no equipamento vProxy usando SSH ou console como administrador e alterne para root:

sudu su -

2. Edite o VixDiskLib.config para conter a seguinte linha:

vi /opt/emc/vproxy/conf/VixDiskLib.config 
vixDiskLib.transport.LogLevel=4

0 = No logging
1 = Errors only
2 = Warnings, and Errors
3 = Important information messages, errors, and warnings
4 = Debug data plus everything else

3. Reinicie o serviço relevante:

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

Depois que o log de depuração for definido, o arquivo de log associado ao serviço deverá conter linhas de DEBUG.

Depois de concluir o processo de depuração, redefina o nível de registro usando o mesmo procedimento, usando o rastreamento de palavras após o sinal de igual em vez de depurar. Para que essa alteração seja imediatamente aplicável, é necessário recarregar e reiniciar o daemon, conforme descrito acima.

Depuração de pré-certificação do DD Boost:

Esse processo é feito com outros métodos de depuração descritos acima. Por padrão, a biblioteca do DD Boost não registra atividades detalhadas da API (Application Programming Interface). A ativação do log de pré-certificado do DD Boost só deve ser feita quando você estiver observando outros erros relacionados ao DD Boost no vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log arquivos e depuração adicional são necessários. Normalmente, isso só é necessário quando solicitado diretamente pelo suporte do NetWorker para colaborações ou engajamentos de engenharia do Data Domain.

1. Faça log-in no equipamento vProxy usando SSH ou console como administrador e alterne para root:

sudu su -

2. Crie um arquivo vazio chamado ddboost_precert.ini em /:

touch /ddboost_precert.ini

3. Crie o DDLog Diretório:

mkdir /DDLog

4. Habilite a depuração do DD Boost para o serviço que requer depuração:

vbackupd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vbackupd -p ddboost -l debug

vflrd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vflrd -p ddboost -l debug

vrecoverd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vrecoverd -p ddboost -l debug

5. Confirme se o ddboost_precert.log for gerado, reproduza o problema e colete o ddboost_precert.log:

ls -l /DDLog

6. Quando as operações de depuração não são mais necessárias:
   1. Execute novamente o seguinte comando no serviço que você habilitou a depuração do ddboost:

/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace

1. 2. Exclua o /ddboost_precert.ini .

rm -rf /ddboost_precert.ini

Log de seleção do vProxy:

Essa depuração pode ser usada sempre que um fluxo de trabalho de backup de máquina virtual (VM) estiver travado com as VMs em Aguardando para ser executadas. Nesse cenário, o trabalho de backup foi iniciado, mas nenhum vProxy foi selecionado para iniciar a sessão de backup. Não há registro do processo de seleção do vProxy no log padrão. Podemos ativar vmbackup_logging no servidor do NetWorker, que registra o processo de seleção do vProxy durante o início da política de proteção VMware. Isso é útil quando não há problemas de comunicação entre o servidor NetWorker e o vProxy (porta 9090) e nenhum erro sobre o vProxy estar indisponível no NMC ou daemon.raw.

1. Abra um prompt administrativo do PowerShell (Windows) ou uma sessão SSH raiz (Linux) no servidor NetWorker.
2. Criar um arquivo sem uma extensão chamada vmbackup_logging no NetWorker /nsr/tmp Diretório:

Linux: 
touch /nsr/tmp/vmbackup_logging

Windows: 
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File

3. Inicie o trabalho de backup da VM.
4. Monitore o daemon.log renderizado para Vmproxy Queue e select_vproxy Mensagens.

Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log

5. Para desativar essa depuração, exclua o vmbackup_logging do /nsr/tmp Dir.

Artigos relacionados:

• Guia de triagem do NVP-vProxy: Visão geral de registros e triagem do NetWorker VMware Protection vProxy
• NVP vProxy: Como obter a sintaxe exata do comando para executar uma recuperação de VM a partir da CLI com depuração.
• NetWorker (Linux): Como copiar arquivos de/para um servidor NetWorker no Linux.
• NVP vProxy: Solução de problemas de conectividade de rede para operações de backup e restauração
• NetWorker: NVP vProxy: Solução de problemas de desempenho e throughput nos backups de VM