Configurar o registro ZTNA para solução de problemas

Introdução

Este documento descreve como coletar logs detalhados de solução de problemas de ZTA e quando ativar passo a passo.

Informações de Apoio

À medida que as organizações adotam cada vez mais a Zero Trust Architecture (ZTA) para proteger usuários, dispositivos e aplicativos, a solução de problemas de conectividade e aplicação de políticas se tornou mais complexa. Ao contrário dos modelos tradicionais baseados em perímetro, a ZTA conta com várias decisões em tempo real em identidade, postura de dispositivo, contexto de rede e mecanismos de política baseados em nuvem. Quando surgem problemas, os registros de alto nível geralmente são insuficientes para identificar a causa raiz.

A coleta de rastreamento detalhado do nível ZTA desempenha um papel fundamental na obtenção de visibilidade profunda do comportamento do cliente, avaliação de políticas, interceptação de tráfego e interações de serviços em nuvem. Esses rastreamentos permitem que os engenheiros vão além da solução de problemas baseada em sintomas e analisem a sequência exata de eventos que levam a falhas de acesso, degradação de desempenho ou resultados inesperados de políticas. 

Coletando logs

Pré-verificações antes da abertura de um caso de TAC

Essas pré-verificações ajudam a equipe do TAC a identificar o problema com mais eficiência. Fornecer essas informações aos engenheiros ajuda a resolver o problema o mais rápido possível:

• Qual é o problema e quantos usuários são afetados?

• Quais sistemas operacionais e versões são afetados?

• O problema é consistente ou intermitente? Em caso de intermitência, é específico do usuário ou está difundido?

• O problema começou após uma alteração ou está presente desde a implantação?

• Há algum gatilho conhecido?

• Há uma solução alternativa disponível?

Registros a serem coletados

• pacote DART

• Logs do modo de rastreamento de depuração ZTNA

• Captura Wireshark (todas as interfaces, incluindo loopback)

• Mensagens de erro observadas

• Carimbos de data/hora da emissão

• Captura de tela de status do módulo ZTA do CSC

• Nome do usuário afetado

As próximas seções explicam como ativar e coletar cada um desses logs em detalhes.

Habilitar Modo de Rastreamento de Depuração ZTNA

Crie um arquivo chamado logconfig.json com estes detalhes abaixo:

{ "global": "DBG_TRACE" }

Depois de criar o arquivo, coloque-o no local apropriado com base no sistema operacional:

• Windows: C:\ProgramData\Cisco\Cisco Secure Client\ZTA

• MacOS:/opt/cisco/secureclient/zta

Aumentar o tamanho do log ZTA no Visualizador de Eventos

Windows

• UseWindows + Rpara abrir a Run Search gravação services.msc e pressione enter.
• Localize o serviço Cisco Secure Client - Zero trust Access Agent e clique em Restart. Depois de concluir, verifique o status do módulo ZTA do CSC para confirmar se ele está ativo.

MacOS

Stop Service.

sudo "/opt/cisco/secureclient/zta/bin/Cisco Secure Client - Zero Trust Access.app/Contents/MacOS/Cisco Secure Client - Zero Trust Access" uninstall

Start Service.

open -a "/opt/cisco/secureclient/zta/bin/Cisco Secure Client - Zero Trust Access.app"

Habilitar log KDF, captura de pacotes, modo de depuração Duo e pacote Dart

Windows 

Abra um CMD com privilégios de administrador e execute o próximo comando:

"%ProgramFiles(x86)%\Cisco\Cisco Secure Client\acsocktool.exe" -sdf 0x400080152

• Baixe DebugView de SysInternal para capturar o log KDF.
• Execute DebugViewcomo administratore ative as próximas opções de menu:
• Clique em Capturar.
  • Marca de seleção Capture Kernel.
  • Marca de seleção  Enable Verbose Kernel Output.
• Opções
  • Marca de seleção  Clock Time.
  • Marca de seleção Show Milliseconds.

• Reinicie o serviço do cliente através do prompt do administrador:

net stop csc_vpnagent && net start csc_vpnagent

• Se net stop csc_vpnagent && net start csc_vpnagentnão funcionar, reinicie o Cisco Secure Clientserviço do services.msc.

• Ative o Duo no modo de depuração 

• Iniciar Wireshark Capture.

• Selecione todas as interfaces e inicie a captura de pacotes.

• Reproduza o problema, salve KDF LogsWireshark Capturee siga as etapas para capturar DART Bundle.
• Abra o Cisco Secure Client Diagnostics & Reporting Tool (DART)com privilégios de administrador.

• Clique em Custom.
  • Incluir System Information Extensivee Network Connectivity Test.

• Para parar o registro KDF no Windows, use o próximo comando: 

"%ProgramFiles(x86)%\Cisco\Cisco Secure Client\acsocktool.exe" -cdf

Comandos do Windows Powershell para habilitar e desabilitar, ele deve ser executado como administrador:

#Enable ZTNA Logs
New-Item -Path "C:\ProgramData\Cisco\Cisco Secure Client\ZTA\logconfig.json" -ItemType "file" -Value '{"global" : "DBG_TRACE"}'
Limit-EventLog -LogName "Cisco Secure Client - Zero Trust Access" -MaximumSize 2240000KB
& "C:\Program Files (x86)\Cisco\Cisco Secure Client\acsocktool.exe" -sdf 0x400080152
Restart-Service csc_vpnagent
Restart-Service csc_zta_agent

#Disable ZTNA Logs
Remove-Item -Path "C:\ProgramData\Cisco\Cisco Secure Client\ZTA\logconfig.json" 
Limit-EventLog -LogName "Cisco Secure Client - Zero Trust Access" -MaximumSize 6400KB
& "C:\Program Files (x86)\Cisco\Cisco Secure Client\acsocktool.exe" -cdf 0x400080152
Restart-Service csc_vpnagent
Restart-Service csc_zta_agent

MacOS

Abra o terminal e siga a próxima cadeia de comandos para ativar o registro KDF no MacOS:

• Stop Service.

sudo "/opt/cisco/secureclient/bin/Cisco Secure Client - AnyConnect VPN Service.app/Contents/MacOS/Cisco Secure Client - AnyConnect VPN Service" uninstall

• Enable Flag.

echo debug=0x400080152 | sudo tee /opt/cisco/secureclient/kdf/acsock.cfg

• Start Service.

open -a "/opt/cisco/secureclient/bin/Cisco Secure Client - AnyConnect VPN Service.app"

• Ative Duo no modo de depuração.

• Iniciar Wireshark Capture.

• Selecione todas as interfaces e inicie a captura de pacotes.

• Reproduza o problema, salve KDF LogsWireshark Capturee siga as etapas para capturar DART Bundle.
• Abra o Cisco Secure Client - DART.

• Marque as próximas opções:
  • Include Legacy - Cisco AnyConnect Secure Mobility Client Logs.
  • Include System Logs.
• Clique em  Run.

Informações Relacionadas

• Suporte técnico e downloads da Cisco
• Central de ajuda do Cisco Secure Access
• Guia de design do Cisco SASE
• Coletando registros KDF para cliente seguro no Windows e MacOS

Histórico de revisões

Revisão	Data de publicação	Comentários
2.0	30-Mar-2026	Texto Alt e Formatação Atualizados.
1.0	31-Dec-2025	Versão inicial