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, consulte https://cis.citrix.com (se requieren credenciales de cuenta de Citrix).
Las funciones que ofrecen los Servicios de Citrix Insight siguen creciendo y evolucionando, y ahora forman parte integral de Citrix Smart Tools. Citrix Smart Tools le permite automatizar tareas de implementación, comprobaciones de estado y 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 cargada en Citrix se utiliza para fines de solución de problemas y diagnóstico, así como para mejorar la calidad, la fiabilidad y el rendimiento de los productos, sujeta a:
- Política de servicios de Citrix Insight en https://cis.citrix.com/legal
- Política de privacidad de Citrix en https://www.citrix.com/about/legal/privacy.html
Esta versión de XenApp y XenDesktop® es compatible con las siguientes herramientas y tecnologías.
- Análisis de instalación y actualización de XenApp® y XenDesktop
- Programa de mejora de la experiencia del cliente de Citrix
- Citrix Smart Tools
- Citrix Call Home (parte de Citrix Smart Tools)
- Citrix Scout
Análisis de instalación y actualización
Cuando utiliza el instalador del producto completo para implementar o actualizar componentes de XenApp o XenDesktop, se recopila información anónima sobre el proceso de instalación y se almacena en la máquina donde está instalando/actualizando el componente. Estos datos se utilizan 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.
- Puede cambiar el valor predeterminado en una configuración del Registro. Si cambia la configuración del Registro antes de la instalación o actualización, ese valor se utilizará cuando use el instalador completo del producto.
- Puede anular la configuración predeterminada si instala o actualiza con la interfaz de línea de comandos especificando una opción con el comando.
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
Para deshabilitar 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.
Citrix Customer Experience Improvement Program (CEIP)
Cuando participa en el Citrix Customer Experience Improvement Program (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, consulte https://more.citrix.com/XD-CEIP.
Inscripción durante la creación o actualización del sitio
Se inscribe automáticamente en CEIP cuando crea un sitio de XenApp o XenDesktop (después de instalar el primer Delivery Controller™). La primera carga de datos se produce aproximadamente siete días después de crear el sitio. Puede detener su participación en cualquier momento después de crear el sitio; seleccione el nodo Configuration en el panel de navegación de Studio (ficha Product Support) y siga las instrucciones.
Cuando actualiza una implementación de XenApp o XenDesktop:
- Si actualiza desde una versión que no admitía CEIP, se le preguntará si desea participar.
- Si actualiza desde una versión que admitía CEIP y la participación estaba habilitada, CEIP se habilitará en el Site actualizado.
- Si actualiza desde una versión que admitía CEIP y la participación estaba inhabilitada, CEIP se inhabilitará en el Site actualizado.
- Si actualiza desde una versión que admitía CEIP y la participación es desconocida, se le preguntará si desea participar.
La información recopilada es anónima, por lo que no se puede ver después de subirla a Citrix Insight Services.
Inscripción al instalar un VDA
De forma predeterminada, se inscribe automáticamente en CEIP al instalar un VDA de Windows. Puede cambiar esta configuración predeterminada en un valor del Registro. Si cambia el valor del Registro antes de instalar el VDA, se utilizará ese valor.
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 = inhabilitado, 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.
Mediante PowerShell, el siguiente cmdlet inhabilita la inscripción en CEIP:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
Los puntos de datos de tiempo de ejecución recopilados se escriben periódicamente como archivos en una carpeta de salida (predeterminada %programdata%/Citrix/VdaCeip).
La primera carga de datos se produce 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 productos, componentes y tecnologías de Citrix relacionados, como Provisioning Services, AppDNA, Citrix License Server, Citrix Receiver™ para Windows, Universal Print Server y Session Recording. Consulte su documentación para obtener detalles sobre la instalación y los valores predeterminados de participación.
Citrix Smart Tools
Puede habilitar el acceso a Smart Tools al instalar un Delivery Controller.
La opción de habilitar el acceso a Smart Tools (y participar en Call Home, si aún no está habilitado) está seleccionada de forma predeterminada. Haga clic en Conectar. Se abre una ventana del explorador y navega automáticamente a una página web de Smart Services, donde introduce sus credenciales de cuenta de Citrix Cloud™. (Si no tiene una cuenta de Citrix Cloud, simplemente introduzca sus credenciales de cuenta de Citrix, y se creará automáticamente una nueva cuenta de Citrix Cloud para usted.) Después de autenticarse, se instala un certificado de forma silenciosa en el directorio del agente de Smart Tools.
Para usar las tecnologías de Smart Tools, consulte la documentación de Smart Tools.
Citrix Call Home
Al instalar ciertos componentes y funciones en XenApp o XenDesktop, se le ofrece la oportunidad de participar en Citrix Call Home. Call Home recopila datos de diagnóstico y, a continuación, carga periódicamente paquetes de telemetría que contienen esos datos directamente en Citrix Insight Services (a través de HTTPS en el puerto predeterminado 443) para su análisis y solución de problemas.
En XenApp y XenDesktop, Call Home se ejecuta como un servicio en segundo plano bajo 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é se recopila
El rastreo de Citrix Diagnostic Facility (CDF) registra 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). 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 XenApp y XenDesktop 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
La información de rastreo 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 rastreo 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 rastreos se mantienen en la memoria para evitar operaciones de E/S en las máquinas aprovisionadas.
- El búfer de rastreo utiliza un mecanismo circular para retener los rastreos en la memoria.
Call Home recopila estos puntos de datos clave: Puntos de datos clave de Call Home
Resumen de configuración y administración
Puede inscribirse en Call Home al usar el asistente de instalación del producto completo o más tarde, mediante cmdlets de PowerShell. Cuando se inscribe, de forma predeterminada, los diagnósticos se recopilan y se cargan en Citrix todos los domingos 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 se produce entre las 3:00 AM y las 5:00 AM.
Si no desea cargar información de diagnóstico de forma programada (o si desea cambiar una programación), puede usar cmdlets de PowerShell para recopilar y cargar diagnósticos manualmente o almacenarlos localmente.
Cuando se inscribe en las cargas programadas de Call Home y cuando carga manualmente información de diagnóstico en Citrix, proporciona credenciales de 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.
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 PSModulePath debe establecerse 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 de VDA: Cuando instala o actualiza un Agente de entrega virtual mediante la interfaz gráfica del instalador completo del producto, se le pregunta si desea participar en Call Home. Hay dos opciones:
- Participar en Call Home.
- No participar en Call Home.
Si está actualizando un VDA y se inscribió previamente en Call Home, esa página del asistente no aparecerá.
Durante la instalación o actualización del Controller: Cuando instala o actualiza un Delivery Controller mediante la interfaz gráfica, se le pregunta si desea participar en Call Home y conectarse a Citrix Smart Tools. Hay tres opciones:
- Conectarse a Citrix Smart Tools, que incluye la funcionalidad de Call Home a través del agente de Smart Tools. Esta es la opción predeterminada y recomendada. Si elige esta opción, el agente de Smart Tools se configura. (El agente de Smart Tools se instala, independientemente de si se selecciona esta opción).
- Participar solo en Call Home, pero no conectarse a Smart Tools. Si elige esta opción, el agente de Smart Tools se instala, pero no se configura. La funcionalidad de Call Home se proporciona a través de Citrix Telemetry Service y Citrix Insight Services.
- No conectarse a Smart Tools ni participar en Call Home.
Cuando instale un Controller, no podrá configurar la información en la página de Call Home del asistente de instalación si ese servidor tiene aplicada una GPO de Active Directory con la configuración de directiva “Iniciar sesión como servicio”. Para obtener más información, consulte CTX218094.
Si está actualizando un Controller y se inscribió previamente en Call Home, la página solo preguntará sobre Smart Tools. Si ya está inscrito en Call Home y el Agente Smart ya está instalado, la página del asistente no aparecerá.
Para obtener información sobre Smart Tools, consulte la documentación de Smart Tools.
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, consulte Configurar un servidor proxy.
Habilitar cargas programadas
Las recopilaciones de diagnósticos se cargan automáticamente en Citrix. Si no introduce cmdlets adicionales para una programación personalizada, se utiliza la programación predeterminada.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
Para confirmar que las cargas programadas están habilitadas, introduzca Get-CitrixCallHome. Debería devolver IsEnabled=True e IsMasterImage=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 -MasterImage
Para confirmar que las cargas programadas están habilitadas, introduzca Get-CitrixCallHome. Debería devolver IsEnabled=True e IsMasterImage=True.
Crear una programación personalizada
Cree una programación diaria o semanal para las recopilaciones y cargas de diagnósticos.
$timespan = New-TimeSpan –Hours <horas> -Minutes <minutos> Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek <día> -UploadFrequency {Diario|Semanal}
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 están deshabilitadas, introduzca Get-CitrixCallHome. Debería devolver IsEnabled=False e IsMasterImage=False.
Ejemplos
El siguiente cmdlet crea una programación para agrupar y cargar datos a las 11:20 cada noche. Tenga en cuenta que 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 Diario
Para confirmar la programación, introduzca Get-CitrixCallHomeSchedule. En el ejemplo anterior, debería devolver StartTime=22:20:00, DayOfWeek=Sunday (ignorado), Upload Frequency=Daily.
El siguiente cmdlet crea una programación para agrupar y cargar datos a las 11:20 cada miércoles por la noche.
$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, debería devolver StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly.
Configurar un servidor proxy para las cargas de Call Home
Complete las siguientes tareas en la máquina donde Call Home está habilitado. Los diagramas de ejemplo en el siguiente procedimiento contienen la dirección del servidor y el puerto 10.158.139.37:3128. Su información será diferente.
Paso 1. Agregue la información del servidor proxy en su navegador. En Internet Explorer, seleccione Opciones de Internet > Conexiones > Configuración de LAN. Seleccione Usar un servidor proxy para su LAN y escriba la dirección del servidor proxy y el número de puerto.
Paso 2. En PowerShell, ejecute netsh winhttp import proxy source=ie.
Paso 3. Con un editor de texto, edite el archivo de configuración TelemetryService.exe, que se encuentra en C:\Program Files\Citrix\Telemetry Service. Agregue la información que se muestra en el cuadro rojo a continuación.
Paso 4. Reinicie el servicio de telemetría.
Ejecute los cmdlets de Call Home en PowerShell.
Recopilar y cargar manualmente información de diagnóstico
Puede usar el sitio web de CIS para cargar un paquete de información de diagnóstico a CIS. También puede usar cmdlets de PowerShell para recopilar y cargar información de diagnóstico a CIS.
Para cargar un paquete mediante el sitio web de CIS:
- Inicie sesión en Citrix Insight Services con sus credenciales de cuenta de Citrix.
- Seleccione My Workspace.
- Seleccione Healthcheck y, a continuación, vaya a la ubicación de sus datos.
CIS admite varios cmdlets de PowerShell que administran las cargas de datos. Esta documentación cubre los cmdlets para dos casos comunes:
- Use el cmdlet Start-CitrixCallHomeUpload para recopilar y cargar manualmente un paquete de información de diagnóstico a CIS. (El paquete no se guarda localmente).
- Use el cmdlet Start-CitrixCallHomeUpload para recopilar datos manualmente y almacenar un paquete de información de diagnóstico localmente. Esto le permite previsualizar los datos. Luego, en un momento posterior, use el cmdlet Send-CitrixCallHomeBundle para cargar manualmente una copia de ese paquete a CIS. (Los datos que guardó originalmente permanecen localmente).
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.
Cuando introduce un cmdlet para cargar datos a CIS, se le pide que confirme la carga. Si el cmdlet agota el tiempo de espera 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 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>]
Recopilar datos y 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 se incluirá en el paquete. Puede ser un archivo adicional que solicite el Soporte de Citrix. Asegúrese de incluir la extensión .zip. |
| OutputPath | Ubicación donde se guardará la información de diagnóstico. Este parámetro es obligatorio al guardar los datos de Call Home localmente. |
| Descripción y hora del incidente | Información de formato libre sobre la carga. |
| SRNumber | Número de incidente del Soporte técnico de Citrix. |
| Nombre | Nombre que identifica el paquete. |
| UploadHeader | Cadena con formato JSON que especifica los encabezados de carga subidos a CIS. |
| AppendHeaders | Cadena con formato JSON que especifica los encabezados anexados subidos a CIS. |
| Collect | Cadena con formato JSON que especifica qué datos recopilar u omitir, con el formato {‘collector’:{‘enabled’:Boolean}}”, donde Boolean es true o false. Los valores de recopilador válidos son: ‘wmi’; ‘process’; ‘registry’; ‘crashreport’; ‘trace’; ‘localdata’; ‘sitedata’; ‘sfb’. De forma predeterminada, todos los recopiladores, excepto ‘sfb’, están habilitados. El recopilador ‘sfb’ está diseñado para usarse 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 una de las siguientes formas: “-Collect “{‘sfb’:{‘account’:’domain\user1’}}”; -Collect “{‘sfb’:{‘accounts’:[‘domain\user1’, ‘domain\user2’]}}” |
| Parámetros comunes | Consulte la ayuda de PowerShell. |
Cargar datos guardados previamente de forma local
Send-CitrixCallHomeBundle -Credential <PSCredential> -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 los datos del recopilador WMI) a CIS. Estos datos se refieren a errores de registro para VDA de PVS, 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 incorporará al paquete cargado.
C:\PS>Start-CitrixCallHomeUpload -InputPath “c:\Diagnostics\ExtraData.zip” -Description “Errores de registro con VDA de PVS” -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 soporte de Citrix 223344, observado a las 8:15 AM. Los datos se guardarán 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 “Diagnóstico para el incidente número 223344” -IncidentTime “8:15” -SRNumber 223344
El siguiente cmdlet carga el paquete de datos que guardó anteriormente.
$cred=Get-Credential C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \mynetwork\myshare\mydata.zip
Citrix Scout
Para obtener todos los detalles, consulte Citrix Scout.
En este artículo
- Análisis de instalación y actualización
- Citrix Customer Experience Improvement Program (CEIP)
- Citrix Smart Tools
- Citrix Call Home
- Resumen de configuración y administración
- Requisitos previos
- Habilitar Call Home durante la instalación del componente
- Cmdlets de PowerShell
- Configurar un servidor proxy para las cargas de Call Home
- Recopilar y cargar manualmente información de diagnóstico
- Citrix Scout