Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Visualizando e Usando Logs AOT

January 23, 2026
Contribuição de: 
C

Acessando Logs via UI do Director

Etapa 1

Edite o arquivo StartLogServer.bat

O arquivo StartLogServer.bat contém todos os parâmetros de configuração usados para iniciar o contêiner do AOT Log Server, incluindo várias variáveis de ambiente que controlam o acesso e o comportamento do log. Uma das configurações principais é LOCAL_DOWN_ONLY.

  • Quando LOCAL_DOWN_ONLY=false, o Log Server aceita solicitações remotas de visualização de log. Isso permite que o Citrix Director/Monitor se conecte ao Log Server e exiba os logs AOT diretamente na UI do Monitor.

  • Quando LOCAL_DOWN_ONLY=true, o Log Server restringe o acesso ao log a conexões somente locais. Neste modo, você deve se conectar diretamente à máquina do Log Server para visualizar os logs, e o Citrix Director Monitor não conseguirá recuperar ou exibir os logs.

Arquivo bat AOT

Etapa 2

O Web Studio oferece uma configuração dedicada que permite ao Citrix Director conectar-se ao AOT Log Server e exibir logs no console do Monitor. Uma vez que as configurações do Web Studio são salvas, os Delivery Controllers atualizam a configuração do site, e o Director recebe os detalhes do servidor de log, incluindo o endereço, a porta e a chave de autenticação do servidor de log. O Director usa essas configurações para estabelecer uma conexão segura com o Log Server.

Etapa 3

Após a configuração:

  1. Abra o Citrix Director.
  2. Uma nova opção Logs aparece no painel de navegação esquerdo.
  3. Selecione Logs e você verá a página “Introdução”, clique em “Fechar” para ignorá-la, pois já concluímos essas configurações anteriormente.
  4. Agora, você verá o Director recuperando e exibindo logs AOT diretamente do Log Server.

Citrix Director

A página Logs no Director oferece uma visão unificada dos eventos AOT de Delivery Controllers, VDAs, servidores StoreFront e outros componentes Citrix. Você pode pesquisar, filtrar e inspecionar logs em tempo real para solucionar problemas rapidamente.

Pesquisa de texto livre: Na parte superior da página Logs, você encontrará uma barra de pesquisa de texto livre. Você pode digitar qualquer palavra-chave para começar a refinar os resultados. A pesquisa atualiza os resultados instantaneamente assim que você aplica os filtros. Exemplos incluem:

  • Nomes de usuário
  • Nomes de máquina
  • Palavras-chave de evento (por exemplo, registro, autenticação, STA)
  • IDs de transação
  • Mensagens de erro ou strings parciais

Filtro de tempo: Use o seletor de tempo (por exemplo, Últimos 5 minutos, Última 1 hora, Últimas 24 horas) para visualizar logs gerados dentro de uma duração específica. Isso ajuda você a isolar rapidamente eventos em torno do momento exato em que um problema ocorreu.

Filtro de categoria: O campo Categoria permite filtrar logs com base no tipo de evento ou subsistema. Isso ajuda você a focar em logs relacionados a Inicialização de aplicativo, Registro, configuração de VDA, Gráficos, HDX Direct, conexão ICA, etc.

Filtro de classe de log: O filtro Classe de Log agrupa logs por severidade ou tipo de evento. Isso permite que você se concentre apenas em erros ou eventos importantes ao solucionar problemas. As classes comuns incluem:

  • Informação
  • Aviso
  • Erro
  • Falha

Filtro de nome de host: O filtro Nome de Host permite selecionar uma máquina específica — como um VDA, Delivery Controller, CWA ou servidor StoreFront. Isso é útil quando você deseja detalhar os logs de um único endpoint ou VM em vez de pesquisar em toda a implantação.

Este acesso centralizado simplifica a solução de problemas, permitindo a recuperação e análise rápidas de logs a partir de um único console. Saiba mais sobre os pré-requisitos e como começar em Director - Logs.

Acessando Logs via Log Server

O conteúdo a seguir é Gerar o AuthKey. Para habilitar o acesso aos logs, o usuário precisa:

  1. Modificar o script StartLogServer.bat para LOCAL_DOWN_ONLY=false

  2. Gerar o AuthKey

Para manter seus logs seguros, você precisará de um AuthKey antes de baixá-los. Veja o que fazer:

  1. Obtenha seu AuthKey – Use seu próprio nome de função/nome para gerá-lo.
  2. Execute localmente – Os scripts só podem ser executados na máquina onde o contêiner Docker está instalado.
  3. Usuários Windows – Use os scripts GetAuthKey.bat em vez de scripts shell.
  4. Baixe os logs – Uma vez autenticado, você pode recuperar seus logs com segurança.

Gerar o AuthKey

Para Linux 

./GetAuthKey.sh role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Para Windows 

GetAuthKey.bat role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Salve a chave: ebac9b7726cb4be597c92c6769134d25 por conta própria. É a única maneira de obter a chave.

Listar nomes de máquinas que já enviaram seus logs AOT para o logserver

O parâmetro é a chave obtida de GetAuthKey.sh

Para Linux 

./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Máquinas vazias significa que não há log.

Para Windows 

ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Para Windows PowerShell quando o LogServer inicia com “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/ListMachine" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" }
<!--NeedCopy-->

Substitua logserver_fqdn pelo FQDN real do logserver e 8443 pela porta real do logserver. Substitua https por http quando instalado no modo http.

Máquinas vazias significa que não há log.

Baixar logs por nome de máquina e intervalo de tempo.

O tempo está no formato UTC: AAAA-mm-ddTHH:MM:SSZ.

#Usage: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [OutputFile]
#Example:
<!--NeedCopy-->

Para Linux 

./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy-->

Para Windows 

DownloadLogsByTime.bat ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy-->

Para Windows PowerShell quando o LogServer inicia com “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/TimeRange?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

Baixar logs por filtro de palavra(s)-chave. O tempo está no formato UTC

Observação:

  • Uma palavra-chave pode ser uma única palavra ou uma combinação de palavras.
  • As palavras-chave podem corresponder a qualquer parte da mensagem de log.
  • Um ID de Transação também pode ser usado como palavra-chave.
#Usage: ./DownloadLogsByWords.sh [AuthKey] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [SearchWords] [OutputFile]
#Example:
<!--NeedCopy-->

Para Linux 

./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv
<!--NeedCopy-->

Para Windows 

DownloadLogsByWords.bat authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "failed vda" logs.csv
<!--NeedCopy-->

Para Windows PowerShell quando o LogServer inicia com “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/SearchLog?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z&words=failed vda" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

As palavras são separadas por espaço.

Visualizando e Usando Logs AOT
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.