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) autodiagnosticar y solucionar problemas, y optimizar sus entornos. Para obtener detalles y la información más reciente sobre CIS y cómo funciona, consulta https://cis.citrix.com (se requieren credenciales de cuenta de Citrix).
Toda la información cargada a Citrix se usa para fines de solución de problemas y diagnóstico, y para mejorar la calidad, fiabilidad y rendimiento de los productos, sujeta a:
- La Política de Citrix Insight Services en https://cis.citrix.com/legal
- La Política de privacidad de Citrix en https://www.cloud.com/privacy-policy
Esta versión de Citrix Virtual Apps and Desktops™ es compatible con las siguientes tecnologías.
- Análisis de instalación y actualización de Citrix Virtual Apps™ and Desktops
- Programa de mejora de la experiencia del cliente de Citrix (CEIP)
- Citrix Call Home
- Citrix Scout
Además de (y por separado de) CIS y Citrix Analytics: Google Analytics se recopila (y se carga posteriormente) automáticamente al instalar (o actualizar) Studio. Después de instalar Studio, puedes cambiar esta configuración con la clave de registro HKLM\Software\Citrix\DesktopStudio\GAEnabled. Un valor de 1 habilita la recopilación y la carga, 0 deshabilita la recopilación y la carga.
Análisis de instalación y actualización
Cuando usas el instalador completo del producto 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 almacena en la máquina donde estás instalando o actualizando el componente. Estos datos se usan para ayudar a Citrix a mejorar las experiencias 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 tanto en las interfaces gráficas como en las de línea de comandos del instalador completo del producto.
- Puedes cambiar el valor predeterminado en una configuración del registro. Si cambias la configuración del registro antes de instalar o actualizar, ese valor se usará cuando utilices el instalador completo del producto.
- Puedes anular la configuración predeterminada si instalas o actualizas con la interfaz de línea de comandos especificando una opción con el comando.
Controlar las cargas automáticas:
-
Configuración del registro que controla la carga automática de análisis de instalación/actualización (predeterminado = 1):
- Ubicación: HKLM:\Software\Citrix\MetaInstall
- Nombre: SendExperienceMetrics
- Valor: 0 = deshabilitado, 1 = habilitado
-
Con PowerShell, el siguiente cmdlet deshabilita la carga automática de análisis de instalación/actualización:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0 <!--NeedCopy--> -
Para deshabilitar las cargas automáticas con el comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, incluye la opción
/disableexperiencemetrics.Para habilitar las cargas automáticas con el comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, incluye la opción
/sendexperiencemetrics.
Programa de mejora de la experiencia del cliente de Citrix
Cuando participas en el Programa de mejora de la experiencia del cliente de Citrix (CEIP), se envían estadísticas anónimas e información de uso a Citrix para ayudar a Citrix a mejorar la calidad y el rendimiento de los productos de Citrix. Para obtener más información, consulta https://www.citrix.com/community/cx/ceip.html?utm_source=more.citrix.com/XD-CEIP&utm_medium=Vanity+Url.
Inscripción durante la creación o actualización del sitio
Te inscribes automáticamente en CEIP cuando creas un sitio (después de instalar el primer Delivery Controller™). La primera carga de datos ocurre aproximadamente siete días después de crear el sitio.
Puedes detener tu participación en cualquier momento después de crear el sitio. Selecciona el nodo Configuración en el panel izquierdo de Web Studio y desactiva la configuración Programa de mejora de la experiencia del cliente de Citrix.
Cuando actualizas una implementación de Citrix Virtual Apps and Desktops:
- Si actualizas desde una versión que no era compatible con CEIP, se te preguntará si deseas participar.
- Si actualizas desde una versión compatible con CEIP y la participación estaba habilitada, CEIP se habilitará en el sitio actualizado.
- Si actualizas desde una versión compatible con CEIP y la participación estaba deshabilitada, CEIP se deshabilitará en el sitio actualizado.
- Si actualizas desde una versión compatible con CEIP y la participación es desconocida, se te preguntará si deseas participar.
La información recopilada es anónima, por lo que no se puede ver después de cargarla en Citrix Insight Services.
Inscripción al instalar un VDA
De forma predeterminada, te inscribes automáticamente en CEIP cuando instalas un VDA de Windows. Puedes cambiar este valor predeterminado en una configuración del registro. Si cambias la configuración del registro antes de instalar el VDA, ese valor se usará.
Configuración del registro que controla la inscripción automática en CEIP (predeterminado = 1):
Ubicación: HKLM: \Software\Citrix\Telemetry\CEIP Nombre: Enabled Valor: 0 = deshabilitado, 1 = habilitado
De forma predeterminada, la propiedad Enabled está oculta en el registro. Cuando no se especifica, la función de carga automática está habilitada.
Con PowerShell, el siguiente cmdlet deshabilita la inscripción en CEIP:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
<!--NeedCopy-->
Los puntos de datos de tiempo de ejecución recopilados se escriben periódicamente como archivos en una carpeta de salida (predeterminado %programdata%/Citrix/VdaCeip).
La primera carga de datos ocurre aproximadamente siete días después de instalar el VDA.
Inscripción al instalar otros productos y componentes
También puedes participar en CEIP al instalar productos, componentes y tecnologías de Citrix relacionados, como Citrix Provisioning™, AppDNA, Citrix License Server, la aplicación Citrix Workspace™ para Windows, Universal Print Server y Session Recording. Consulta su documentación para obtener detalles sobre la instalación y los valores predeterminados de participación.
Citrix Call Home
Cuando instalas ciertos componentes y funciones en Citrix Virtual Apps and Desktops, se te ofrece la oportunidad de participar en Citrix Call Home. Call Home recopila datos de diagnóstico y luego carga periódicamente paquetes de telemetría que contienen esos datos directamente a Citrix Insight Services (a través de HTTPS en el puerto predeterminado 443) para análisis y solución de problemas.
En Citrix Virtual Apps and Desktops, Call Home se ejecuta como un servicio en segundo plano bajo el nombre Citrix Telemetry Service.
La funcionalidad de programación de Call Home también está disponible en Citrix Scout. Para obtener más detalles, consulta Citrix Scout.
Qué se recopila
Citrix Diagnostic Facility (CDF) rastrea la información que puede ser útil para la solución de problemas. Call Home recopila un subconjunto de rastreos de CDF que pueden ser útiles al solucionar problemas comunes, por ejemplo, registros de VDA e inicios de aplicaciones/escritorios. Esta tecnología se conoce como rastreo siempre activo (AOT). Los registros AOT se guardan en el disco en C:\ProgramData\Citrix\TelemetryService\CitrixAOT.
Nota:
La carpeta
ProgramDataestá oculta. Para revelarla, haz clic en Ver > Mostrar > Elementos ocultos.
Call Home no recopila ninguna otra información de Event Tracing for Windows (ETW), ni se puede configurar para hacerlo.
Call Home también recopila otra información, como:
- Registros creados por Citrix Virtual Apps and Desktops en
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix. - Información de Windows Management Instrumentation (WMI) en el espacio de nombres de Citrix.
- Lista de procesos en ejecución.
- Volcados de memoria de procesos de Citrix que se almacenan en %PROGRAM DATA%\Citrix\CDF.
- Información de instalación y actualización. Esto puede incluir el registro completo del metainstalador del producto, registros MSI fallidos, la salida del analizador de registros MSI, registros de StoreFront™, registros de comprobación de compatibilidad de licencias y resultados de pruebas preliminares de actualización del sitio.
La información de seguimiento se comprime a medida que se recopila. El Servicio de telemetría de Citrix retiene un máximo de 10 MB de información de seguimiento reciente comprimida, con un límite de tiempo máximo de ocho días.
- La compresión de datos permite a Call Home mantener una huella pequeña en el VDA.
- Los seguimientos se mantienen en la memoria para evitar operaciones de E/S en máquinas aprovisionadas.
- El búfer de seguimiento utiliza un mecanismo circular para retener los seguimientos en la memoria.
Call Home recopila los puntos de datos clave enumerados en Puntos de datos clave de Call Home.
Configurar y administrar resumen
Puedes inscribirte en Call Home al usar el asistente de instalación del producto completo o más tarde, mediante cmdlets de PowerShell. Cuando te inscribes, por defecto, los diagnósticos se recopilan y se cargan a Citrix cada domingo aproximadamente a las 3:00 AM, hora local. La carga se aleatoriza con un intervalo de dos horas a partir de la hora especificada. Esto significa que una carga que utiliza la programación predeterminada ocurre entre las 3:00 AM y las 5:00 AM.
Si no quieres cargar información de diagnóstico de forma programada (o si quieres cambiar una programación), puedes usar cmdlets de PowerShell para recopilar y cargar diagnósticos manualmente o almacenarlos localmente.
Cuando te inscribes en las cargas programadas de Call Home y cuando cargas manualmente información de diagnóstico a Citrix, proporcionas credenciales de la 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 se produce una carga, se envía una notificación por correo electrónico a la dirección asociada con la cuenta de Citrix.
Si habilitas Call Home al instalar un componente, puedes deshabilitarlo más tarde.
Requisitos previos
- La máquina debe ejecutar PowerShell 3.0 o posterior.
- El Servicio de telemetría de Citrix debe estar ejecutándose en la máquina.
- La variable de sistema
PSModulePathdebe estar configurada en la ruta de instalación de Telemetry, por ejemplo, C:\Program Files\Citrix\Telemetry Service\.
Habilitar Call Home durante la instalación del componente
Durante la instalación o actualización del VDA: Cuando instalas o actualizas un Virtual Delivery Agent usando la interfaz gráfica en el instalador del producto completo, se te pregunta si quieres participar en Call Home. Hay dos opciones:
- Participar en Call Home.
- No participar en Call Home.
Si estás actualizando un VDA y te inscribiste previamente en Call Home, esa página del asistente no aparece.
Durante la instalación o actualización del Controller: Cuando instalas o actualizas un Delivery Controller usando la interfaz gráfica, se te pregunta si quieres participar en Call Home. Hay tres opciones:
Cuando estás instalando un Controller, no puedes configurar información en la página de Call Home del asistente de instalación si ese servidor tiene una GPO de Active Directory con la configuración de política “Iniciar sesión como servicio” aplicada. Para obtener más detalles, consulta CTX218094.
Si estás actualizando un Controller y te inscribiste previamente en Call Home, no se te preguntará sobre la participación.
Cmdlets de PowerShell
La ayuda de PowerShell proporciona una sintaxis completa, incluidas descripciones de cmdlets y parámetros que no se utilizan en estos casos de uso comunes.
Para usar un servidor proxy para las cargas, consulta Configurar un servidor proxy.
-
Habilitar cargas programadas: Las recopilaciones de diagnósticos se cargan automáticamente a Citrix. Si no introduces cmdlets adicionales para una programación personalizada, se utiliza la programación predeterminada.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred <!--NeedCopy-->Para confirmar que las cargas programadas están habilitadas, introduce
Get-CitrixCallHome. Si están habilitadas, el resultado esIsEnabled=TrueyIsMasterImage=False. -
Habilitar cargas programadas para máquinas creadas a partir de una imagen maestra: Habilitar las cargas programadas en una imagen maestra elimina la necesidad de configurar cada máquina que se crea en el catálogo de máquinas.
Enable-CitrixCallHome -Credential $cred -MasterImagePara confirmar que las cargas programadas están habilitadas, introduce Get-CitrixCallHome. Si están habilitadas, el resultado es
IsEnabled=TrueyIsMasterImage=True. -
Crear una programación personalizada: Crea una programación diaria o semanal para las 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 siguiente cmdlet crea una programación para agrupar y cargar datos a las 22:20 cada noche. El parámetro Hours utiliza un reloj de 24 horas. Cuando el valor del parámetro UploadFrequency es Daily, el parámetro DayOfWeek se ignora, si se especifica.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
<!--NeedCopy-->
Para confirmar la programación, introduce Get-CitrixCallHomeSchedule. En el ejemplo anterior, devuelve StartTime=22:20:00, DayOfWeek=Sunday (ignored), Upload Frequency=Daily.
El siguiente cmdlet crea una programación para agrupar y cargar datos a las 22:20 cada miércoles por la noche.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
<!--NeedCopy-->
Para confirmar la programación, introduce Get-CitrixCallHomeSchedule. En el ejemplo anterior, devuelve StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly.
Deshabilitar Call Home
Puedes deshabilitar Call Home usando un cmdlet de PowerShell o a través de Citrix Scout.
Los registros AOT se recopilan y guardan en el disco, incluso cuando las cargas programadas de Call Home están deshabilitadas. (Cuando las cargas programadas están deshabilitadas, los registros AOT no se cargan automáticamente a Citrix). Puedes deshabilitar la recopilación y el almacenamiento local de los registros AOT.
Deshabilitar Call Home con PowerShell
Después de ejecutar el siguiente cmdlet, los datos de diagnóstico no se cargarán a Citrix automáticamente. (Aún puedes cargar datos de diagnóstico usando Citrix Scout o los cmdlets de PowerShell de telemetría).
Disable-CitrixCallHome
Para confirmar que Call Home está deshabilitado, introduce Get-CitrixCallHome. Si está deshabilitado, el resultado es IsEnabled=False e IsMasterImage=False.
Deshabilitar una programación de recopilación con Citrix Scout
Para deshabilitar una programación de recopilación de diagnósticos con Citrix Scout, sigue las indicaciones en Programar recopilaciones. En el paso 3, haz clic en Desactivar para cancelar la programación de las máquinas seleccionadas.
Deshabilitar 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 las cargas de Call Home
Completa las siguientes tareas en la máquina donde Call Home está habilitado. Los diagramas de ejemplo del siguiente procedimiento contienen la dirección del servidor y el puerto 10.158.139.37:3128. Tu información será diferente.
-
Agrega la información del servidor proxy en tu navegador. En Internet Explorer, selecciona Opciones de Internet > Conexiones > Configuración de LAN. Selecciona Usar un servidor proxy para la LAN e introduce la dirección del servidor proxy y el número de puerto.
-
En PowerShell, ejecuta
netsh winhttp import proxy source=ie.
-
Con un editor de texto, modifica el archivo de configuración TelemetryService.exe, que se encuentra en C:\Program Files\Citrix\Telemetry Service. Agrega la información que se muestra en el cuadro rojo.
-
Reinicia el servicio de telemetría.
Ejecuta los cmdlets de Call Home en PowerShell.
Recopilar y cargar manualmente información de diagnóstico
Puedes usar el sitio web de CIS para cargar un paquete de información de diagnóstico a CIS. También puedes usar cmdlets de PowerShell para recopilar y cargar información de diagnóstico a CIS.
Para cargar un paquete con el sitio web de CIS:
- Inicia sesión en Citrix Insight Services con tus credenciales de cuenta de Citrix.
- Selecciona Mi espacio de trabajo.
- Selecciona Healthcheck y, a continuación, navega hasta la ubicación de tus datos.
CIS admite varios cmdlets de PowerShell que administran las cargas de datos. Esta documentación cubre los cmdlets para dos casos comunes:
- Usa el cmdlet
Start-CitrixCallHomeUploadpara recopilar y cargar manualmente un paquete de información de diagnóstico a CIS. (El paquete no se guarda localmente). - Usa el cmdlet
Start-CitrixCallHomeUploadpara recopilar datos manualmente y almacenar un paquete de información de diagnóstico localmente. Esto te permite previsualizar los datos. Más tarde, usa el cmdletSend-CitrixCallHomeBundlepara cargar manualmente una copia de ese paquete a CIS. (Los datos que guardaste originalmente permanecen localmente).
La ayuda de PowerShell proporciona una sintaxis completa, incluidas descripciones de cmdlets y parámetros que no se usan en estos casos de uso comunes.
Cuando introduces un cmdlet para cargar datos a CIS, se te pide que confirmes la carga. Si el cmdlet agota el tiempo de espera antes de que se complete la carga, comprueba el estado de la carga en el registro de eventos del sistema. La solicitud de carga podría ser rechazada si el servicio ya está realizando una carga.
Recopilar datos y cargar el paquete a 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 y 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 se incluirá en el paquete. Este podría ser un archivo adicional que el Soporte de Citrix solicite. Asegúrate de incluir la extensión .zip.
- OutputPath: Ubicación donde se guarda la información de diagnóstico. Este parámetro es obligatorio al guardar datos de Call Home localmente.
- Description e Incident Time: Información de formato libre sobre la carga.
- SRNumber: Número de incidente del Soporte técnico de Citrix.
- Name: Nombre que identifica el paquete.
- UploadHeader: Cadena en formato JSON que especifica los encabezados de carga subidos a CIS.
- AppendHeaders: Cadena en formato JSON que especifica los encabezados anexados subidos a CIS.
-
Collect: Cadena en formato JSON que especifica qué datos recopilar u omitir, en el formato {‘collector’:{‘enabled’:Boolean}}, donde Boolean es true o false. Los valores de recopilador válidos son:
- ‘wmi’
- ‘process’
- ‘registry’
- ‘crashreport’
- ‘trace’
- ‘file’
- ‘msi’
- ‘localdata’
- ‘sitedata’
- ‘sfb’
De forma predeterminada, todos los recopiladores, excepto ‘sfb’, están habilitados.
El recopilador ‘sfb’ está diseñado para usarse bajo demanda 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. Usa una de las siguientes formas:
- “-Collect “{‘sfb’:{‘account’:’domain\\user1’}}”
- “-Collect “{‘sfb’:{‘accounts’:[‘domain\\user1’, ‘domain\\user2’]}}”
- Common Parameters: Consulta la ayuda de PowerShell.
Cargar datos que se guardaron previamente localmente:
Send-CitrixCallHomeBundle -Credential <PSCredentia\> -Path string [<CommonParameters>]
El parámetro Path especifica la ubicación del paquete guardado previamente.
Ejemplos:
El siguiente cmdlet solicita una carga de datos de Call Home (excluyendo datos del recopilador WMI) a CIS. Estos datos se relacionan con fallos de registro de VDA de Citrix Provisioning, que se observaron a las 14:30 para el caso de Soporte de Citrix 123456. Además de los datos de Call Home, el archivo “c:\Diagnostics\ExtraData.zip” se incorpora al paquete cargado.
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 datos de Call Home relacionados con el caso de Soporte de Citrix 223344, observado a las 8:15. Los datos se guardan en el archivo mydata.zip en un recurso compartido de red. Además de los datos de Call Home, el archivo “c:\Diagnostics\ExtraData.zip” se incorporará 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 siguiente cmdlet carga el paquete de datos que guardaste anteriormente.
$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \\mynetwork\myshare\mydata.zip
<!--NeedCopy-->