Citrix Insight Services
Citrix Insight Services (CIS) es una plataforma de Citrix para instrumentación, telemetría y generación de información empresarial. Sus capacidades de instrumentación y telemetría permiten a los usuarios técnicos (clientes, socios e ingenieros) emitir ellos mismos diagnósticos de los problemas y corregirlos, optimizando así sus entornos de trabajo. Para obtener la información más reciente y detallada sobre CIS y saber cómo funciona, consulte https://cis.citrix.com (se necesitan credenciales de cuenta de Citrix).
Toda la información que se carga en Citrix se usa para la solución de problemas y para diagnósticos, además de mejorar la calidad, la confiabilidad y el rendimiento de los productos, y está sujeta a estas directivas:
- Directiva de Citrix Insight Services en https://cis.citrix.com/legal
- Directiva de privacidad de Citrix en https://www.cloud.com/privacy-policy
Esta versión de Citrix Virtual Apps and Desktops admite las siguientes tecnologías.
- Análisis sobre la instalación y la actualización de Citrix Virtual Apps and Desktops
- Customer Experience Improvement Program (CEIP) de Citrix
- Citrix Call Home
- Citrix Scout
Además (e independientemente) de CIS y Citrix Analytics: Los datos de Google Analytics se recopilan (y luego se cargan) automáticamente cuando se instala (o se actualiza) Studio. Después de instalar Studio, puede cambiar este parámetro con la clave de Registro HKLM\Software\Citrix\DesktopStudio\GAEnabled. El valor 1 habilita la recopilación y la carga, mientras que el valor 0 las inhabilita.
Datos de análisis de instalación y actualización
Cuando se usa el instalador del producto completo para implementar o actualizar los componentes de Citrix Virtual Apps and Desktops, se recopila información anónima sobre el proceso de instalación y se guarda en la máquina donde se está realizando la instalación o actualización del componente. Esta información se utiliza para ayudar a Citrix a mejorar la experiencia de instalación de sus clientes.
La información se almacena localmente en %ProgramData%\Citrix\CTQs.
La carga automática de estos datos está habilitada de forma predeterminada en ambas interfaces, la gráfica y la de línea de comandos, del programa de instalación de producto completo.
- Puede cambiar el valor predeterminado en un parámetro de Registro. Si cambia el parámetro de Registro antes de instalar o actualizar, ese valor se usará cuando use el programa de instalación de producto completo.
- Puede anular la configuración predeterminada si instala o actualiza con la interfaz de línea de comandos y especifica esa opción con el comando.
Controlar las cargas automáticas:
-
El parámetro de Registro que controla la carga automática de los datos de análisis de instalación o actualización (predeterminado = 1):
- Ubicación: HKLM:\Software\Citrix\MetaInstall
- Nombre: SendExperienceMetrics
- Valor: 0 = inhabilitado, 1 = habilitado
-
Mediante PowerShell, el cmdlet siguiente inhabilita la carga automática de los datos de análisis de instalación o actualización:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0 <!--NeedCopy--> -
Para inhabilitar las cargas automáticas con el comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, incluya la opción
/disableexperiencemetrics.Para habilitar las cargas automáticas con el comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, incluya la opción
/sendexperiencemetrics.
Customer Experience Improvement Program (CEIP) de Citrix
Cuando se participa en el programa CEIP de mejora de la experiencia del usuario (Customer Experience Improvement Program), se envían estadísticas e información de uso anónimos a Citrix para ayudar a Citrix a mejorar la calidad y el rendimiento de sus productos. Para obtener más información, consulte https://more.citrix.com/XD-CEIP.
Inscripción durante la creación o actualización de un sitio
Se inscribe automáticamente en el programa CEIP al crear un sitio (después de instalar el primer Delivery Controller). La primera carga de datos tiene lugar aproximadamente siete días después de crear el sitio.
Puede dejar de participar en cualquier momento después de crear el sitio. Seleccione el nodo Parámetros en el panel de la izquierda de Web Studio y desactive el parámetro Citrix Customer Experience Improvement Program.
Cuando se actualiza una implementación de Citrix Virtual Apps and Desktops:
- Si actualiza una versión desde otra no compatible con CEIP, se le preguntará si quiere participar.
- Si actualiza una versión desde otra compatible con CEIP y la participación en el programa ya estaba habilitada, CEIP se habilitará en el sitio actualizado.
- Si actualiza una versión desde otra compatible con CEIP y la participación en el programa no estaba habilitada, CEIP se inhabilitará en el sitio actualizado.
- Si actualiza una versión desde otra compatible con CEIP, pero no se sabe si la participación estaba o no habilitada, se le preguntará si quiere participar.
La información recopilada es anónima, por lo que no se puede ver una vez cargada en Citrix Insight Services.
Inscripción al instalar un VDA
De forma predeterminada, se inscribe automáticamente en el programa CEIP cuando instala un Windows VDA. Puede cambiar esta opción predeterminada en el parámetro de Registro del sistema. Si cambia el parámetro de Registro del sistema antes de instalar el VDA, se usará ese valor.
El parámetro de Registro que controla la inscripción automática en CEIP (predeterminado = 1):
Ubicación: HKLM: \Software\Citrix\Telemetry\CEIP Name: Enabled Value: 0 = disabled, 1 = enabled
De forma predeterminada, la propiedad Enabled está oculta en el Registro del sistema. Si no se especifica, significa que la funcionalidad de carga automática está habilitada.
Con PowerShell, el cmdlet siguiente inhabilita la inscripción en el programa CEIP:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
<!--NeedCopy-->
Los puntos de datos sobre el tiempo de ejecución recopilados se escriben periódicamente como archivos en una carpeta de salida (ubicación predeterminada: %programdata%/Citrix/VdaCeip).
La primera carga de datos tiene lugar aproximadamente siete días después de instalar el VDA.
Inscripción al instalar otros productos y componentes
También puede participar en CEIP al instalar tecnologías, productos y componentes relacionados de Citrix, tales como Citrix Provisioning, AppDNA, Citrix License Server, la aplicación Citrix Workspace para Windows, Universal Print Server y Grabación de sesiones. Consulte la documentación para obtener más detalles sobre los valores predeterminados de instalación y participación en el programa.
Citrix Call Home
Al instalar determinados componentes y funciones de Citrix Virtual Apps and Desktops, se le ofrece la oportunidad de participar en Citrix Call Home. Call Home recopila datos de diagnóstico y carga periódicamente paquetes de telemetría con esos datos directamente en Citrix Insight Services (por HTTPS a través del puerto predeterminado 443) para el análisis y la solución de problemas.
En Citrix Virtual Apps and Desktops, Call Home se ejecuta como un servicio en segundo plano con el nombre de Citrix Telemetry Service. Para obtener más información, consulte https://more.citrix.com/XD-CALLHOME.
La funcionalidad de programación de Call Home también está disponible en Citrix Scout. Para obtener más información, consulte Citrix Scout.
Qué datos se recopilan
Citrix Diagnostic Facility (CDF) recopila información que puede ser útil para solucionar problemas. Call Home recopila un subconjunto de rastros CDF que pueden ser útiles para solucionar errores comunes como, por ejemplo, los registros de VDA e inicios de aplicaciones o escritorios. Esta tecnología se conoce como rastreo permanente (Always-On Tracing o AOT). Los registros AOT se guardan en el disco en C:\Users\CitrixTelemetryService\Appdata\Local\CitrixAOT.
Call Home no recopilará ningún otro rastreo de eventos de Windows (Event Tracing for Windows, ETW), ni tampoco se puede configurar para hacerlo.
Call Home también recopila información adicional, como:
- Registros creados por Citrix Virtual Apps and Desktops en
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix. - Información de WMI (Instrumental de administración de Windows) en el espacio de nombres de Citrix.
- Lista de procesos en ejecución.
- Volcados de errores de procesos de Citrix que están almacenados en %PROGRAM DATA%\Citrix\CDF
- Información sobre instalaciones y actualizaciones. Esto puede incluir el registro completo del metainstalador del producto, los registros MSI con errores, los resultados del analizador de registros MSI, los registros de StoreFront, los registros de comprobación de compatibilidad de licencias y los resultados de las pruebas preliminares de actualización de versión del sitio.
La información de rastreo se comprime tras recopilarse. Citrix Telemetry Service conserva un máximo de 10 MB de la información de rastreo más reciente comprimida, con un tiempo límite máximo de ocho días.
- La compresión de los datos permite que Call Home ocupe muy poco espacio del VDA.
- Los rastreos se guardan en memoria a fin de evitar operaciones E/S en las máquinas aprovisionadas.
- El búfer de rastreo utiliza un mecanismo circular para conservar los rastreos en memoria.
Call Home recopila los puntos de datos clave: Puntos de datos clave para Call Home.
Resumen de configuración y administración
Puede inscribirse en Call Home cuando use el asistente de instalación del producto completo, o más adelante, mediante cmdlets de PowerShell. Cuando se inscribe, de forma predeterminada, los diagnósticos se recopilan y se cargan en Citrix cada domingo aproximadamente a las 3:00, hora local. La hora de carga es aleatoria en un máximo de dos horas respecto a la hora especificada. Esto significa que una carga programada de forma predeterminada se realiza entre 3:00 y 5:00 de la mañana.
Si no quiere cargar la información de diagnóstico siguiendo la programación (o si quiere cambiar la programación existente), puede usar los cmdlets de PowerShell para recopilar y cargar manualmente los diagnósticos o guardarlos localmente.
Cuando se inscriba en cargas programadas de Call Home y cuando cargue manualmente información de diagnóstico en Citrix, deberá proporcionar las credenciales de su cuenta de Citrix o de Citrix Cloud. Citrix intercambia las credenciales por un token de carga que se utiliza para identificar al cliente y cargar los datos. Las credenciales no se guardan.
Cuando tiene lugar una operación de carga, se envía una notificación por correo electrónico a la dirección asociada a la cuenta de Citrix.
Si habilita Call Home al instalar un componente, puede inhabilitarlo más tarde.
Requisitos previos
- La máquina debe estar ejecutando PowerShell 3.0 o posterior.
- La máquina debe estar ejecutando Citrix Telemetry Service.
- La variable del sistema
PSModulePathdebe establecerse en la ruta de instalación de Telemetry; por ejemplo: C:\Archivos de programa\Citrix\Telemetry Service\.
Habilitar Call Home durante la instalación de componentes
Durante la instalación o la actualización del VDA: Cuando instala o actualiza un Virtual Delivery Agent desde la interfaz gráfica del instalador del producto completo, se le pregunta si quiere participar en Call Home. Existen dos opciones:
- Participar en Call Home.
- No participar en Call Home.
Si actualiza un VDA y se había inscrito antes en Call Home, esa página del asistente no aparece.
Durante la instalación o la actualización de versión del Controller: Cuando instala o actualiza la versión de un Delivery Controller desde la interfaz gráfica, se le pregunta si quiere participar en Call Home. Existen tres opciones:
Cuando instale un Controller, no podrá configurar información en la página Call Home del asistente de instalación si el servidor tiene aplicado un objeto de directiva de grupo de Active Directory con la configuración de directiva “Iniciar sesión como un servicio”. Para obtener más información, consulte CTX218094.
Si actualiza un Controller y se había inscrito antes en Call Home, no se le preguntará sobre la participación.
Cmdlets de PowerShell
La ayuda de PowerShell proporciona la sintaxis completa, incluidas las descripciones de cmdlets y parámetros que no se utilizan en estos casos de uso más comunes.
Si quiere usar un servidor proxy para las cargas, consulte Configurar un servidor proxy.
-
Puntos de datos clave para Call Home: Las recopilaciones de diagnósticos se cargan automáticamente en Citrix. Si no introduce más cmdlets para una programación personalizada, se usa la programación predeterminada.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred <!--NeedCopy-->Para confirmar que las cargas programadas se han habilitado, escriba
Get-CitrixCallHomeGet-CitrixCallHome. Si se han habilitado, se devuelveIsEnabled=TrueyIsMasterImage=False. -
Habilitación de cargas programadas para máquinas creadas a partir de una imagen maestra: Si habilita cargas programadas en una imagen maestra, no tendrá que configurar esto en cada una de las máquinas que se creen en el catálogo de máquinas.
Enable-CitrixCallHome -Credential $cred -MasterImagePara confirmar que las cargas programadas se han habilitado, escriba Get-CitrixCallHome. Si se han habilitado, se devuelve
IsEnabled=TrueyIsMasterImage=True. -
Creación de una programación personalizada: Cree una programación semanal o diaria para recopilaciones y cargas de diagnósticos.
$timespan = New-TimeSpan –Hours hours -Minutes minutes Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek day -UploadFrequency {Daily|Weekly} <!--NeedCopy-->
Ejemplos:
El cmdlet siguiente crea una programación para crear un paquete con los datos y cargarlos a las 22:20 todas las noches. El parámetro de horas se usa un reloj de 24 horas. Cuando el valor del parámetro UploadFrequency es Daily, el parámetro DayOfWeek se ignora aunque se haya especificado.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
<!--NeedCopy-->
Para confirmar la programación, introduzca Get-CitrixCallHomeSchedule. En el ejemplo anterior, la acción devuelve StartTime=22:20:00, DayOfWeek=Sunday (ignored), Upload Frequency=Daily.
El cmdlet siguiente crea una programación para crear un paquete con los datos y cargarlos a las 22:20 los miércoles.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
<!--NeedCopy-->
Para confirmar la programación, introduzca Get-CitrixCallHomeSchedule. En el ejemplo anterior, la acción devuelve StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly.
Inhabilitar Call Home
Puede inhabilitar Call Home mediante un cmdlet de PowerShell o a través de Citrix Scout.
Los registros AOT se recopilan y guardan en el disco, incluso cuando se inhabilitan las cargas programadas de Call Home. (Cuando se inhabilitan las cargas programadas, los registros AOT no se cargan automáticamente en Citrix). Puede inhabilitar la recopilación y el almacenamiento local de los registros AOT.
Inhabilitar Call Home con PowerShell
Después de ejecutar el siguiente cmdlet, los datos de diagnóstico no se cargarán automáticamente en Citrix (puede seguir cargando datos de diagnóstico mediante Citrix Scout o cmdlets de telemetría de PowerShell).
Disable-CitrixCallHome
Para confirmar que Call Home está inhabilitado, introduzca Get-CitrixCallHome. Si se ha inhabilitado, el retorno es IsEnabled=False y IsMasterImage=False.
Inhabilitar una programación de recopilación mediante Citrix Scout
Para inhabilitar una programación de recopilación de diagnóstico mediante Citrix Scout, siga las instrucciones de Programar recopilaciones. En el paso 3, haga clic en No para cancelar la programación de las máquinas seleccionadas.
Inhabilitar la recopilación de registros AOT
Después de ejecutar el siguiente cmdlet (con el campo Enabled establecido en false), no se recopilarán los registros AOT.
Enable-CitrixTrace -Listen'{"trace":{"enabled":false,"persistDirectory":"C:\Users\Public","maxSizeBytes":1000000, "sliceDurationSeconds":300}}'
El parámetro Listen contiene argumentos en formato JSON.
Configurar un servidor proxy para cargas de Call Home
Complete las siguientes tareas en la máquina donde esté habilitado Call Home. Los diagramas de ejemplo en el siguiente procedimiento contienen el puerto y la dirección del servidor 10.158.139.37:3128. Su información será diferente.
-
Agregue información del servidor proxy a su explorador web. En Internet Explorer, seleccione Opciones de Internet > Conexiones > Configuración de LAN. Seleccione Usar un servidor proxy para la LAN e introduzca el número de puerto y la dirección del servidor proxy.
-
En PowerShell, ejecute
netsh winhttp import proxy source=ie.
-
Con un editor de texto, modifique el archivo de configuración TelemetryService.exe, que se encuentra en C:\Archivos de programa\Citrix\Telemetry Service. Agregue la información que aparece en el cuadro rojo.
-
Reinicie Telemetry Service.
Ejecute los cmdlets de Call Home en PowerShell.
Recopilar y cargar manualmente la información de diagnóstico
Puede usar el sitio web de CIS para cargar un paquete de información de diagnóstico en CIS. También puede usar cmdlets de PowerShell para recopilar y cargar la información de diagnóstico en CIS.
Para cargar un paquete mediante el sitio web de CIS:
- Inicie una sesión en Citrix Insight Services mediante las credenciales de su cuenta de Citrix.
- Seleccione My Workspace.
- Seleccione Healthcheck y vaya a la ubicación de sus datos.
CIS admite varios cmdlets de PowerShell para administrar la carga de datos. Esta documentación cubre los cmdlets de los dos casos de uso más frecuentes:
- Use el cmdlet
Start-CitrixCallHomeUploadpara recopilar y cargar manualmente un paquete de información de diagnóstico en CIS. (El paquete no se guarda localmente.) - Use el cmdlet
Start-CitrixCallHomeUploadpara recopilar manualmente un paquete de información de diagnóstico y guardarlo localmente. Esto le permite obtener una vista previa de los datos. Luego, use el cmdletSend-CitrixCallHomeBundlepara cargar manualmente una copia del paquete en CIS (los datos permanecen guardados localmente).
La ayuda de PowerShell proporciona la sintaxis completa, incluidas las descripciones de cmdlets y parámetros que no se utilizan en estos casos de uso más comunes.
Al introducir un cmdlet para cargar datos en CIS, se le pedirá que confirme la carga. Si el cmdlet excede el tiempo de espera de la operación antes de que se complete la carga, compruebe el estado de la carga en el registro de eventos del sistema. La solicitud de carga puede rechazarse si el servicio ya está realizando una carga.
Recopilar datos y cargar paquetes en CIS:
Start-CitrixCallHomeUpload [-Credential] PSCredential [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploadHeader string] [-AppendHeaders string] [-Collect string] [<CommonParameters>]
<!--NeedCopy-->
Recopilar datos para guardarlos localmente:
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploaderHeader string] [-AppendHeaders string] [-Collect strings] [<CommonParameters>]
<!--NeedCopy-->
Los siguientes parámetros son válidos:
- Credential: Dirige la carga a CIS.
- InputPath: Ubicación del archivo zip que desea incluir en el paquete. Esto puede ser algún archivo adicional que le pida Citrix Support. Asegúrese de incluir la extensión .zip.
- OutputPath: Ubicación donde se guarda la información de diagnóstico. Este parámetro es necesario cuando se guardan los datos de Call Home localmente.
- Descripción y tiempo de incidente: información de forma gratuita sobre la carga.
- SRNumber: Número de incidente de Citrix Technical Support.
- Nombre: Nombre que identifica el paquete.
- UploadHeader: Cadena en formato JSON que especifica los encabezados cargados en CIS.
- AppendHeaders: Cadena en formato JSON que especifica los encabezados anexados cargados en CIS.
-
Collect: Cadena en formato JSON que especifica qué datos hay que recopilar u omitir, con el formato {‘collector’:{‘enabled’:Boolean}}, donde Boolean es True o False. Los valores válidos de recopilador para el parámetro ‘collector’ son:
- ‘wmi’
- ‘process’
- ‘registry’
- ‘crashreport’
- ‘trace’
- ‘file’
- ‘msi’
- ‘localdata’
- ‘sitedata’
- ‘sfb’
De forma predeterminada, están habilitados todos los recopiladores salvo “sfb”.
El recopilador “sfb” está diseñado para utilizarse a petición para diagnosticar problemas de Skype Empresarial. Además del parámetro “enabled”, el recopilador ‘sfb’ admite los parámetros “account” y “accounts” para especificar usuarios de destino. Utilice uno de los formatos:
- “-Collect “{‘sfb’:{‘account’:’domain\\user1’}}”
- “-Collect “{‘sfb’:{‘accounts’:[‘domain\\\user1’, ‘domain\\\user2’]}}”
- Parámetros comunes: consulte la ayuda de PowerShell.
Cargar datos previamente guardados localmente:
Send-CitrixCallHomeBundle -Credential <PSCredentia\> -Path string [<CommonParameters>]
El parámetro Path especifica la ubicación del paquete que fue guardado previamente.
Ejemplos:
El cmdlet siguiente solicita una carga de datos de Call Home (excluyendo los datos del recopilador de WMI) en CIS. Estos datos están relacionados con los fallos de registros de los VDA de Citrix Provisioning, notificados a las 14:30 para el caso de asistencia técnica de Citrix Support número 123456. Además de los datos de Call Home, se incorpora el archivo “c:\Diagnostics\ExtraData.zip” al paquete que se carga.
C:\PS>Start-CitrixCallHomeUpload -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Registration failures with Citrix Provisioning VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"
<!--NeedCopy-->
El siguiente cmdlet guarda los datos de Call Home relacionados con el caso de asistencia técnica de Citrix Support número 223344, notificado a las 8:15 de la mañana. Los datos se guardan en el archivo mydata.zip en un recurso compartido de red. Además de los datos de Call Home, se incorporará el archivo “c:\Diagnostics\ExtraData.zip” al paquete guardado.
C:\PS>Start-CitrixCallHomeUpload -OutputPath \mynetwork\myshare\mydata.zip -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Diagnostics for incident number 223344" -IncidentTime "8:15" -SRNumber 223344
<!--NeedCopy-->
El cmdlet siguiente carga el paquete de los datos que guardó previamente.
$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \mynetwork\myshare\mydata.zip
<!--NeedCopy-->