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

Carregando os logs AOT dos Componentes Principais do CVAD

April 27, 2026
Contribuição de: 
C C

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 o 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 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 o ambiente local

AOT Log Server Settings

  1. Faça login no Web Studio e selecione “Configurações” no painel esquerdo.
  2. No bloco “Servidor de log”, selecione “Adicionar” se nenhum servidor de log estiver configurado.
  3. Na página “Servidor de log”, ative “Habilitar encaminhamento de log para o servidor de log”.
  4. Insira o “Endereço do servidor de log” e a “Porta”. Os VDAs e Delivery Controllers usam essas informações para encaminhar os logs AOT.

  5. Escolha quais componentes encaminham logs:

    1. Incluir Delivery Controllers: Envia logs AOT de todos os Delivery Controllers.

    2. Selecionar grupos de entrega: Envia logs de VDAs em grupos de entrega selecionados.

      • Todos os grupos de entrega: Envia logs de todos os VDAs.
      • Selecionar grupos de entrega específicos: Escolha grupos de entrega individuais para incluir.
  6. Insira o AuthKey gerado no servidor de log. O Director usa essa chave para autenticar e recuperar logs.
  7. Selecione “Salvar” para aplicar a configuração.

Para editar uma configuração existente

Para atualizar o servidor de log ou modificar o escopo de registro, vá para “Configurações” > “Servidor de log” e selecione “Editar”.

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.

  1. Faça login no Web Studio e selecione “Configurações” no painel esquerdo.
  2. No bloco “Servidor de log”, selecione “Adicionar” se nenhum servidor de log estiver configurado no momento.
  3. Na página “Servidor de log”, insira o “Endereço do servidor de log” e a “Porta”. Os VDAs usam essas informações para encaminhar os logs AOT para o servidor.

  4. Defina quais VDAs encaminham logs:

    1. Selecione “Selecionar grupos de entrega” para controlar o escopo.
    2. “Todos os grupos de entrega” (padrão) encaminha logs de todos os VDAs no site.
    3. Para direcionar VDAs específicos, selecione “Selecionar grupos de entrega específicos” e escolha os grupos de entrega que deseja incluir.
  5. Selecione a Zona (localização do recurso) onde o servidor de log está implantado.
  6. Insira o Authkey gerado pelo servidor de log. O Monitor usa essa chave para autenticar e recuperar logs para exibição.
  7. Selecione “Salvar” 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 os uploads de log 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 for 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 permite que os clientes do aplicativo Citrix Workspace carreguem 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 às 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
<!--NeedCopy-->
  • 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 Ação de syslog que define o Syslog Server, 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 à Política de Syslog de Auditoria
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

Exemplo:

add audit syslogPolicy pol1 true act1
<!--NeedCopy-->
Carregando os logs AOT dos Componentes Principais do CVAD
April 27, 2026
Contribuição de: 
C C
April 27, 2026
Contribuição de: 
C 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.