Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Visualización y uso de registros AOT

April 6, 2026
Contribución de: 
C

Acceso a los registros a través de la interfaz de usuario de Director

Paso 1

  • Edita el archivo StartLogServer.bat.

El archivo StartLogServer.bat contiene todos los parámetros de configuración utilizados para iniciar el contenedor del servidor de registros AOT, incluidas varias variables de entorno que controlan el acceso y el comportamiento de los registros. Una de las configuraciones clave es LOCAL_DOWN_ONLY.

  • Cuando LOCAL_DOWN_ONLY=false, el servidor de registros acepta solicitudes de visualización de registros remotas. Esto permite que Citrix Director/Monitor se conecte al servidor de registros y muestre los registros AOT directamente en la interfaz de usuario de Monitor.

  • Cuando LOCAL_DOWN_ONLY=true, el servidor de registros restringe el acceso a los registros a conexiones solo locales. En este modo, debes conectarte directamente a la máquina del servidor de registros para ver los registros, y Citrix Director Monitor no podrá recuperar ni mostrar los registros.

Archivo bat de AOT

Paso 2

Web Studio proporciona una configuración dedicada que permite a Citrix Director conectarse al servidor de registros AOT y mostrar los registros en la consola de Monitor. Una vez guardadas las configuraciones de Web Studio, los Delivery Controllers actualizan la configuración del sitio y Director recibe los detalles del servidor de registros, incluida la dirección, el puerto y la clave de autenticación del servidor de registros. Director utiliza estas configuraciones para establecer una conexión segura con el servidor de registros.

  • Paso 3

  • Después de la configuración:
  1. Abre Citrix Director.
  2. Aparece una nueva opción Registros en el panel de navegación izquierdo.
  3. Selecciona Registros y verás la página de introducción; haz clic en Cerrar para omitirla, ya que hemos completado estas configuraciones anteriormente.
    1. Ahora, verás que Director recupera y muestra los registros AOT directamente desde el servidor de registros.
  • Citrix Director

La página Registros de Director proporciona una vista unificada de los eventos AOT de los Delivery Controllers, VDA, servidores StoreFront y otros componentes de Citrix. Puedes buscar, filtrar e inspeccionar los registros en tiempo real para solucionar problemas rápidamente.

Búsqueda de texto libre: En la parte superior de la página Registros, encontrarás una barra de búsqueda de texto libre. Puedes escribir cualquier palabra clave para empezar a acotar los resultados. La búsqueda actualiza los resultados al instante una vez que aplicas los filtros. Algunos ejemplos son:

  • Nombres de usuario
  • Nombres de máquina
  • Palabras clave de eventos (por ejemplo, registro, autenticación, STA)
  • ID de transacción
  • Mensajes de error o cadenas parciales

Filtro de tiempo: Utiliza el selector de tiempo (por ejemplo, Últimos 5 minutos, Última 1 hora, Últimas 24 horas) para ver los registros generados dentro de una duración específica. Esto te ayuda a aislar rápidamente los eventos en torno al momento exacto en que ocurrió un problema.

Filtro de categoría: El campo Categoría te permite filtrar los registros según el tipo de evento o subsistema. Esto te ayuda a centrarte en los registros relacionados con el inicio de aplicaciones, el registro, la configuración de VDA, los gráficos, HDX Direct, la conexión ICA, etc.

Filtro de clase de registro: El filtro Clase de registro agrupa los registros por gravedad o tipo de evento. Esto te permite centrarte solo en los errores o eventos importantes al solucionar problemas. Las clases comunes incluyen:

  • Información
  • Advertencia
  • Error
  • Fallo

Filtro de nombre de host: El filtro Nombre de host te permite seleccionar una máquina específica, como un VDA, Delivery Controller, CWA o servidor StoreFront. Esto es útil cuando quieres profundizar en los registros de un único punto final o máquina virtual en lugar de buscar en toda la implementación.

Este acceso centralizado agiliza la solución de problemas al permitir una rápida recuperación y análisis de registros desde una única consola. Obtén más información sobre los requisitos previos y cómo empezar en Director - Registros.

Acceso a los registros a través del servidor de registros

El siguiente contenido es Generar la clave de autenticación. Para habilitar el acceso a los registros, el usuario necesita:

  1. Modificar el script StartLogServer.bat LOCAL_DOWN_ONLY=false
  2. Generar la clave de autenticación

Para mantener tus registros seguros, necesitarás una clave de autenticación antes de descargarlos. Esto es lo que debes hacer:

  1. Obtén tu clave de autenticación – Usa tu propio nombre de rol/nombre para generarla.
  2. Ejecuta localmente – Los scripts solo se pueden ejecutar en la máquina donde está instalado el contenedor de Docker.
  3. Usuarios de Windows – Usa los scripts GetAuthKey.bat en lugar de los scripts de shell.
  4. Descarga los registros – Una vez autenticado, puedes recuperar tus registros de forma segura.

Generar la clave de autenticación

Para Linux 

./GetAuthKey.sh role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Para Windows 

GetAuthKey.bat role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Guarda la clave: ebac9b7726cb4be597c92c6769134d25 por tu cuenta. Es la única forma de obtener la clave.

Listar los nombres de las máquinas que ya han enviado sus registros AOT al servidor de registros

El parámetro es la clave obtenida de GetAuthKey.sh.

Para Linux 

./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Máquinas vacías significa que no hay registros.

Para Windows 

ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Para PowerShell de Windows cuando LogServer se inicia con “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/ListMachine" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" }
<!--NeedCopy-->

Reemplaza logserver_fqdn con el FQDN real del servidor de registros, y 8443 con el puerto real del servidor de registros. Reemplaza https con http cuando se instale en modo http.

Máquinas vacías significa que no hay registros.

Descargar registros por nombre de máquina y rango de tiempo.

La hora está en formato UTC: AAAA-mm-ddTHH:MM:SSZ.

#Usage: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [OutputFile]
#Example:
<!--NeedCopy-->

Para Linux 

./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy-->

Para Windows 

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

Para PowerShell de Windows cuando LogServer se inicia con “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/TimeRange?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

Descargar registros por filtro de palabra(s) clave. La hora está en formato UTC

Nota:

  • Una palabra clave puede ser una sola palabra o una combinación de palabras.
  • Las palabras clave pueden coincidir en cualquier parte del mensaje de registro.
  • También se puede usar un ID de transacción como palabra clave.
#Usage: ./DownloadLogsByWords.sh [AuthKey] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [SearchWords] [OutputFile]
#Example:
<!--NeedCopy-->

Para Linux 

./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv
<!--NeedCopy-->

Para Windows 

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

Para PowerShell de Windows cuando LogServer se inicia con “-e LOCAL_DOWN_ONLY=false”:

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/SearchLog?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z&words=failed vda" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

Las palabras están separadas por espacios.

Visualización y uso de registros AOT
April 6, 2026
Contribución de: 
C
April 6, 2026
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.