Citrix Virtual Apps and Desktops

Carregando os logs AOT dos Componentes Principais do CVAD

January 23, 2026

Contribuição de:

A partir do CVAD 2507 CU1 e CVAD 2511, os logs AOT são coletados de todos os componentes aplicáveis. Os componentes suportados incluem DDC, StoreFront, Citrix Director, Windows VDA, Linux VDA, Mac VDA, License Server, FAS, Cloud Connector, PVS, WEM, Session Recording, Citrix Workspace UI e Citrix Gateway.

Observação:

Todos os logs do cliente CWA serão disponibilizados em um lançamento específico. Consulte a seção para atualizações em tempo real.

Configuração centralizada de encaminhamento de log via Citrix Web Studio

O Citrix Web Studio oferece um local centralizado para configurar o encaminhamento de logs Always-on Tracing (AOT) em todo o site. Essa configuração define para onde os logs AOT são enviados e propaga automaticamente a configuração para os componentes relevantes no ambiente.

Ao configurar o servidor de log no Web Studio:

A configuração é gravada no banco de dados do Site.
Os Delivery Controllers recuperam as configurações atualizadas e as distribuem para os VDAs nos grupos de entrega selecionados.
Os VDAs usam a configuração recebida para encaminhar seus logs AOT para o servidor de log especificado.
O StoreFront que participa do registro AOT recebe os detalhes necessários por meio do mesmo mecanismo centralizado.
O Director usa a AuthKey e os detalhes do servidor de log fornecidos para consultar e exibir os logs AOT para monitoramento e solução de problemas.

Essa abordagem centralizada elimina a necessidade de configurar cada componente individualmente. Você configura os detalhes do servidor de log uma vez no Web Studio, e o Citrix propaga automaticamente a configuração por todo o site.

Abaixo está a lista de componentes que receberão os detalhes do servidor de log assim que ele for configurado no Web Studio:

Citrix Director/Monitor
Citrix Delivery Controller
Windows VDA
Linux VDA
Mac VDA
StoreFront
Session Recording Agent
CWAs

Para configurar as definições do servidor de log para ambientes locais

AOT Log Server Settings

Faça login no Web Studio e selecione “Settings” no painel esquerdo.
No bloco “Log server”, selecione “Add” se nenhum servidor de log estiver configurado.
Na página “Log server”, ative “Enable log forwarding to log server”.
Insira o “Log server address” e a “Port”. Os VDAs e Delivery Controllers usam essas informações para encaminhar os logs AOT.
Escolha quais componentes encaminham logs:
1. “Include Delivery Controllers”: Envia logs AOT de todos os Delivery Controllers.
2. “Select delivery groups”: Envia logs de VDAs em grupos de entrega selecionados.
  - “All delivery groups”: Envia logs de todos os VDAs.
  - “Select specific delivery groups”: Escolha grupos de entrega individuais para incluir.
Insira a AuthKey gerada no servidor de log. O Director usa essa chave para autenticar e recuperar logs.
Selecione “Save” para aplicar a configuração.

Para editar uma configuração existente

Para atualizar o servidor de log ou modificar o escopo do registro, vá para “Settings” > “Log server” e selecione “Edit”.

Para configurar as definições do servidor de log para o ambiente Citrix DaaS/Cloud

AOT Log Server Settings 1

O Citrix Web Studio para DaaS oferece um local centralizado para configurar o encaminhamento de logs Always-on Tracing (AOT) para sites gerenciados na nuvem. Essa configuração determina para onde os logs AOT são enviados e controla quais VDAs participam do encaminhamento de logs. O Monitor usa essas configurações para recuperar e exibir logs para solução de problemas.

Faça login no Web Studio e selecione “Settings” no painel esquerdo.
No bloco “Log server”, selecione “Add” se nenhum servidor de log estiver configurado no momento.
Na página “Log server”, insira o “Log server address” e a “Port”. Os VDAs usam essas informações para encaminhar os logs AOT para o servidor.
Defina quais VDAs encaminham logs:
1. Selecione “Select delivery groups” para controlar o escopo.
2. “All delivery groups” (padrão) encaminha logs de todos os VDAs no site.
3. Para direcionar VDAs específicos, selecione “Select specific delivery groups” e escolha os grupos de entrega que deseja incluir.
Selecione a Zona (local do recurso) onde o servidor de log está implantado.
Insira a Authkey gerada pelo servidor de log. O Monitor usa essa chave para autenticar e recuperar logs para exibição.
Selecione “Save” para aplicar a configuração.

Configuração de encaminhamento de log para outros componentes

Configurar o upload de logs AOT para o Session Recording Server

Você pode configurar o Session Recording Server para carregar logs AOT para um servidor de log central executando o seguinte comando PowerShell na máquina do Session Recording Server:

#Enable - run following command in Session Recording Server PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role SessionRecording

#Disable - run following command in Session Recording Server PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

Configurar o upload de logs AOT para o FAS

Você pode configurar o FAS para carregar logs AOT para um servidor de log central executando o seguinte comando PowerShell no FAS Server:

#Enable - run following command in FAS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role FAS

#Disable - run following command in FAS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

Configurar o upload de logs AOT para o PVS

Você pode configurar o PVS para carregar logs AOT para um servidor de log central executando o seguinte comando PowerShell no PVS Server:

#Enable - run following command in PVS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role PVS

#Disable - run following command in PVS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

Observação:

