Citrix Virtual Apps and Desktops

Carga de los registros AOT de los componentes principales de CVAD

A partir de CVAD 2507 CU1 y CVAD 2511, los registros AOT se recopilan de todos los componentes aplicables. Los componentes compatibles incluyen DDC, StoreFront, Citrix Director, VDA de Windows, VDA de Linux, VDA de Mac, Servidor de licencias, FAS, Cloud Connector, PVS, WEM, Grabación de sesiones, Interfaz de usuario de Citrix Workspace y Citrix Gateway.

Configuración centralizada del reenvío de registros mediante Citrix Web Studio

  • Citrix Web Studio proporciona una ubicación centralizada para configurar el reenvío de registros de Always-on Tracing (AOT) en todo el sitio. Esta configuración define dónde se envían los registros AOT y propaga automáticamente la configuración a los componentes relevantes del entorno.

  • Cuando configuras el servidor de registros en Web Studio:

  • La configuración se escribe en la base de datos del sitio.
  • Los Delivery Controllers recuperan la configuración actualizada y la distribuyen a los VDA de los grupos de entrega seleccionados.
  • Los VDA utilizan la configuración recibida para reenviar sus registros AOT al servidor de registros especificado.
  • StoreFront que participa en el registro AOT recibe los detalles necesarios a través del mismo mecanismo centralizado.
  • Director utiliza la AuthKey y los detalles del servidor de registros proporcionados para consultar y mostrar los registros AOT para la supervisión y la resolución de problemas.

  • Este enfoque centralizado elimina la necesidad de configurar cada componente individualmente. Configuras los detalles del servidor de registros una vez en Web Studio, y Citrix propaga automáticamente la configuración por todo el sitio.

  • A continuación, se muestra la lista de componentes que obtendrán los detalles del servidor de registros una vez que se configuren en Web Studio:

  • Citrix Director/Monitor
  • Citrix Delivery Controller
  • VDA de Windows
  • VDA de Linux
    • VDA de Mac
    • StoreFront
  • Agente de Grabación de sesiones
  • CWA

Para configurar los ajustes del servidor de registros para entornos locales

Ajustes del servidor de registros AOT

  1. Inicia sesión en Web Studio y selecciona Configuración en el panel izquierdo.
      1. En el mosaico Servidor de registros, selecciona Agregar si no hay ningún servidor de registros configurado.
      1. En la página Servidor de registros, activa Habilitar el reenvío de registros al servidor de registros.
  2. Introduce la Dirección del servidor de registros y el Puerto. Los VDA y los Delivery Controllers utilizan esta información para reenviar los registros AOT.

    Nota:

    1. Si utilizas Citrix Connector Appliance para implementar el servidor de registros, asegúrate de que solo el puerto 443 esté configurado.

    2. La actualización de la dirección y el puerto del servidor de registros en Citrix Studio funciona inicialmente, pero si vuelves a visitar la configuración y modificas los detalles del servidor de registros sin volver a introducir la clave de autenticación, el marcador de posición de la clave de autenticación queda vacío después de guardar, aunque la operación parezca exitosa. Esto da como resultado una configuración faltante o no válida en Director y Monitor. Como solución alternativa, vuelve a introducir y valida siempre la clave de autenticación cada vez que modifiques la configuración del servidor de registros hasta que se resuelva este problema.

  3. Elige qué componentes reenvían los registros:

    1. Incluir Delivery Controllers: Envía registros AOT de todos los Delivery Controllers.

    2. Seleccionar grupos de entrega: Envía registros de los VDA en los grupos de entrega seleccionados.

      • Todos los grupos de entrega: Envía registros de todos los VDA.
      • Seleccionar grupos de entrega específicos: Elige grupos de entrega individuales para incluir.
  4. Introduce la AuthKey generada en el servidor de registros. Director utiliza esta clave para autenticar y recuperar los registros.
  5. Selecciona Guardar para aplicar la configuración.

Para editar una configuración existente

Para actualizar el servidor de registros o modificar el ámbito de registro, ve a Configuración > Servidor de registros y selecciona Editar.

Para configurar los ajustes del servidor de registros para entornos de Citrix DaaS/Cloud

Ajustes del servidor de registros AOT 1

