Citrix Virtual Apps and Desktops

Visualizando e Usando Logs AOT

April 27, 2026

Contribuição de:

C C

Acessando Logs via Interface do Usuário 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 Servidor de Logs AOT, incluindo várias variáveis de ambiente que controlam o acesso e o comportamento dos logs. Uma das configurações principais é LOCAL_DOWN_ONLY.

Quando LOCAL_DOWN_ONLY=false, o Servidor de Logs aceita solicitações remotas de visualização de logs. Isso permite que o Citrix Director/Monitor se conecte ao Servidor de Logs e exiba os logs AOT diretamente na interface do usuário do Monitor.
Quando LOCAL_DOWN_ONLY=true, o Servidor de Logs restringe o acesso aos logs apenas a conexões locais. Nesse modo, você deve se conectar diretamente à máquina do Servidor de Logs para visualizar os logs, e o Citrix Director Monitor não poderá 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 Servidor de Logs AOT e exibir os 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 logs, incluindo o endereço, a porta e a chave de autenticação do servidor de logs. O Director usa essas configurações para estabelecer uma conexão segura com o Servidor de Logs.

Etapa 3

Após a configuração:

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

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 cadeias de caracteres 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 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 se concentrar 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 os logs por gravidade 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 Servidor de Logs

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

Modificar o script StartLogServer.bat para LOCAL_DOWN_ONLY=false
Gerar a AuthKey

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

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

Gerar a 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. É a única maneira de obter a chave.

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

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á logs.

Para Windows

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

Para Windows PowerShell quando o Servidor de Logs 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 servidor de logs e 8443 pela porta real do servidor de logs. Substitua https por http quando instalado no modo http.

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

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

O tempo está no formato UTC: YYYY-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 Servidor de Logs 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 Servidor de Logs 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.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Visualizando e Usando Logs AOT

April 27, 2026

Contribuição de:

C C

April 27, 2026

Contribuição de:

C C

Neste artigo

Acessando Logs via Interface do Usuário do Director
Acessando Logs via Servidor de Logs

Isso foi útil?