Citrix Virtual Apps and Desktops

Carregando os logs AOT dos Componentes Principais do CVAD

January 23, 2026

Contribuição de:

Se você configurou o servidor de log no modo HTTPS https://<LogServerFQDN>:port, certifique-se de que o certificado necessário esteja corretamente instalado e confiável em seu sistema.

Carregando logs AOT do Storefront™

#Habilitar upload em HTTP

Set-STFDiagnosticsLogServer -Server LogServerFQDN:8080

#Ou para usar HTTPS

Set-STFDiagnosticsLogServer -Server https://LogServerFQDN:8443

#Desabilitar

Clear-STFDiagnosticsLogServer

#A configuração entrará em vigor em uma hora. Para aplicar as alterações imediatamente, reinicie o Serviço de Telemetria Citrix.
<!--NeedCopy-->

Carregando logs AOT do DDC:

#Habilitar upload em HTTP
Set-ConfigSite -LogServerEnabled $true -LogServerName LogServerFQDN -LogServerPort 8080

#Ou habilitar HTTPS
Set-ConfigSite -LogServerEnabled $true -LogServerName https://LogServerFQDN -LogServerPort 8443
#Desabilitar HTTP
Set-ConfigSite -LogServerEnabled $false -LogServerName LogServerFQDN -LogServerPort 8080
#Desabilitar HTTPS
Set-ConfigSite -LogServerEnabled $false -LogServerName https://LogServerFQDN -LogServerPort 8443
<!--NeedCopy-->

Habilitar AOT no VDA Windows:

Na máquina onde você instalou o DDC, execute os comandos abaixo e, depois disso, você precisa reiniciar o Serviço de Área de Trabalho Citrix para que as alterações entrem em vigor imediatamente.

```bash
#Iniciar, execute os seguintes comandos no PowerShell do DDC
$configSlot = New-BrokerConfigurationSlot -Name VdaAotTracing -Description VdaAotTracing -SettingsGroup G=Telemetry


#Se estiver usando HTTPS, o parâmetro de -Endpoint deve ser "https://logserverFQDN:8443"
$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "logserverFQDN:8080"
$mc = New-BrokerMachineConfiguration -ConfigurationSlotUid $configSlot.Uid -LeafName VdaAotTracing -Policy $policy


# Usando o DeliverygroupName real do seu VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"  
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg


#Reinicie o Serviço de Área de Trabalho Citrix em seu VDA para que as alterações entrem em vigor imediatamente.
<!--NeedCopy--> ```

Atualizar quando o endereço ou a porta do servidor de log for alterado(a):

```bash
#Atualizar, execute os seguintes comandos no PowerShell do DDC
#Se estiver usando HTTPS, o parâmetro de -Endpoint deve ser "https://NewLogServerFQDN:8443"


$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "NewLogServerFQDN:8443"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"

# Usando o DeliverygroupName real do seu VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg
#Reinicie o Serviço de Área de Trabalho Citrix em seu VDA para que as alterações entrem em vigor imediatamente.
<!--NeedCopy--> ```

Como desabilitar:

```bash
#Desabilitar, execute os seguintes comandos no PowerShell do DDC


#Se estiver usando HTTPS, o parâmetro de -Endpoint deve ser "https://LogServerFQDN:8443"
$policy = New-BrokerLogServerAddress -Enabled $false -Endpoint "LogServerFQDN:8080"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"

# Usando o DeliverygroupName real do seu VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName" 
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg

#Reinicie o Serviço de Área de Trabalho Citrix em seu VDA para que as alterações entrem em vigor imediatamente.

<!--NeedCopy--> ```

Habilitar AOT diretamente no VDA Windows:

Execute o comando diretamente na máquina (VDA Windows) onde você deseja carregar o AOT. Isso só terá efeito na máquina onde o comando é aplicado.

```bash
# Habilitar upload de AOT para VDA Windows
#Se estiver usando HTTPS, o parâmetro de -AotDataStoreEndpoint deve ser "https://LogServerFQDN:8443"

Enable-CitrixAOTUpload -AotDataStoreEndpoint LogServerFQDN:8443 -Role WVDA

# Desabilitar upload de AOT
Disable-CitrixAOTUpload
<!--NeedCopy--> ```

Visualizando e Usando Logs AOT

Acessando Logs via Servidor de Log

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 de função/nome 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.

Para Linux
./GetAuthKey.sh role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}

Para Windows
GetAuthKey.bat role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}

#Salve a chave: ebac9b7726cb4be597c92c6769134d25 por conta própria. É a única maneira de obter a chave.
<!--NeedCopy-->

Liste os nomes das máquinas que já enviaram seus logs AOT para o servidor de log:

```bash
#O parâmetro é a chave obtida de GetAuthKey.sh
Para Linux:
./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Máquinas vazias significa que não há log

Para Windows:
ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Máquinas vazias significa que não há log
<!--NeedCopy--> ```

Baixe os logs por nome da máquina e intervalo de tempo. A hora está no formato UTC.

```bash
#Uso: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime] [EndTime] [OutputFile]
#Exemplo: 

Para Linux
./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv

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

Baixe os logs por filtro de palavra(s)-chave. A hora 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.

```bash
#Uso: ./DownloadLogsByWords.sh [AuthKey] [StartTime] [EndTime] [SearchWords] [OutputFile]

#Exemplo:
Para Linux:
./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv

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

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?

Carregando os logs AOT dos Componentes Principais do CVAD

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Neste artigo

Visualizando e Usando Logs AOT

Isso foi útil?