Product Documentation

Citrix Insight Services

Feb 14, 2017

Citrix Insight Services (CIS) es la plataforma insignia de Citrix para la instrumentación, la telemetría y la generación de información de la empresa. 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 Insight Services 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:

Esta versión de XenApp y XenDesktop admite las siguientes herramientas y tecnologías.

  • Datos de análisis de instalación y actualización de XenApp y XenDesktop
  • Citrix Customer Experience Improvement Program
  • Citrix Call Home
  • Citrix Scout

Datos de análisis de instalación y actualización

Cuando se usa el programa de instalación del producto completo para implementar o actualizar los componentes de XenApp o XenDesktop, 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. Para obtener más información, consulte http://more.citrix.com/XD-INSTALLER.

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.

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

Para inhabilitar la carga automática con el comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, incluya la opción /disableexperiencemetrics.

Para habilitar la carga automática 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 http://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 de XenApp o XenDesktop (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 interrumpir su participación en el programa en cualquier momento después de crear el sitio; seleccione el nodo Configuración en el panel de navegación de Studio (ficha Asistencia para productos) y siga las instrucciones.

Al actualizar una implementación de XenApp o XenDesktop:

  • Si actualiza desde una versión que no respaldaba CEIP, se le preguntará si desea participar.
  • Si actualiza desde una versión que respaldaba CEIP y la participación en el programa ya estaba habilitada, CEIP se habilitará en el sitio actualizado.
  • Si actualiza desde una versión que respaldaba CEIP y la participación en el programa no estaba habilitada, CEIP se inhabilitará en el sitio actualizado.
  • Si actualiza desde una versión que respaldaba CEIP, pero no se conoce si la participación estaba o no habilitada, se le preguntará si desea 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 VDA para Windows.  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 carga automática de los datos de análisis de instalación o actualización (predeterminado = 1):

Ubicación: HKLM:\Software\Citrix\Telemetry\CEIP
Nombre: Enabled
Valor: 0 = inhabilitado, 1 = habilitado

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

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 el CEIP al instalar productos, componentes y tecnologías de Citrix relacionados, tales como Provisioning Services, AppDNA, Citrix License Server, Citrix Receiver para Windows, Universal Print Server y la funcionalidad 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 XenApp o XenDesktop, 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.

Call Home se ejecuta como un servicio en segundo plano con el nombre de Citrix Telemetry Service.

Para obtener más información, consulte http://more.citrix.com/XD-CALLHOME.

¿Qué datos se recopilan?

Citrix Diagnostic Facility (CDF) recopila información que puede ser útil para solucionar problemas. Call Home recopila un subconjunto de seguimientos de Citrix Diagnostic Facility 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 seguimiento permanente (Always-On Tracing o AOT). Call Home no recopilará ningún otro seguimiento 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:

  • Claves de Registro creadas por XenApp y XenDesktop en HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
  • Información de WMI (Windows Management Instrumentation) 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

La información de seguimiento se comprime tras recopilarse. El servicio Citrix Telemetry Service conserva un máximo de 10 MB de la información de seguimiento 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 seguimientos se guardan en memoria a fin de evitar operaciones IOP en las máquinas aprovisionadas.
  • El búfer de seguimiento utiliza un mecanismo circular para conservar los seguimientos en memoria.
htm

Puntos de datos clave para Call Home

Call Home recopila esos puntos de datos clave.

Resumen de configuración y administración

Puede indicar si desea o no participar en Call Home al instalar un Delivery Controller o VDA usando la interfaz gráfica del instalador del producto completo. 

Después de instalar los componentes, puede usar los cmdlets de PowerShell para:

  • Habilite cargas programadas de Call Home o cambiar la programación actual. Esto incluye habilitar cargas programadas en una imagen maestra utilizada en un catálogo de máquinas, lo que elimina la necesidad de configurar Call Home individualmente en cada una de las máquinas virtuales creadas.
  • Recopilar datos manualmente y cargarlos en CIS.
  • Recopilar datos manualmente y guardarlos localmente, y cargarlos más tarde en CIS.

Para ver la sintaxis completa de cmdlets de PowerShell, consulte la ayuda de los cmdlets.

Cuando se inscriba en cargas programadas de Call Home y cuando cargue manualmente información de diagnóstico en CIS, deberá proporcionar las credenciales de su cuenta de Citrix. CIS intercambia las credenciales por un token de carga que se utiliza para identificar el 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. 

Habilitación y configuración de cargas programadas

Puede inscribirse en cargas programadas de Call Home cuando use el asistente de instalación del producto completo, o más adelante, usando cmdlets de PowerShell. De forma predeterminada, los datos se recopilan y se cargan en CIS cada domingo alrededor de las 3:00 a. m. de la hora local. La hora de la carga es aleatoria en un máximo de dos horas intervalo respecto a la hora especificada. Esto significa que una carga programada de forma predeterminada se realiza entre 3:00 y 5:00 a. m.

Si no desea cargar paquetes de información de diagnóstico de forma programada, puede usar los cmdlets de PowerShell para recopilar y cargar datos de Call Home manualmente.

