Registro de configuraciones
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, expresadas en tiempo universal coordinado (UTC).
La función Registros de configuración captura las actividades administrativas y los cambios de configuración realizados en la implementación de Citrix Virtual Apps and Desktops y Citrix DaaS (antes, Citrix Virtual Apps and Desktops Service), y los vuelca en una base de datos de registros en Citrix Cloud. Puede usar el contenido registrado para:
- Diagnosticar y solucionar problemas tras haberse realizado cambios de configuración. El registro proporciona un rastro de los pasos seguidos.
- Ayudar en la administración de cambios y en el seguimiento de las configuraciones.
- Realizar informes sobre las actividades administrativas.
En esta instancia de Citrix DaaS, el registro de configuración siempre está habilitado. No se puede inhabilitar.
Desde Studio, puede ver el contenido de los registros de configuración, filtrado por intervalos de fechas o por texto completo. También puede generar un informe CSV mediante PowerShell. Desde esta consola, no se puede modificar ni eliminar el contenido del registro. Puede usar el SDK de PowerShell remoto para programar la eliminación periódica de datos del registro.
Actualizar la retención de registros de configuración de DaaS
Para mantener el rendimiento de los arrendatarios 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 que tengan más de 180 días a partir del 9 de septiembre de 2024, se eliminarán. A medida que aumentamos nuestros límites de DaaS para un único arrendatario de DaaS, esta implementación garantiza el mejor rendimiento y resiliencia para nuestros clientes.
Como práctica recomendada, aconsejamos a los clientes que cuenten con un mecanismo de exportación trimestral. Esto se puede hacer mediante PowerShell; consulte Generar informes. También recomendamos a los clientes programar la eliminación periódica de datos; consulte Programar la eliminación periódica de datos.
Permisos requeridos (consulte Administración delegada):
- Los administradores totales en Citrix Cloud, los administradores de Cloud de Citrix DaaS, así como los administradores de solo lectura pueden ver los registros de configuración en Studio.
- Los administradores totales y los administradores de Cloud también pueden descargar un informe CSV de la actividad de inicios de sesión mediante PowerShell.
Qué se registra
Las siguientes operaciones se registran:
- Cambios de configuración y actividades administrativas iniciadas desde las consolas de Studio y Administrar
- Scripts de PowerShell
- Solicitudes de API de REST
Nota:
No se pueden ver las entradas de registro para las operaciones internas de la plataforma Citrix Cloud, como la configuración o la administración de la base de datos.
Los ejemplos de cambios de configuración registrados incluyen trabajar con (crear, modificar, eliminar y asignar):
- Catálogos de máquinas
- Grupos de entrega (incluido cambiar la configuración de la 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 actividades de tipo administrativo que se registran:
- Administrar energía de una máquina virtual o un escritorio de usuario
- Administrar o supervisar funciones enviando 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 agrupaciones.
- Acciones de directivas, implementadas mediante la Consola de administración de directivas de grupo (GPMC). Puede utilizar herramientas de Microsoft para ver los registros de estas acciones.
- Los cambios realizados a través del Registro u otros orígenes distintos de Studio Supervisar o PowerShell.
Ver contenido de los registros de configuración
Para ver el contenido de los registros de configuración, siga estos pasos:
- Inicie sesión en Citrix Cloud.
- En el mosaico de DaaS, haga clic en Administrar.
- Seleccione Iniciar sesión en el panel izquierdo y haga clic en la ficha Eventos.
De forma predeterminada, la pantalla en el panel central muestra el contenido de las entradas de los registros por orden cronológico (primero las entradas más recientes), separadas por su fecha. Puede hacer lo siguiente:
- Ordenar los elementos en pantalla por el encabezado de la columna.
- Filtrar los elementos en pantalla mediante un intervalo de un día o un periodo de tiempo personalizado, o bien introduciendo texto en el cuadro Buscar. Para volver a la versión estándar después de utilizar la búsqueda, borre el texto del cuadro Buscar.
- Elija qué columnas aparecerán en la pantalla. Para ello, seleccione el icono Columnas que mostrar en la esquina superior derecha de la tabla. Por ejemplo, para ver la dirección IP que usa el administrador para acceder a DaaS, haga clic en el icono y agregue la columna IP de cliente.
Características que se muestran:
- Las operaciones de alto nivel creadas durante la administración y la supervisión se indican en el panel central superior. Una operación de alto nivel tiene como resultado la llamada a uno o varios servicios y SDK de PowerShell, que son operaciones de bajo nivel. Cuando se selecciona una operación de alto nivel en el panel central superior, el panel inferior muestra las operaciones de bajo nivel.
- Si se crea una operación de bajo nivel en PowerShell sin especificar su correspondiente operación de alto nivel, la función de registros de configuración crea una operación de alto nivel suplente.
- Si la operación falla antes de completarse, la operación de registro puede no completarse en la base de datos. Por ejemplo, puede que una entrada inicial no tenga una entrada final. En estos casos, el registro indica que hay información que falta. Cuando se muestran registros correspondientes a intervalos de tiempo, los registros incompletos se muestran si los datos cumplen los requisitos. Por ejemplo, si se solicitan los registros de los últimos cinco días y hay un registro con una hora de inicio dentro de esos cinco días, pero no tiene hora de fin, se incluirá de todos modos.
- Recuerde: No se pueden ver las entradas de registro para las operaciones internas de la plataforma Citrix Cloud, como la configuración o la administración de la base de datos.
Ver tareas relacionadas con las operaciones del catálogo de máquinas
Para ver las tareas relacionadas con las operaciones del catálogo de máquinas, vaya a Registros > Tareas. La ficha Tareas muestra solo las tareas relacionadas con 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 del catálogo de máquinas:
- Crear catálogos
- Clonar catálogos
- Agregar máquinas
- Quitar máquinas
- Actualizar un catálogo (actualización de imágenes o máquinas)
- Revertir actualizaciones de máquinas
Sugerencia:
La ficha Tareas muestra solo las tareas relacionadas con los cambios en el esquema de aprovisionamiento (creación o modificación de un esquema de aprovisionamiento).
Una tarea puede estar en el siguiente estado:
- Completado
- No iniciado
- En ejecución
- Cancelado
- Error
- Desconocido
Para cancelar una tarea en ejecución, selecciónela y, a continuación, haga clic en Cancelar. La cancelación tarda algún tiempo en completarse.
Algunos ejemplos de tareas registradas incluyen:
- Actualización de imagen completada para un determinado catálogo
- Error al actualizar la imagen de un catálogo determinado
- Actualización de imagen cancelada para un determinado catálogo
- 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 pantalla en el panel central muestra las tareas registradas por orden cronológico (primero las entradas más recientes), separadas por fecha. Puede ordenar los elementos en pantalla 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 se mostrarán en la pantalla, seleccione el icono Columnas que mostrar en la esquina superior derecha de la tabla.
Ver registros de API
Para ver los registros de la API REST, vaya a Registros > API. La ficha API muestra las solicitudes de API de REST realizadas durante un período de tiempo determinado.
Tenga en cuenta las siguientes consideraciones:
- Los registros de API de REST se borran después de cerrar sesión en la consola. (También se borran si actualiza la ventana del explorador web).
- Para las operaciones de la consola que resulten en llamadas de API, se mostrarán sus solicitudes de API correspondientes en la ficha API.
- La pantalla muestra las solicitudes de API por orden cronológico (primero las entradas más recientes), separadas por fecha. La cantidad máxima de solicitudes de API en pantalla es 1000.
Ver los registros de PowerShell
Para ver los comandos de PowerShell correspondientes a acciones de interfaz de usuario que ha realizado durante el día, vaya a la ficha Registros > PowerShell.
Asociar metadatos a registros de configuración
Puede adjuntar metadatos a los registros de configuración asociando un par name-value llamado MetadataMap a los registros de registro.
Nota:
- Solo puede adjuntar metadatos a objetos de operaciones de alto nivel.
- Los metadatos se asocian a los registros existentes en el momento de la ejecución.
Establecer los metadatos
Ejecute el comando Set-LogHighLevelOperationMetadata de PowerShell para asociar un registro a 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 se agregan los metadatos. Esta es una alternativa al parámetro
Id, en el que 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 por 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.
-
Mapa: Diccionario de pares (nombre, valor) para las propiedades. Esta es una alternativa a configurar los metadatos mediante los parámetros
-Namey-Value.
Por ejemplo, para adjuntar los metadatos a todos los registros de registro 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
Obtención con los metadatos
Ejecute los siguientes comandos de PowerShell para usar los metadatos asociados para obtener los registros:
-
Búsqueda por clave y valor:
Get-LogHighLevelOperation -Metadata "Key:Value" -
Búsqueda por valor y cualquier clave:
Get-LogHighLevelOperation -Metadata "*:Value" -
Búsqueda por clave y cualquier valor:
Get-LogHighLevelOperation -Metadata "Key:*"
Quitar los metadatos
Ejecute el comando Remove-LogHighLevelOperationMetadata de PowerShell para quitar los metadatos asociados.
Remove-LogHighLevelOperationMetadata toma los siguientes parámetros:
- Id: ID de la operación de alto nivel.
-
InputObject: Las operaciones de alto nivel a las que se agregan los metadatos. Esta es una alternativa al parámetro
Id`, en el que 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 por quitar. Establézcalo en $null para quitar todos los metadatos del objeto especificado.
- Mapa: Diccionario de pares (nombre, valor) para las propiedades. Puede ser una tabla hash (creada con @{“nombre1” = “val1”; “nombre2” = “val2”}) o un diccionario de cadenas (creado con el nuevo objeto “System.Collections.Generic.Dictionary[Cadena, Cadena]”). Se quitan las propiedades cuyos nombres coinciden con las claves del mapa.
Generar informes
Para generar un informe CSV o HTML que contenga los datos de los registros de configuración, use los cmdlets de PowerShell para ConfigLogging Service en el SDK de PowerShell remoto de Citrix Virtual Apps and Desktops. Para obtener más detalles, consulte:
Programar la eliminación periódica de datos
Use el SDK de PowerShell remoto para especificar cuánto tiempo se conservan los datos en la base de datos de registros 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 conservan los datos de la base de datos de registros de configuración antes de eliminarlos automáticamente.
- De forma predeterminada, el valor de este parámetro es 0. El valor cero significa que los datos de la base de datos de registros 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. Se eliminan los datos anteriores al período de retención.
Utilice Get-LogSite para ver el valor actual del parámetro.
Diferencias de Citrix Virtual Apps and Desktops local
Si conoce la función de registros de configuración en el producto local de Citrix Virtual Apps and Desktops, la versión de Citrix Cloud presenta varias diferencias. En Citrix Cloud:
- La función de registros de configuración siempre está habilitada. No se puede inhabilitar. El registro obligatorio no está disponible.
- No se puede cambiar la ubicación de la base de datos de registros de configuración, ya que esa base de datos se administra en la plataforma de Citrix Cloud.
- En Registros de configuración no se incluyen operaciones ni actividades que se realizan dentro de la plataforma Citrix Cloud.
- PowerShell es la única opción para crear un informe en formato CSV o HTML de las operaciones registradas. En el producto local, se pueden generar informes desde Citrix Studio o PowerShell.
- No se puede eliminar el contenido de los registros de configuración.
En este artículo
- Actualizar la retención de registros de configuración de DaaS
- Qué se registra
- Ver contenido de los registros de configuración
- Ver tareas relacionadas con las operaciones del catálogo de máquinas
- Ver registros de API
- Ver los registros de PowerShell
- Asociar metadatos a registros de configuración
- Generar informes
- Programar la eliminación periódica de datos
- Diferencias de Citrix Virtual Apps and Desktops local