Documentação de produtos
Citrix Virtual Apps and Desktops™ 7 2507 LTSR
Ver PDF

Carregamento dos logs AOT dos Componentes Principais do CVAD

June 5, 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.

Configuração centralizada de encaminhamento de log via Citrix Web Studio para CVAD no local

O Citrix Web Studio fornece um local centralizado para configurar o encaminhamento de log do 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 através do mesmo mecanismo centralizado.
  • O Director usa o AuthKey fornecido e os detalhes do servidor de log para consultar e exibir 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 a 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
  • VDA Linux
  • VDA Mac
  • StoreFront
  • Agente de Gravação de Sessão
  • CWAs

Para configurar as definições do servidor de log para o ambiente local

Configurações do Servidor de Log AOT

  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. VDAs e Delivery Controllers usam essas informações para encaminhar logs AOT.

    Nota:

    1. Se você estiver usando o Citrix Connector Appliance para implantar o Servidor de Log, certifique-se de que apenas a porta 443 esteja configurada.

    2. A atualização do endereço e da porta do Servidor de Log no Citrix Studio funciona inicialmente, mas se você revisitar as configurações e modificar os detalhes do Servidor de Log sem reinserir a chave de autenticação, o espaço reservado da chave de autenticação ficará vazio após salvar, mesmo que a operação pareça bem-sucedida. Isso resulta em configuração ausente ou inválida no Director e no Monitor. Como solução alternativa, sempre reinsira e valide a chave de autenticação ao modificar as configurações do Servidor de Log até que esse problema seja resolvido.

  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 a AuthKey gerada no servidor de log. O dDirector usa esta 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 log, vá para Configurações > Servidor de log e selecione Editar.

Configurar as definições do servidor de log para o ambiente Citrix DaaS/Cloud através das definições do DaaS

O Always On Tracing (AOT) é suportado tanto para implantações locais (CVAD) quanto para Citrix DaaS (nuvem). No entanto, o comportamento da coleta de logs difere com base em onde os componentes estão hospedados.

Após instalar e configurar o Servidor de Log AOT (no Linux, Windows ou Connector Appliance), conclua o seguinte para habilitar o encaminhamento de log para o Servidor de Log nas configurações do Citrix DaaS para implantações em nuvem:

Configurações do Servidor de Log AOT 1

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

  1. Faça login no Web Studio para DaaS (Configurações do DaaS) e selecione Configurações no painel esquerdo.
  2. No bloco Servidor de log, selecione Adicionar se nenhum servidor de log estiver configurado atualmente.
  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 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 você deseja incluir.

    Nota:

    Se você estiver usando o Citrix Connector Appliance para implantar o Servidor de Log, certifique-se de que apenas a porta 443 esteja configurada.

  5. Selecione a Zona (localização do recurso) onde o servidor de log está implantado.
  6. Insira a Authkey gerada 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 Servidor de Gravação de Sessão

Você pode configurar o Servidor de Gravação de Sessão para carregar logs AOT para um servidor de log central executando o seguinte comando PowerShell na máquina do Servidor de Gravação de Sessão:

#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 FAS

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

#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 PVS

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

#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 uploads de log AOT em cada um.

Upload de logs AOT para o Servidor de Licenças

  • 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 Servidor de Licenças carrega os logs para o servidor AOT periodicamente e automaticamente.

Configurar o upload de logs AOT para o Citrix Connector

Para coletar logs do Cloud Connector no Servidor de Logs AOT, aplicam-se os seguintes requisitos:

  • O Cloud Connector deve estar na versão 6.157.0.19398 ou posterior.

  • Em implantações de DDC na nuvem, os detalhes de configuração do Servidor de Logs são sincronizados automaticamente com o registro com a versão de maio (DDC 128), e nenhuma configuração manual é necessária

  • Em implantações híbridas (DDC local), é necessária a configuração manual do registro para habilitar a coleta de logs. Crie as seguintes entradas de registro na máquina do Cloud Connector:

Caminho: HKLM\Software\Citrix\ConfigSyncService

Entradas:

  • LogServerEnabled (REG_DWORD) = 1

  • LogServerEndpoint (REG_SZ) = <https://<logserver-fqdn>:<port>>

Configurar o upload de logs AOT para aplicativos Citrix Workspace

A 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 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 está 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
  • Certifique-se de que a versão necessária do aplicativo Citrix Workspace (CWA) selecionado esteja instalada. Para obter mais informações, consulte Versões suportadas

Configurar o upload de logs AOT para NetScaler

  • Conecte-se via SSH ao NetScaler CLI 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 {auditlog_schema_generator_for_hec_export.py}”. O arquivo de esquema define os cabeçalhos HTTP (Auth-token, User-Agent etc) e os atributos de carga útil (Role, Machine IP etc).

Trecho da saída gerada por este script 

root@Raju-adc2# python auditlog_schema_generator_for_hec_export.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-->

Arquivo de esquema de exemplo 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 Servidor Syslog, 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 à 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-->
Carregamento dos logs AOT dos Componentes Principais do CVAD
June 5, 2026
Contribuição de: 
C C
June 5, 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.