NetWorker VMware Protection-vProxy: como ativar o log de depuração

Assista a este vídeo: Como ativar 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 de um processo específico. 

Os arquivos de log NVP-vProxy no equipamento vProxy estão no seguinte diretório: /opt/emc/vproxy/runtime/logsHá 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 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 log e coleta do vProxy podem ser encontradas no artigo Guia de triagem do NVP-vProxy: visão geral de log 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.1. 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.
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:

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

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

sudo su -

2. Acesse o systemd no 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 no momento e, em seguida, reinicie o serviço vbackupd: vbackupd Serviços

systemctl restart vbackupd.service

systemctl restart vbackupd.serviceO processo acima é aplicável aos serviços: vrapid, vrecoverd, vbackupd, vflrd.

Aplicando a depuração do VDDK:

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 a solução de 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 isso seja imediatamente aplicável, o recarregamento e a reinicialização do daemon serão necessários, conforme descrito acima.

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

Esse processo pode ser feito em conjunto com outros métodos de depuração descritos acima.1. 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 o arquivo ddboost_precert.ini em /: 

vi /ddboost_precert.ini

Coloque o seguinte no arquivo:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=3

3. Crie o arquivo DDLog no diretório:

mkdir /DDLog ; chmod 755 /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. Uso precert-io-perf.py para analisar o ddboost_precert.log arquivos: NetWorker: como analisar o desempenho de E/S usando ddboost_precert.log
7. 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. Excluir 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 habilitar esse recurso. 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 no 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 message:

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.

Depuração da interface do usuário do vProxy:

• NVP-vProxy: Guia de solução de problemas do Data Protection Restore Client (DPRC)
• NVP-vProxy: solução de problemas do plug-in do vCenter e da interface do usuário (VCUI)

Artigos relacionados:

• Guia de triagem do NVP-vProxy: visão geral de log 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 Linux.
• NVP vProxy: Solução de problemas de conectividade de rede para operações de backup e restauração
• NetWorker: solução de problemas do NVP vProxy Desempenho e throughput de backup e restauração de VM