Registro de configuración
Nota:
Los registros de configuración aparecen solo en inglés, independientemente del idioma que seleccione para su cuenta de Citrix Cloud. Las fechas y horas asociadas a esos registros están en formato MM/DD/AA y se expresan en Hora Universal Coordinada (UTC).
El registro de configuración es una función que captura los cambios de configuración de implementación y las actividades administrativas de Citrix Virtual Apps and Desktops™ y Citrix DaaS (anteriormente servicio Citrix Virtual Apps and Desktops) en una base de datos de registro en Citrix Cloud. Puede utilizar el contenido registrado para:
- Diagnosticar y solucionar problemas después de realizar cambios de configuración. El registro proporciona un rastro de auditoría.
- Ayudar en la gestión de cambios y realizar un seguimiento de las configuraciones.
- Informar sobre las actividades administrativas.
En este Citrix DaaS™, el registro de configuración siempre está habilitado. No se puede deshabilitar.
Desde Studio, puede ver el contenido del registro de configuración, filtrado por rangos de fechas o por búsqueda de texto completo. También puede generar un informe CSV mediante PowerShell. Desde esta consola, no puede editar ni eliminar el contenido del registro. Puede utilizar el SDK de PowerShell remoto para programar la eliminación periódica de datos del registro.
Actualizar la retención de los registros de configuración de DaaS
Para mantener el rendimiento de los inquilinos de DaaS, a partir del 9 de septiembre de 2024, la retención de los registros de configuración se establecerá en 180 días.
Los registros anteriores a 180 días del 9 de septiembre de 2024 se eliminarán. A medida que seguimos aumentando nuestros Límites de DaaS para un único inquilino de DaaS, esta implementación garantiza el mejor rendimiento y la mejor resiliencia para nuestros clientes.
Como práctica recomendada, aconsejamos a los clientes que dispongan de un mecanismo de exportación trimestral. Esto se puede hacer a través de PowerShell; consulte Generar informes. También recomendamos a los clientes que programen la eliminación periódica de datos; consulte Programar la eliminación periódica de datos.
Permisos necesarios (consulte Administración delegada):
- Los administradores con todos los permisos en Citrix Cloud™, además de los administradores de la nube de Citrix DaaS y los administradores de solo lectura, pueden ver los registros de configuración en Studio.
- Los administradores completos y los administradores de la nube también pueden descargar un informe CSV de la actividad de registro, utilizando PowerShell.
Qué se registra
Se registran las siguientes operaciones:
- Cambios de configuración y actividades administrativas iniciadas desde la sección Administrar y el nodo Supervisar
- Scripts de PowerShell
- Solicitudes de API REST
Nota:
No puede ver las entradas de registro de las operaciones internas de la plataforma de Citrix Cloud, como la configuración y administración de bases de datos.
Algunos ejemplos de cambios de configuración registrados incluyen trabajar con (crear, modificar, eliminar, asignar):
- Catálogos de máquinas
- Grupos de entrega (incluida la modificación de la configuración de administración de energía)
- Roles y ámbitos de administrador
- Recursos y conexiones de host
- Directivas de Citrix® a través de Studio
Algunos ejemplos de cambios administrativos registrados incluyen:
- Administración de energía de una máquina virtual o un escritorio de usuario
- Administrar o supervisar funciones que envían un mensaje a un usuario
Las siguientes operaciones no se registran. (Muchas de ellas no están disponibles para los administradores de clientes).
- Operaciones automáticas como el encendido de máquinas virtuales mediante la administración de grupos.
- Acciones de directiva implementadas a través de la Consola de administración de directivas de grupo (GPMC). Utilice las herramientas de Microsoft para ver los registros de esas acciones.
- Cambios realizados a través del registro o desde orígenes distintos de Studio, Monitor o PowerShell.
Ver el contenido del registro de configuración
Para ver el contenido del registro de configuración, siga estos pasos:
- Inicie sesión en Citrix Cloud.
- En el mosaico de DaaS, haga clic en Administrar.
- Seleccione Registro en el panel izquierdo y haga clic en la ficha Eventos.
De forma predeterminada, los registros de eventos se muestran por nombres de administrador. Puede realizar las siguientes tareas según sea necesario:
- Ordenar la visualización. Ordene la visualización haciendo clic en el encabezado de una columna.
-
Filtrar registros. Refine la visualización estableciendo filtros, como:
- Intervalos de días o períodos personalizados.
- Nombres de tareas principales completos o parciales.
-
Detalles de operaciones de bajo nivel, como el nombre de la máquina y el nombre de VDI. Para buscar entre los detalles de bajo nivel, seleccione Ampliar el ámbito de búsqueda para incluir detalles antes de introducir el término de búsqueda.
Nota:
- Habilitar esta opción puede aumentar el tiempo de búsqueda porque el sistema busca en un conjunto más amplio de entradas de registro.
- La selección se guarda solo para la sesión actual de Web Studio. Al cerrar la sesión o iniciar una nueva, seleccione la opción de nuevo si quiere incluir los detalles de las operaciones de bajo nivel en la búsqueda.
- Exportar registros. Exporte los registros seleccionados o todos los registros a un archivo CSV para archivarlos o analizarlos en mayor profundidad.
- Personalizar columnas. Adapte la visualización a sus necesidades añadiendo columnas no predeterminadas, como IP de cliente y Etiquetas.
- Administrar etiquetas. Agregue, edite y elimine etiquetas para los registros de eventos a fin de mejorar la organización y el seguimiento de los registros.
Características de la pantalla:
- Las operaciones de alto nivel creadas durante la administración y la supervisión se muestran en el panel central superior. Una operación de alto nivel da como resultado una o varias llamadas a servicios y al SDK de PowerShell, que son operaciones de bajo nivel. Al seleccionar una operación de alto nivel en el panel central superior, el panel inferior muestra las operaciones de bajo nivel.
- Si crea una operación de bajo nivel en PowerShell sin especificar una operación principal de alto nivel, el registro de configuración crea una operación de alto nivel sustituta.
- Si una operación falla antes de completarse, es posible que la operación de registro no se complete en la base de datos. Por ejemplo, un registro de inicio no tiene un registro de detención correspondiente. En tales casos, el registro indica que falta información. Cuando se muestran los registros en función de los intervalos de tiempo, se muestran los registros incompletos si los datos de los registros coinciden con los criterios. Por ejemplo, si solicita registros de los últimos cinco días y un registro con una hora de inicio en los últimos cinco días no tiene hora de finalización, se incluye.
- Recuerde: No puede ver las entradas de registro de las operaciones internas de la plataforma Citrix Cloud, como la configuración y la administración de la base de datos.
Ver tareas relacionadas con las operaciones de catálogos de máquinas
Para ver las tareas relacionadas con las operaciones de catálogos de máquinas, vaya a Registros > Tareas. La ficha Tareas solo muestra las tareas relacionadas con los catálogos creados mediante Machine Creation Services™ (MCS) o Provisioning Services (PVS). En concreto, aparecen las tareas asociadas a las siguientes operaciones de catálogos de máquinas:
- Crear catálogos
- Clonar catálogos
- Agregar máquinas
- Quitar máquinas
- Actualizar un catálogo (actualizar imágenes o máquinas)
- Revertir actualizaciones de máquinas
Consejo:
La pestaña Tareas solo muestra las tareas relacionadas con los cambios en el esquema de aprovisionamiento (crear o modificar un esquema de aprovisionamiento).
Una tarea puede estar en el siguiente estado:
- Completada
- No iniciada
- En ejecución
- Cancelada
- Fallida
- Desconocida
Para cancelar una tarea en ejecución, seleccione la tarea y haga clic en Cancelar. La cancelación tarda un tiempo en completarse.
Ejemplos de tareas registradas incluyen:
- Actualización de imagen completada para un catálogo determinado
- Error al actualizar la imagen para un catálogo determinado
- Actualización de imagen cancelada para un catálogo determinado
- Aprovisionamiento de máquinas virtuales en un catálogo determinado
- Eliminación de máquinas virtuales de un catálogo determinado
- Creación de un catálogo determinado
De forma predeterminada, la visualización en el panel central muestra las tareas registradas cronológicamente (las entradas más recientes primero), separadas por fecha. Puede ordenar la visualización por el encabezado de la columna. Para borrar las tareas completadas, haga clic en Borrar tareas completadas en la ficha Tareas. Para elegir qué columnas aparecerán en la visualización, seleccione el icono Columnas a mostrar en la esquina superior derecha de la tabla.
Ver registros de API
Para ver los registros de la API de REST, vaya a Registro > API. La ficha API muestra las solicitudes de la API de REST realizadas durante un período de tiempo determinado.
Tenga en cuenta las siguientes consideraciones:
- Los registros de la API de REST se borran después de cerrar la sesión de la consola. (También se borran si actualiza la ventana del explorador).
- Cualquier operación en la consola que dé como resultado llamadas a la API tiene sus solicitudes de API correspondientes mostradas en la ficha API.
- La visualización muestra las solicitudes de la API cronológicamente (las entradas más recientes primero), separadas por fecha. El número máximo de solicitudes de la API en la visualización es de 1000.
Ver registros de PowerShell
Para ver los comandos de PowerShell correspondientes a las acciones de interfaz de usuario que ha realizado durante el día, vaya a la ficha Registro > PowerShell.
Asociar metadatos a los registros de configuración
Puede adjuntar metadatos a los registros de configuración asociando un par name-value llamado MetadataMap a los registros.
Nota:
- Solo puede adjuntar metadatos a objetos de operación de alto nivel.
- Los metadatos se asocian a los registros existentes en el momento de la ejecución.
Establecer los metadatos
Ejecute el comando de PowerShell Set-LogHighLevelOperationMetadata para asociar un registro con el MetadataMap.
Set-LogHighLevelOperationMetadata toma los siguientes parámetros:
- Id: ID de la operación de alto nivel.
-
InputObject: Las operaciones de alto nivel a las que agrega los metadatos. Esta es una alternativa al parámetro
Id, donde se pasa un objeto de operación de alto nivel o una lista de objetos al comando de PowerShell. -
Name: Nombre de la propiedad de los metadatos que se van a agregar. La propiedad debe ser única para la operación de alto nivel especificada. La propiedad no puede contener ninguno de los siguientes caracteres:
()\/;:#.*?=<>|[]"' - Value: Valor de la propiedad.
-
Map: Diccionario de pares (nombre, valor) para las propiedades. Esta es una alternativa a la configuración de los metadatos mediante los parámetros
-Namey-Value.
Por ejemplo, para adjuntar los metadatos a todos los registros de alto nivel con el ID 40, ejecute el siguiente comando de PowerShell:
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
Para adjuntar los metadatos al registro de alto nivel con el usuario abc@example.com, ejecute el siguiente comando de PowerShell:
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
Recuperar usando los metadatos
Ejecute los siguientes comandos de PowerShell para usar los metadatos asociados y recuperar los registros de log:
-
Buscar por clave y valor:
Get-LogHighLevelOperation -Metadata "Key:Value" -
Buscar por valor y cualquier clave:
Get-LogHighLevelOperation -Metadata "*:Value" -
Buscar por clave y cualquier valor:
Get-LogHighLevelOperation -Metadata "Key:*"
Eliminar los metadatos
Ejecute el comando de PowerShell Remove-LogHighLevelOperationMetadata para eliminar los metadatos asociados.
Remove-LogHighLevelOperationMetadata acepta los siguientes parámetros:
- Id: ID de la operación de alto nivel.
-
InputObject: Las operaciones de alto nivel a las que agrega los metadatos. Esta es una alternativa al parámetro
Id` donde se pasa un objeto de operación de alto nivel o una lista de objetos al comando de PowerShell. - Nombre: Nombre de la propiedad de los metadatos que se van a eliminar. Establezca en $null para eliminar todos los metadatos del objeto especificado.
- Mapa: Diccionario de pares (nombre, valor) para las propiedades. Puede ser una tabla hash (creada con @{“name1” = “val1”; “name2” = “val2”}) o un diccionario de cadenas (creado con new-object “System.Collections.Generic.Dictionary[String, String]”). Se eliminan las propiedades cuyos nombres coinciden con las claves del mapa.
Generar informes
Para generar un informe CSV o HTML que contenga datos de registro de configuración, utilice los cmdlets de PowerShell para el servicio ConfigLogging en el SDK de PowerShell remoto de Citrix Virtual Apps and Desktops. Para obtener más información, consulte:
Programar la eliminación periódica de datos
Utilice el SDK de PowerShell remoto para especificar cuánto tiempo se retienen los datos en la base de datos de registro de configuración. (Esta función no está disponible en Studio). En Citrix DaaS, debe tener acceso total.
En el cmdlet Set-LogSite, el parámetro -LoggingDBPurgeDurationDays especifica cuántos días se retienen los datos en la base de datos de registro de configuración antes de que se eliminen automáticamente.
- De forma predeterminada, el valor de este parámetro es 0. Un valor cero significa que los datos de la base de datos de registro de configuración nunca se eliminan automáticamente.
- Cuando se establece un valor distinto de cero, la base de datos se comprueba una vez cada 120 minutos. Los datos anteriores al período de retención se eliminan.
Utilice Get-LogSite para ver el valor actual del parámetro.
Diferencias con Citrix Virtual Apps and Desktops local
Si está familiarizado con el registro de configuración en el producto Virtual Apps and Desktops local, la versión de Citrix Cloud tiene varias diferencias. En Citrix Cloud:
- El registro de configuración siempre está habilitado. No se puede inhabilitar. El registro obligatorio no está disponible.
- No puede cambiar la ubicación de la base de datos de registro de configuración, porque la base de datos se gestiona en la plataforma Citrix Cloud.
- Las pantallas de registro de configuración no incluyen operaciones ni actividades que se realicen dentro de la plataforma Citrix Cloud.
- PowerShell es su única opción para crear un informe CSV o HTML de las operaciones registradas. En el producto local, los informes se pueden generar desde Citrix Studio o PowerShell.
- No puede eliminar el contenido del registro de configuración.
En este artículo
- Actualizar la retención de los registros de configuración de DaaS
- Qué se registra
- Ver el contenido del registro de configuración
- Ver tareas relacionadas con las operaciones de catálogos de máquinas
- Ver registros de API
- Ver registros de PowerShell
- Asociar metadatos a los registros de configuración
- Generar informes
- Programar la eliminación periódica de datos
- Diferencias con Citrix Virtual Apps and Desktops local