Habilitación de cargas programadas durante la instalación de componentes

Cuando use la interfaz gráfica del instalador del producto completo de XenApp y XenDesktop para instalar un Controller o un VDA, puede indicar si desea participar en cargas programadas de Call Home. De forma predeterminada, la participación está seleccionada. 

  • Si desea participar, inicie sesión en CIS con sus credenciales de cuenta de Citrix.
  • Si no desea participar (o si desea participar, pero las credenciales de cuenta de Citrix no pudieron validarse), rechace la participación en la página del asistente. Puede inscribirse más tarde, después de la configuración de un sitio, usando cmdlets de PowerShell.

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.

Habilitación de cargas programadas usando cmdlets de PowerShell

Introduzca los cmdlets siguientes para habilitar cargas programadas de paquetes de información de diagnóstico de Call Home en CIS. Si no introduce más cmdlets para una programación personalizada, se usa la programación predeterminada.

$cred = Get-Credential
Enable-CitrixCallHome -Credential $cred

Para confirmar que las cargas programadas se han habilitado, escriba Get-CitrixCallHome. Este comando debe devolver IsEnabled=True y IsMasterImage=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 -MasterImage

Para confirmar que las cargas programadas se han habilitado, escriba Get-CitrixCallHome. Este comando debe devolver IsEnabled=True y IsMasterImage=True.

Creación de una programación personalizada

Puede crear una programación semanal o diaria personalizada.

$timespan = New-TimeSpan –Hours <horas> -Minutes <minutos>
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek <día> -UploadFrequency {Daily|Weekly}

Cancelar cargas programadas

Introduzca el cmdlet siguiente para cancelar cargas programadas. (Puede seguir cargando paquetes de datos de diagnóstico mediante cmdlets de PowerShell.)

Disable-CitrixCallHome

Para confirmar que las cargas programadas se han inhabilitado, escriba Get-CitrixCallHome. Este comando debe devolver IsEnabled=False and IsMasterImage=False.

Ejemplos

El cmdlet siguiente crea una programación para crear un paquete con los datos y cargarlos a las 23:20 de la noche.  Tenga en cuenta que 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

Para confirmar la programación, introduzca Get-CitrixCallHomeSchedule. En el ejemplo anterior, debe devolver StartTime=22:20:00, DayOfWeek=Sunday (se ignora), Upload Frequency=Daily.

El cmdlet siguiente crea una programación para crear un paquete con los datos y cargarlos a las 23:20 de la noche los miércoles.  

$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly

Para confirmar la programación, introduzca Get-CitrixCallHomeSchedule. En el ejemplo anterior, debe devolver StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly. 

Configuración de un servidor proxy para cargas de Call Home

En la máquina donde está instalado Call Home, en el directorio Archivos de programa\Citrix\Telemetry Service, edite el archivo TelemetryService.exe.config, agregando la sección resaltada en amarillo del ejemplo siguiente. (El ejemplo especifica una dirección y puerto de servidor 10.158.139.37:3128; la suya puede ser diferente.)

Después de completarse la carga, usted puede ver la información de Call Home cargada en CIS.citrix.com.

localized image

Recopilación y carga manual de 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 usando el sitio Web de CIS:

  1. Inicie una sesión en Citrix Insight Services usando las credenciales de su cuenta de Citrix.
  2. Seleccione My Workspace.
  3. 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-CitrixCallHomeUpload para recopilar y cargar manualmente un paquete de información de diagnóstico en CIS. (El paquete no se guarda localmente.)
  • Use el cmdlet Start-CitrixCallHomeUpload para recopilar manualmente un paquete de información de diagnóstico y guardarlo localmente. Esto le permite obtener una vista previa de los datos. Posteriormente, use el cmdlet Send-CitrixCallHomeBundle para cargar 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á ejecutando una carga.

Recopilación de datos y carga de paquetes en CIS

Start-CitrixCallHomeUpload [-Credential] <PSCredential> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploadHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]

Recopilación de datos para guardarlos localmente

Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploaderHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]

Parámetro

Descripción

Credencial

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 guardará la información de diagnóstico. Este parámetro es necesario cuando se guardan los datos de Call Home localmente.

Hora del incidente y descripción

Información en formato libre 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'
  • '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 "account" 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 <PSCredential> -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 tienen relación con los fallos de registros de VDA de PVS, notificados a las 2:30 p.m. para el caso de asistencia de Citrix Support número 123456. Además de los datos de Call Home, se incorporará el archivo "c:\Diagnostics\ExtraData.zip" al paquete que se carga.

C:\PS>Start-CitrixCallHomeUpload -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Registration failures with PVS VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"

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 a.m. 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

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

Citrix Scout

Citrix Scout es el predecesor de Call Home. Captura y envía puntos de datos clave y seguimientos de CDF. Consulte CTX130147 para obtener más información acerca de Citrix Scout.

Puede descargar el software de Citrix Scout desde ese artículo. El software también está disponible en la imagen ISO de XenApp y XenDesktop.