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

Las funciones que ofrece Citrix Insight Services aumentan y evolucionan cada vez, y ahora forman parte de Citrix Smart Tools. Citrix Smart Tools permite automatizar las tareas de implementación, las comprobaciones de estado y la administración de energía. Para obtener información sobre las tecnologías, consulte la documentación de Citrix Smart Tools.

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:

Esta versión de Citrix Virtual Apps and Desktops admite las siguientes herramientas y tecnologías.

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 esta configuración 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 inhabilita la recopilación y la carga.

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 o Citrix Virtual 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. Para obtener más información, consulte https://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.

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
    
  • 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 Configuración en el panel de navegación de Studio. A continuación, seleccione la ficha Asistencia para productos y siga las instrucciones.

Cuando se actualiza una implementación de Citrix Virtual Apps and Desktops:

  • 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 inscripción automática en CEIP (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

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 Smart Check

Puede habilitar Smart Check (que forma parte de Smart Tools) cuando instala un Delivery Controller.

Smart Check permite realizar comprobaciones de estado periódicas en su entorno Citrix. Smart Check ayuda a buscar problemas y solucionarlos antes de que los usuarios se vean afectados. Con Smart Check, puede:

  • Programar y ejecutar una amplia variedad de controles de estado en su sitio.
  • Conocer cualquier problema potencial de estado que afecte a su sitio.
  • Buscar las correcciones y las actualizaciones recomendadas para los Delivery Controllers y los catálogos de máquinas que haya en su sitio.
  • Cargar los diagnósticos del sitio y compartirlos con la asistencia de Citrix para que los analicen.
  • Ver informes completos sobre el estado de su sitio.

La opción para habilitar el acceso a Citrix Smart Tools (y participar en Call Home, si no está ya habilitado) está marcada de forma predeterminada. Haga clic en Conectar. Se abre una ventana de explorador Web y va automáticamente a la página Web de Smart Services, donde puede introducir sus credenciales de cuenta de Citrix Cloud. (Si no dispone de una cuenta de Citrix Cloud, simplemente introduzca las credenciales de cuenta de Citrix y se creará automáticamente una nueva cuenta de Citrix Cloud.) Después de autenticarse, se instala silenciosamente un certificado en el directorio Smart Tools Agent.

Para usar las tecnologías de Smart Tools, consulte la documentación de Citrix Smart Tools.

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 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:

  • Entradas de Registro creadas por Citrix Virtual Apps and Desktops 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 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 esos 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.

Requisitos previos

  • La máquina debe estar ejecutando PowerShell 3.0 o posterior.
  • La máquina debe estar ejecutando el servicio Citrix Telemetry Service.
  • La variable del sistema PSModulePath debe 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 del Controller: Cuando instala o actualiza un Controller desde la interfaz gráfica, se le pregunta si quiere participar en Call Home y conectarse a Citrix Smart Tools. Existen tres opciones:

  • Conectar con Citrix Smart Tools, lo que incluye la funcionalidad Call Home vía Smart Tools Agent. Esta es la opción predeterminada y recomendada. Si elige esta opción, se configura el agente Smart Tools. (El agente Smart Tools se instala independientemente de si se selecciona esta opción.)
  • Participar solo en Call Home, pero no conectar con Smart Tools. Si elige esta opción, el agente Smart Tools se instala, pero no se configura. La funcionalidad Call Home se proporciona a través de Citrix Telemetry Service y Citrix Insight Services.
  • No conectar con Smart Tools ni participar en Call Home.

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, la página le preguntará solo sobre Smart Tools. Si ya está inscrito en Call Home y el agente Smart Tools ya está instalado, no aparecerá la página del asistente.

Para obtener más información acerca de Smart Tools, consulte la documentación de Smart Tools.

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

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: 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}

Cancelar cargas programadas: Después de cancelar las cargas programadas, aún puede cargar 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.

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.

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

  2. En PowerShell, ejecute netsh winhttp import proxy source=ie.

    Ejemplo de cómo ejecutar el comando 'netsh' al configurar un servidor proxy

  3. 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 este cuadro rojo.

    Agregar información de proxy al archivo TelemetryService.exe

  4. Reinicie el servicio de telemetría.

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

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>]

Recopilar 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>]

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 guardará 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.
  • SRNumbwe: 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.
  • Recopilar: 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 “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 VDA de Citrix Provisioning, notificados a las 2:30 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 Citrix Provisioning 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 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

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