Se você tiver vários servidores PVS, execute o comando para habilitar ou desabilitar o upload de logs AOT em cada um.

Carregando logs AOT para o License Server

A URL do Logserver precisa ser atualizada dentro do arquivo de configuração SLS, que pode ser encontrado no local “C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml” com a tag XML “AotServerURL”.

Exemplo:

<AotServerURL>https://10.110.249.168:8443/ctxlogserver/UploadCitrixLogStream</AotServerURL>
<!--NeedCopy-->

O License Server carrega periodicamente os logs para o servidor AOT automaticamente.

Configurar o upload de logs AOT para o Citrix Connector para Windows

A URL do Logserver é sincronizada automaticamente do Citrix Cloud. Nenhuma ação é necessária.

Configurar o upload de logs AOT para aplicativos Citrix Workspace

O Citrix capacita os clientes do aplicativo Citrix Workspace a carregar automaticamente logs de diagnóstico para o servidor de log centralizado. Essa capacidade aprimora a eficiência da solução de problemas, fornecendo aos administradores acesso imediato a informações de diagnóstico do lado do cliente sem exigir a coleta manual de logs. Os AOTs do lado do cliente serão carregados automaticamente e isso é acionado quando o recurso AOT é habilitado em todo o ambiente CVAD e quando o usuário inicia um recurso.

Requisitos do sistema

Citrix Virtual Apps and Desktops 2511 ou CVAD 2507 CU1 e versões posteriores
Citrix Workspace app 2511 ou CWA 2507.1 CU1 e versões posteriores

Plataforma Cliente	Versão Mínima	Matriz Suportada
CWA para Windows	CWA 2507.1 CU1, 2511	Acesso Direto via Storefront (local)
CWA para HTML5	CWA 2511	Acesso Direto via Storefront (local)
CWA para Chrome OS	CWA 2511	Acesso Direto via Storefront (local)

Configurar o upload de logs AOT para o NetScaler

Acesse o NetScaler CLI via SSH e, em seguida, entre no shell do NetScaler executando o comando “shell”.
Vá para o diretório /var/analytics_conf
```
cd /var/analytics_conf

```
Gere o arquivo de esquema executando um script python interativo “python {Add script name}”. O arquivo de esquema define os cabeçalhos HTTP (Auth-token, User-Agent etc) e os atributos de Payload (Role, Machine IP etc).

Trecho da saída gerada por este script

root@Raju-adc2# python schema_generator_for_syslog_final.py 
Schema Builder: Follow the prompts to define your schema. 
Include 'Auth-Token'? (Y/n):  
Enter the display name (alias) for 'Auth-Token' (press Enter to keep as is): Authkey 
'Auth-Token' can only go in 'header'. Automatically selected. 
Include 'HostName'? (Y/n): n 
Include 'Content-type'? (Y/n): y 
Enter the display name (alias) for 'Content-type' (press Enter to keep as is): 
'Content-type' can only go in 'header'. Automatically selected. 
Default value for 'Content-type' is 'application/json'.  
Do you want to change it? (y/N):  
Include 'User-agent'? (Y/n):  
Enter the display name (alias) for 'User-agent' (press Enter to keep as is): 
'User-agent' can only go in 'header'. Automatically selected. 
Default value for 'User-agent' is 'AUDITLOGS/1.0'.  
Do you want to change it? (y/N):  
Include 'Role'? (Y/n): y  
Enter the display name (alias) for 'Role' (press Enter to keep as is):  
Where should 'Role' be included? (HEADER/payload): HEADER  
Default value for 'Role' is 'GW'.  
Do you want to change it? (y/N): y  
Enter new default value for 'Role': Gateway  
<!--NeedCopy-->

Exemplo de arquivo de esquema gerado

{ 
     "Header": { 
         "Auth-Token": { 
             "name": "AuthKey" 
         }, 
         "Content-type": { 
             "name": "Content-type", 
             "value": "application/json" 
         }, 
         "User-agent": { 
             "name": "User-agent", 
             "value": "AUDITLOGS/1.0" 
         }, 
         "Role": { 
             "name": "Role", 
             "value": "Gateway" 
         }, 
         "MachineIP": { 
             "name": "MachineIP" 
         }, 
         "MachineName": { 
             "name": "MachineName" 
         } 
     }, 
     "Payload": { 
         "LogLevel": "Level", 
         "MessageContent": "Message", 
         "ModuleName": "Module", 
         "Time": "TimeStamp" 
     }, 
     "Format": { 
         "delimiter": "" 
     } 
 }
<!--NeedCopy-->

Saia do shell e retorne ao NetScaler CLI.
Crie uma Syslog Action que define o Syslog Server, as Portas e o arquivo de esquema (criado na etapa anterior) etc.

add audit syslogAction {Action Name} {AOT Server IP/FQDN} -serverPort {Destination Port} -logLevel {Log Level} -transport HTTP -httpAuthToken {Authentication Token generated on the AOT sever} -httpEndpointUrl {AOT Server URL where logs will be sent} -httpSchemaFile {Schema File created in Previous Step}
<!--NeedCopy-->

Exemplo:

add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
<!--NeedCopy-->

Vincule a syslogAction à Audit Syslog Policy.

add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

Exemplo:

add audit syslogPolicy pol1 true act1
<!--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

Configuração centralizada de encaminhamento de log via Citrix Web Studio
Configuração de encaminhamento de log para outros componentes

Isso foi útil?