Registro de configuración
Nota:
Los registros de configuración solo aparecen en inglés, independientemente del idioma que selecciones para tu 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 la implementación de Citrix Virtual Apps and Desktops™ y Citrix DaaS (anteriormente, el servicio Citrix Virtual Apps and Desktops) y las actividades administrativas en una base de datos de registro en Citrix Cloud. Puedes usar 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 puedes deshabilitarlo.
Desde Studio, puedes ver el contenido del registro de configuración, filtrado por rangos de fechas o por búsqueda de texto completo. También puedes generar un informe CSV usando PowerShell. Desde esta consola, no puedes modificar ni eliminar el contenido del registro. Puedes usar 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 tenants 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 de más de 180 días con fecha del 9 de septiembre de 2024 se eliminarán. A medida que seguimos aumentando nuestros Límites de DaaS para un solo tenant de DaaS, esta implementación garantiza el mejor rendimiento y la resiliencia para nuestros clientes.
Como buena práctica, aconsejamos a los clientes que tengan un mecanismo de exportación trimestral. Esto se puede hacer a través de PowerShell; consulta Generar informes. También recomendamos a los clientes que programen la eliminación periódica de datos; consulta Programar la eliminación periódica de datos.
Permisos necesarios (consulta Administración delegada):
- Los administradores con todos los permisos en Citrix Cloud™, además de los administradores de Citrix DaaS Cloud y los administradores de solo lectura, pueden ver los registros de configuración en Studio.
- Los administradores con todos los permisos y los administradores de Cloud también pueden descargar un informe CSV de la actividad de registro usando 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 puedes 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.
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
Ejemplos de cambios administrativos registrados incluyen:
- Administración de energía de una máquina virtual o un escritorio de usuario
- Funciones de administración o supervisión 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 por parte de la administración de grupos.
- Acciones de directiva implementadas a través de la Consola de administración de directivas de grupo (GPMC). Usa 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, sigue estos pasos:
- Inicia sesión en Citrix Cloud.
- En el mosaico de DaaS, haz clic en Administrar.
- Selecciona Registro en el panel izquierdo y haz clic en la ficha Eventos.
De forma predeterminada, los registros de eventos se muestran por nombres de administrador. Puedes realizar las siguientes tareas según sea necesario:
- Ordenar la visualización. Ordena la visualización haciendo clic en el encabezado de una columna.
- Filtrar registros. Refina la visualización estableciendo condiciones de filtro, como intervalos de días o períodos personalizados, o introduciendo nombres de tareas principales completos o parciales en el cuadro de búsqueda. Para volver a la visualización estándar después de usar la búsqueda, borra el texto del cuadro de búsqueda.
- Exportar registros. Exporta los registros seleccionados o todos a un archivo CSV para archivarlos o analizarlos más a fondo.
- Personalizar columnas. Adapta la visualización a tus necesidades agregando columnas no predeterminadas, como IP de cliente y Etiquetas.
- Administrar etiquetas. Agrega, modifica y quita etiquetas para los registros de eventos a fin de mejorar la organización y el seguimiento de los registros.
Características de la visualización:
- 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 uno o más servicios y llamadas al SDK de PowerShell, que son operaciones de bajo nivel. Cuando seleccionas una operación de alto nivel en el panel central superior, el panel inferior muestra las operaciones de bajo nivel.
- Si creas una operación de bajo nivel en PowerShell sin especificar una operación de alto nivel principal, 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 visualizas registros basados en rangos de tiempo, se muestran los registros incompletos si los datos de los registros coinciden con los criterios. Por ejemplo, si solicitas registros de los últimos cinco días y un registro con una hora de inicio en los últimos cinco días no tiene una hora de finalización, se incluye.
- Recuerda: No puedes 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, ve a Registro > Tareas. La ficha Tareas solo muestra las tareas relacionadas con los catálogos creados a través de Machine Creation Services™ (MCS) o Provisioning Services (PVS). Específicamente, 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 ficha 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, selecciona la tarea y haz 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
- Quitar máquinas virtuales de un catálogo determinado
- Catálogo determinado creado
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. Puedes ordenar la visualización por el encabezado de la columna. Para borrar las tareas completadas, haz clic en Borrar tareas completadas en la ficha Tareas. Para elegir qué columnas aparecen en la visualización, selecciona el icono Columnas que mostrar en la esquina superior derecha de la tabla.
Ver registros de API
Para ver los registros de la API de REST, ve a Registros > API. La ficha API muestra las solicitudes de la API de REST realizadas durante un período de tiempo determinado.
Ten en cuenta las siguientes consideraciones:
- Los registros de la API de REST se borran después de que cierres la sesión de la consola. (También se borran si actualizas la ventana del navegador).
- Cualquier operación en la consola que dé lugar a llamadas a la API tiene sus solicitudes de API correspondientes mostradas en la ficha API.
- La pantalla 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 pantalla es de 1000.
Ver registros de PowerShell
Para ver los comandos de PowerShell correspondientes a las acciones de la interfaz de usuario que has realizado durante el día, ve a la ficha Registros > PowerShell.
Asociar metadatos con registros de configuración
Puedes agregar metadatos a los registros de configuración asociando un par nombre-valor llamado MetadataMap con los registros.
Nota:
- Solo puedes agregar metadatos a objetos de operación de alto nivel.
- Los metadatos se asocian con los registros existentes en el momento de la ejecución.
Establecer los metadatos
Ejecuta el comando de PowerShell Set-LogHighLevelOperationMetadata para asociar un registro con MetadataMap.
Set-LogHighLevelOperationMetadata acepta los siguientes parámetros:
- Id: Identificador de la operación de alto nivel.
-
InputObject: Las operaciones de alto nivel a las que agregas 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 para establecer los metadatos usando los parámetros
-Namey-Value.
Por ejemplo, para agregar los metadatos a todos los registros de alto nivel con el Id 40, ejecuta el siguiente comando de PowerShell:
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
Para agregar los metadatos al registro de alto nivel con el usuario abc@example.com, ejecuta el siguiente comando de PowerShell:
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
Recuperar usando los metadatos
Ejecuta los siguientes comandos de PowerShell para usar los metadatos asociados y recuperar los registros:
-
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:*"
Quitar los metadatos
Ejecuta el comando de PowerShell Remove-LogHighLevelOperationMetadata para quitar los metadatos asociados.
Remove-LogHighLevelOperationMetadata acepta los siguientes parámetros:
- Id: Identificador de la operación de alto nivel.
-
InputObject: Las operaciones de alto nivel a las que agregas 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 quitar. Establécelo en $null para quitar todos los metadatos del objeto especificado.
- Map: 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 quitan 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, usa 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, consulta:
Programar la eliminación periódica de datos
Usa 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 característica no está disponible en Studio). En Citrix DaaS, debes 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 de cero significa que los datos de la base de datos de registro de configuración nunca se eliminan automáticamente.
- Cuando estableces un valor distinto de cero, la base de datos se comprueba una vez cada 120 minutos. Los datos más antiguos que el período de retención se eliminan.
Usa Get-LogSite para ver el valor actual del parámetro.
Diferencias con Citrix Virtual Apps and Desktops local
Si estás 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 puedes deshabilitarlo. El registro obligatorio no está disponible.
- No puedes cambiar la ubicación de la base de datos de registro de configuración, porque la base de datos se administra 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 tu ú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 puedes 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 con registros de configuración
- Generar informes
- Programar la eliminación periódica de datos
- Diferencias con Citrix Virtual Apps and Desktops local