Product Documentation

Citrix Insight Services

Jul 07, 2016

Citrix Insight Services (CIS) es la plataforma principal de Citrix para tareas de diagnóstico y solución de problemas. Esta plataforma permite que los usuarios técnicos (clientes, socios e ingenieros) diagnostiquen y solucionen problemas por si mismos al tiempo que optimizan sus entornos. 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

Cuando se usa el programa completo de instalación del producto 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. El equipo de asistencia técnica puede pedirle que cargue esta información en Citrix, lo que ayudará a Citrix a mejorar la experiencia de instalación de sus clientes.

La información se almacena localmente en %ProgramData%\Citrix. 

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.

Al crear un sitio de XenApp o XenDesktop queda inscrito automáticamente en el programa CEIP. 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.

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 de 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.

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.

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 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. Citrix Telemetry Service conserva aproximadamente 20 MB de datos de seguimiento comprimidos. Normalmente, estos datos contienen información de las 24-48 horas previas, en función del volumen del seguimiento generado durante ese intervalo.

  • 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.

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.

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-Credentials
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 -Minutes
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek -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 11.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 11.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.

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] [-InputPath ] [-Description ] [-IncidentTime ] [-SRNumber ] [-Name ] [-UploadHeader ] [-AppendHeaders ] [-Collect ] []

Recopilación de datos para guardarlos localmente

Start-CitrixCallHomeUpload -OutputPath [-InputPath ] [-Description ] [-IncidentTime ] [-SRNumber ] [-Name ] [-UploaderHeader ] [-AppendHeaders ] [-Collect ] []

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'

Si este parámetro se omite, se recopilan datos de todos los recopiladores.

Parámetros comunes

Consulte la ayuda de PowerShell.

Cargar datos previamente guardados localmente

Send-CitrixCallHomeBundle -Credential -Path []

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