Citrix Web Studio para DaaS proporciona una ubicación centralizada para configurar el reenvío de registros de Always-on Tracing (AOT) para sitios administrados en la nube. Esta configuración determina dónde se envían los registros AOT y controla qué VDA participan en el reenvío de registros. Monitor utiliza estos ajustes para recuperar y mostrar los registros para la resolución de problemas.

  1. Inicia sesión en Web Studio y selecciona Configuración en el panel izquierdo.
  2. En el mosaico Servidor de registros, selecciona Agregar si no hay ningún servidor de registros configurado actualmente.
  3. En la página Servidor de registros, introduce la Dirección del servidor de registros y el Puerto. Los VDA utilizan esta información para reenviar los registros AOT al servidor.
  4. Define qué VDA reenvían los registros:

    1. Selecciona Seleccionar grupos de entrega para controlar el ámbito.
    2. Todos los grupos de entrega (predeterminado) reenvía los registros de todos los VDA del sitio.
    3. Para dirigirte a VDA específicos, selecciona Seleccionar grupos de entrega específicos y elige los grupos de entrega que deseas incluir.

    Nota:

    Si utilizas Citrix Connector Appliance para implementar el servidor de registros, asegúrate de que solo el puerto 443 esté configurado.

  5. Selecciona la Zona (ubicación de recursos) donde está implementado el servidor de registros.
  6. Introduce la Authkey generada por el servidor de registros. Monitor utiliza esta clave para autenticar y recuperar los registros para su visualización.
  7. Selecciona Guardar para aplicar la configuración.

Configuración del reenvío de registros para otros componentes

Configurar la carga de registros AOT para el servidor de Grabación de sesiones

Puedes configurar el servidor de Grabación de sesiones para cargar registros AOT en un servidor de registros central ejecutando el siguiente comando de PowerShell en la máquina del servidor de Grabación de sesiones:

#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 la carga de registros AOT para FAS

Puedes configurar FAS para cargar registros AOT en un servidor de registros central ejecutando el siguiente comando de PowerShell en el 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 la carga de registros AOT para PVS

Puedes configurar PVS para cargar registros AOT en un servidor de registros central ejecutando el siguiente comando de PowerShell en el 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-->

Nota:

Si tienes varios servidores PVS, ejecuta el comando para habilitar o deshabilitar las cargas de registros AOT en cada uno.

Carga de registros AOT para el servidor de licencias

  • La URL del servidor de registros debe actualizarse dentro del archivo de configuración SLS, que se encuentra en la ubicación “C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml” con la etiqueta XML “AotServerURL”.

Ejemplo:

<AotServerURL>https://10.110.249.168:8443/ctxlogserver/UploadCitrixLogStream</AotServerURL>
<!--NeedCopy-->
  • El servidor de licencias carga periódicamente los registros al servidor AOT automáticamente.

Configurar la carga de registros AOT para Citrix Connector para Windows

La URL del servidor de registros se sincroniza automáticamente desde Citrix Cloud. No se requiere ninguna acción.

Configurar la carga de registros AOT para las aplicaciones de Citrix Workspace

Citrix permite a los clientes de la aplicación Citrix Workspace cargar automáticamente los registros de diagnóstico en el servidor de registros centralizado. Esta capacidad mejora la eficiencia de la resolución de problemas al proporcionar a los administradores acceso inmediato a la información de diagnóstico del lado del cliente sin necesidad de recopilación manual de registros. Los AOT del lado del cliente se cargarán automáticamente y se activarán cuando la función AOT esté habilitada en todo el entorno de CVAD y cuando el usuario inicie un recurso.

Requisitos del sistema

  • Citrix Virtual Apps and Desktops 2511 o CVAD 2507 CU1 y versiones posteriores
  • Aplicación Citrix Workspace 2511 o CWA 2507.1 CU1 y versiones posteriores
Plataforma de cliente Versión mínima Matriz compatible
CWA para Windows CWA 2507.1 CU1, 2511 Acceso directo a través de Storefront (local)
CWA para HTML5 CWA 2511 Acceso directo a través de Storefront (local)
CWA para Chrome OS CWA 2511 Acceso directo a través de Storefront (local)

Para habilitar la función AOT para CWA para Windows, agrega la siguiente clave de registro:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Dazzle Name: AotLogCollectionEnabled Type: REG_SZ Value: True

Configurar la carga de registros AOT para NetScaler

  • Accede por SSH a la CLI de NetScaler y luego entra en el shell de NetScaler ejecutando el comando “shell”.
  • Ve al directorio /var/analytics_conf

    cd /var/analytics_conf
    <!--NeedCopy-->
    
  • Genera el archivo de esquema ejecutando un script interactivo de Python “python {Add script name}”. El archivo de esquema define los encabezados HTTP (Auth-token, User-Agent, etc.) y los atributos de carga útil (Role, Machine IP, etc.).

Fragmento de la salida generada 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-->

Archivo de esquema de ejemplo generado

{ 
     "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-->
  • Sal de la shell y vuelve a la CLI de NetScaler
  • Crea una acción de syslog que defina el servidor Syslog, los puertos y el archivo de esquema (creado en el paso 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-->

Ejemplo:

add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
<!--NeedCopy-->
  • Vincula la acción de syslog a la política de Syslog de auditoría
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

Ejemplo:

add audit syslogPolicy pol1 true act1
<!--NeedCopy-->
Carga de los registros AOT de los componentes principales de CVAD