Visualización y uso de registros AOT

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

Paso 1

Edite 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 remotas de visualización de registros. 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, debe conectarse directamente a la máquina del servidor de registros para ver los registros, y Citrix Director Monitor no podrá recuperar ni mostrar los registros.

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 que se guardan 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. Abra Citrix Director.
2. Aparece una nueva opción de Registros en el panel de navegación izquierdo.
3. Seleccione Registros y verá la página de Introducción; haga clic en Cerrar para omitirla, ya que hemos completado estas configuraciones anteriormente.
4. Ahora, verá que Director recupera y muestra los registros AOT directamente desde el servidor de registros.

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

Búsqueda de texto libre: En la parte superior de la página Registros, encontrará una barra de búsqueda de texto libre. Puede escribir cualquier palabra clave para empezar a acotar los resultados. La búsqueda actualiza los resultados al instante una vez que aplica 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: Utilice 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 le 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 le permite filtrar los registros según el tipo de evento o subsistema. Esto le ayuda a centrarse 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 le permite centrarse 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 de nombre de host le permite seleccionar una máquina específica, como un VDA, Delivery Controller, CWA o servidor StoreFront. Esto es útil cuando desea 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 resolución de problemas al permitir una rápida recuperación y análisis de registros desde una única consola. Obtenga más información sobre los requisitos previos y cómo empezar en (en-us/citrix-virtual-apps-desktops/director/logs.html).

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 sus registros seguros, necesitará una clave de autenticación antes de descargarlos. Esto es lo que debe hacer:

1. Obtenga su clave de autenticación – Utilice su propio nombre de rol/nombre para generarla.
2. Ejecutar localmente – Los scripts solo se pueden ejecutar en la máquina donde está instalado el contenedor de Docker.
3. Usuarios de Windows – Utilice los scripts GetAuthKey.bat en lugar de los scripts de shell.
4. Descargar registros – Una vez autenticado, puede recuperar sus registros de forma segura.

Generación y gestión de claves de autenticación para el servidor de registros AOT

Puede utilizar los scripts .sh (Linux) o .bat (Windows) proporcionados para generar rápidamente una nueva clave de autenticación para un rol o usuario específico. Estos scripts simplifican el proceso al devolver la clave generada junto con el rol asociado.

Para Linux

./GetAuthKey.sh role-name
<!--NeedCopy-->

Para Windows

GetAuthKey.bat role-name
<!--NeedCopy-->

El servidor de registros AOT proporciona comandos para administrar las claves de autenticación asociadas a diferentes roles o usuarios. Estos comandos permiten a los administradores añadir, listar, validar y eliminar claves de autenticación directamente desde el contenedor. Utilice los comandos docker exec disponibles directamente en el contenedor del servidor de registros.

• Añadir una nueva clave de autenticación: Crea una nueva clave de autenticación para un rol o usuario especificado:

docker exec logserver /app/authkey add <RoleName>

• Listar todas las claves de autenticación: Muestra todos los roles/usuarios existentes para los que se han creado claves de autenticación:

docker exec logserver /app/authkey list

• Validar una clave de autenticación: Verifica si una clave de autenticación determinada es válida e identifica el rol asociado:

docker exec logserver /app/authkey validate <key>

• Eliminar una clave de autenticación: Elimina una clave de autenticación asociada a un rol específico:

docker exec logserver /app/authkey del <RoleName>

• Ver el uso del comando: Muestra las opciones disponibles para la administración de claves de autenticación:

docker exec logserver /app/authkey ??

El siguiente ejemplo demuestra cómo administrar las claves de autenticación:

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 ningún registro

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

Sustituya logserver_fqdn por el FQDN real del servidor de registros y 8443 por el puerto real del servidor de registros. Sustituya https por http cuando se instale en modo http.

Máquinas vacías significa que no hay ningún registro

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

La hora está en formato UTC: YYYY-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 clave/s. 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.
• Un ID de transacción también se puede usar 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 espacio