Product Documentation

Citrix Insight Services

Jun 20, 2017

Citrix Insight Services (CIS) ist die Flaggschiff-Plattform von Citrix für Instrumentierung, Telemetrie und Ablaufverfolgung. Mit ihren Funktionen für Instrumentierung und Telemetrie können technische Benutzer (Kunden, Partner und Techniker) Probleme selbst diagnostizieren und beseitigen und die IT-Umgebung optimieren. Einzelheiten und aktuelle Informationen zu CIS und seiner Funktionsweise finden Sie unter https://cis.citrix.com (Citrix Anmeldeinformationen erforderlich)

Die zu Citrix Insight Services hochgeladenen Informationen werden für die Problembehandlung und zu Diagnosezwecken verwendet sowie zum Verbessern der Qualität, Zuverlässigkeit und Leistung von Produkten gemäß den folgenden Richtlinien:

Dieses Release von XenApp und XenDesktop unterstützt die nachfolgend aufgeführten Tools und Technologien.

  • Analyse für Installationen und Upgrades von XenApp und XenDesktop
  • Citrix Programm zur Verbesserung der Benutzerfreundlichkeit
  • Citrix Call Home
  • Citrix Scout

Analysedaten zu Installationen und Upgrades

Wenn Sie mit dem Produktinstallationsprogramm XenApp- oder XenDesktop-Komponenten bereitstellen oder aktualisieren, werden anonyme Informationen über den Installationsvorgang gesammelt und auf der Maschine gespeichert, auf der Sie die Komponente installieren/aktualisieren. Mithilfe dieser Daten verbessert Citrix das Kundenerlebnis bei der Installation. Weitere Informationen finden Sie unter http://more.citrix.com/XD-INSTALLER.

Die Informationen werden lokal unter %ProgramData%\Citrix\CTQs gespeichert.

Der automatische Upload dieser Daten ist in der grafischen Oberfläche und der Befehlszeilenschnittstelle des Installationsprogramms für das komplette Produkt standardmäßig aktiviert. 

  • Sie können die Standardeinstellung über eine Registrierungseinstellung ändern. Wenn Sie die Registrierungseinstellung vor dem Installieren/Upgrade ändern, wird der gewählte Wert angewendet, wenn Sie das Installationsprogramm für das komplette Produkt verwenden.
  • Sie können die Standardeinstellung beim Installieren bzw. Upgrade für die Befehlszeilenschnittstelle außer Kraft setzen, indem Sie eine Option mit dem Befehl eingeben.

Registrierungseinstellung zur Steuerung des automatischen Uploads von Installations-/Upgradeanalysedaten (Standard = 1):

Speicherort: HKLM:\Software\Citrix\MetaInstall
Name: SendExperienceMetrics
Wert: 0 = deaktiviert, 1 = aktiviert

Das folgende PowerShell-Cmdlet deaktiviert den automatischen Upload von Installations-/Upgradeanalysedaten:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0

Zum Deaktivieren des automatischen Uploads über den Befehl "XenDesktopServerSetup.exe" oder "XenDesktopVDASetup.exe" verwenden Sie die Option "/disableexperiencemetrics".

Zum Aktivieren des automatischen Uploads über den Befehl "XenDesktopServerSetup.exe" oder "XenDesktopVDASetup.exe" verwenden Sie die Option "/sendexperiencemetrics".

Citrix Programm zur Verbesserung der Benutzerfreundlichkeit (CEIP)

Wenn Sie am Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) teilnehmen, werden anonyme Statistiken und Nutzungsinformationen an Citrix gesendet, damit Citrix die Qualität und Leistung seiner Produkte verbessern kann. Weitere Informationen finden Sie unter http://more.citrix.com/XD-CEIP

Registrierung bei Erstellung/Upgrade der Site

Beim Erstellen einer XenApp- oder XenDesktop-Site werden Sie (nach Installation des ersten Delivery Controllers) automatisch für das Programm zur Verbesserung der Benutzerfreundlichkeit registriert. Der erste Datenupload erfolgt ca. sieben Tage nach dem Erstellen der Site. Sie können Ihre Teilnahme nach dem Erstellen der Site jederzeit beenden. Wählen Sie dazu im Navigationsbereich von Studio den Knoten Konfiguration (Registerkarte "Produktsupport") und folgen Sie den Anleitungen.

Bei dem Upgrade einer XenApp- oder XenDesktop-Bereitstellung:

  • Wenn Sie ein Upgrade von einer Version durchführen, die CEIP nicht unterstützte, werden Sie gefragt, ob Sie teilnehmen möchten.
  • Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme war aktiviert, ist CEIP in der aktualisierten Site aktiviert.
  • Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme war deaktiviert, ist CEIP in der aktualisierten Site deaktiviert.
  • Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme ist nicht bekannt, werden Sie gefragt, ob Sie teilnehmen möchten. 

Die gesammelten Informationen sind anonym, daher können sie nach dem Upload auf Citrix Insight Services nicht angezeigt werden.

Registrierung beim Installieren eines VDAs

Standardmäßig werden Sie automatisch beim CEIP registriert, wenn Sie einen Windows-VDA installieren. Sie können die Standardeinstellung über eine Registrierungseinstellung ändern. Wenn Sie die Registrierungseinstellung ändern, bevor Sie den VDA installieren, wird der neue Wert verwendet.

Registrierungseinstellung zur Steuerung des automatischen Uploads von Installations-/Upgradeanalysedaten (Standard = 1):

Speicherort: HKLM:\Software\Citrix\Telemetry\CEIP
Name: Enabled
Wert: 0 = deaktiviert, 1 = aktiviert

Standardmäßig ist die Eigenschaft "Enabled" in der Registrierung verborgen. Wird sie nicht festgelegt, dann ist der automatische Upload aktiviert.

Mit dem folgenden PowerShell-Cmdlet wird die Registrierung beim CEIP deaktiviert:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0

Der erste Datenupload erfolgt ca. sieben Tage nach der Installation des VDAs.

Registrierung bei der Installation anderer Produkte und Komponenten

Sie können auch am Programm zur Verbesserung der Benutzerfreundlichkeit teilnehmen, wenn Sie andere Produkte, Komponenten und Technologien von Citrix installieren, z. B. Provisioning Services, AppDNA, Citrix Lizenzserver, Citrix Receiver für Windows, den universellen Druckserver und Sitzungsaufzeichnung. Standardwerte für die Installation und Teilnahme finden Sie in der Dokumentation dieser Komponenten.

Citrix Call Home

Wenn Sie bestimmte Komponenten und Features in XenApp oder XenDesktop installieren, wird Ihnen angeboten, an Citrix Call Home teilzunehmen. Call Home sammelt Diagnosedaten und lädt in regelmäßigen Abständen Telemetriepakete mit den Daten über HTTPS am Standardport 443 direkt zu Citrix Insight Services zur Analyse und Problembehandlung hoch.

Call Home wird als Hintergrunddienst unter dem Namen "Citrix Telemetry Service" ausgeführt.

Weitere Informationen finden Sie unter http://more.citrix.com/XD-CALLHOME.

Folgendes wird gesammelt

Die Citrix Diagnostic Facility (CDF)-Ablaufverfolgung protokolliert Informationen, die für die Problembehandlung hilfreich sein können. Call Home sammelt eine Untergruppe der CDF-Ablaufverfolgungen, die bei der Problembehandlung allgemeiner Fehler, z. B. bei VDA-Registrierungen und Starts von Anwendung und Desktops, hilfreich sein können. Diese Technologie wird auch als Always-On-Ablaufverfolgung (Always-On Tracing, AOT) bezeichnet. Call Home sammelt keine anderen ETW-Informationen (Ereignisablaufverfolgung für Windows) und kann auch nicht dafür konfiguriert werden.

Call Home sammelt auch andere Informationen, z. B.:

  • Registrierungen, die von XenApp und XenDesktop in HKEY_LOCAL_MACHINE\SOFTWARE\Citrix erstellt wurden
  • Informationen zu Windows Management Instrumentation (WMI) unter dem Citrix Namespace
  • Liste der aktuellen Prozesse
  • Absturzabbilder von Citrix Prozessen, sie werden unter %PROGRAM DATA%\Citrix\CDF gespeichert

Die Ablaufverfolgungsinformationen werden bei der Sammlung komprimiert. Der Citrix Telemetriedienst speichert maximal 10 MB Ablaufverfolgungsinformationen in komprimierter Form für maximal 8 Tage. 

  • Durch das Komprimieren der Daten benötigt Call Home nicht viel Speicherplatz auf dem VDA.
  • Ablaufverfolgungen bleiben im Speicher erhalten, damit auf bereitgestellten Maschinen keine IOPS erfolgen müssen.
  • Der Ablaufverfolgungspuffer verwendet einen kreisförmigen Mechanismus, um Ablaufverfolgungen im Speicher zu erhalten.
htm

Wichtige Call Home-Datenpunkte

Call Home collects these key datapoints.

Konfigurations- und Verwaltungszusammenfassung

Wenn Sie einen Delivery Controller oder VDA installieren, können Sie über die grafische Oberfläche im Produktinstallationsprogramm angeben, ob Sie an Call Home teilnehmen möchten. 

Nach der Installation der Komponenten können Sie mit PowerShell-Cmdlets Folgendes festlegen:

  • Aktivieren von geplanten Call Home-Uploads oder Ändern des aktuellen Zeitplans. Dies umfasst das Aktivieren von geplanten Uploads in einem Masterimage, das in einem Maschinenkatalog verwendet wird. Dadurch muss Call Home nicht in jeder erstellten VM konfiguriert werden.
  • Manuelles Sammeln von Daten und Hochladen nach CIS.
  • Manuelles Sammeln von Daten, lokale Speicherung und späterer Upload nach CIS.

Vollständige PowerShell-Cmdlet-Syntax finden Sie in der Cmdlet-Hilfe.

Bei der Registrierung für geplante Call Home-Uploads und beim manuellen Hochladen von Diagnoseinformationen nach CIS müssen Sie Citrix Kontoanmeldeinformationen angeben.CIS ersetzt die Anmeldeinformationen durch ein Uploadtoken zum Identifizieren des Kunden und Hochladen der Daten. Die Anmeldeinformationen werden nicht gespeichert.

Wenn Upload ausgeführt wird, wird per E-Mail eine Benachrichtigung an die Adresse des Citrix Kontos gesendet. 

Aktivieren und Konfigurieren von geplanten Uploads

Mit dem Assistenten des Produktinstallationsprogramms oder später mit PowerShell-Cmdlets können Sie sich für geplante Uploads nach Call Home registrieren. Standardmäßig werden Daten gesammelt und jeden Sonntag gegen 03:00 Uhr morgens (Ortszeit) nach CIS hochgeladen. Die Uploadzeit wird innerhalb eines 2-Stunden-Fensters ab dem angegebenen Zeitpunkt zufällig festgelegt. Dies bedeutet, dass ein Upload nach dem Standardzeitplan zwischen 03:00 und 05:00 Uhr morgens erfolgt.

Wenn Sie Informationspakete mit Diagnoseinformationen nicht einem Plan gemäß regelmäßig hochladen möchten, können Sie mit PowerShell-Cmdlets Call Home-Daten manuell sammeln und hochladen.

Aktivieren von geplanten Uploads während der Komponenteninstallation

Wenn Sie mit der grafischen Benutzeroberfläche des XenApp- und XenDesktop-Produktinstallationsprogramms einen Controller oder VDA installieren, können Sie angeben, ob Sie geplante Uploads nach Call Home durchführen möchten. In der Standardeinstellung ist die Teilnahme ausgewählt. 

  • Wenn Sie teilnehmen möchten, melden Sie sich mit Ihren Citrix Kontoanmeldeinformationen an CIS an.
  • Wenn Sie nicht teilnehmen möchten (oder wenn Sie teilnehmen möchten, aber die Citrix Anmeldeinformationen konnten nicht validiert werden), lehnen Sie die Teilnahme auf der Seite des Assistenten ab. Sie können sich später nach dem Setup der Site mit PowerShell-Cmdlets registrieren.

Wenn Sie einen Controller installieren, können Sie nicht mehr zum Konfigurieren von Informationen über das Call Home Seite des Installationsassistenten wenn der Server über eine Active Directory-Gruppenrichtlinienobjekt mit der Richtlinieneinstellung "Anmelden als Dienst" angewendet. Weitere Informationen finden Sie unter CTX218094.

Aktivieren von geplanten Uploads mit PowerShell-Cmdlets

Geben Sie die folgenden Cmdlets ein, um geplante Uploads von Call Home-Paketen mit Diagnoseinformationen an CIS zu aktivieren. Wenn Sie keine zusätzlichen Cmdlets für einen benutzerdefinierten Zeitplan eingeben, wird der Standardzeitplan verwendet.

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

Um sicherzustellen, dass geplante Uploads aktiviert sind, geben Sie Get-CitrixCallHome ein. Folgendes sollte wiedergegeben werden: IsEnabled=True und IsMasterImage=False.

Aktivieren von geplanten Uploads für Maschinen, die von einem Masterimage erstellt wurden

Wenn Sie geplante Uploads in einem Masterimage konfigurieren, brauchen Sie nicht jede einzelne im Maschinenkatalog erstellte Maschine zu konfigurieren.

Enable-CitrixCallHome -Credential $cred -MasterImage

Um sicherzustellen, dass geplante Uploads aktiviert sind, geben Sie Get-CitrixCallHome ein. Folgendes sollte zurückgegeben werden: IsEnabled=True und IsMasterImage=True.

Erstellen eines benutzerdefinierten Zeitplans

Sie können einen benutzerdefinierten täglichen oder wöchentlichen Zeitplan erstellen.

$timespan = New-TimeSpan –Hours -Minutes
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek -UploadFrequency {Daily|Weekly}

Abbrechen von geplanten Uploads

Geben Sie das folgende Cmdlet ein, um geplante Uploads zu stornieren. (Sie können mit PowerShell-Cmdlets trotzdem Pakete mit Diagnosedaten hochladen.)

Disable-CitrixCallHome

Um sicherzustellen, dass geplante Uploads deaktiviert sind, geben Sie Get-CitrixCallHome ein. Folgendes sollte zurückgegeben werden: IsEnabled=False und IsMasterImage=False.

Beispiele

Das folgende Cmdlet erstellt einen Zeitplan, nach dem Datenpakete jeden Abend um 23:20 Uhr erstellt und hochgeladen werden. Beachten Sie, dass der Parameter für Stunden das 24-Stunden-Format verwendet. Wenn der Wert für den Parameter "UploadFrequency" auf "Daily" festgelegt ist, wird der Parameter "DayOfWeek" ignoriert, wenn er angegeben ist. 

$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily

Um den Zeitplan zu überprüfen, geben Sie Get-CitrixCallHomeSchedule ein. Für das oben aufgeführte Beispiel sollte Folgendes zurückgegeben werden: StartTime=22:20:00, DayOfWeek=Sunday (ignoriert), Upload Frequency=Daily.

Das folgende Cmdlet erstellt einen Zeitplan, nach dem Datenpakete mittwochabends um 23:20 Uhr erstellt und hochgeladen werden.  

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

Um den Zeitplan zu überprüfen, geben Sie Get-CitrixCallHomeSchedule ein. Für das oben aufgeführte Beispiel sollte Folgendes zurückgegeben werden: StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly. 

Konfigurieren eines Proxyservers für Call Home-Uploads

Die Beispiele im nachfolgenden Verfahren enthalten die Serveradresse und Port 10.158.139.37:3128. Die entsprechenden Adressen in Ihrer Umgebung sind anders.

Schritt 1: Geben Sie Proxyserverinformationen im Browser ein. Wählen Sie in Internet Explorer Internetoptionen > Verbindungen > LAN-Einstellungen. Wählen Sie Proxyserver für das LAN verwenden und geben Sie die Adresse und Portnummer des Proxyservers ein.

Schritt 2: Führen Sie PowerShell netsh winhttp import proxy source=ie aus.

localized image

Schritt 3:Bearbeiten Sie mit einem Text-Editor die Konfigurationsdatei TelemetryService.exe in C:\Programme\Citrix\Telemetry Service. Fügen Sie die in dem roten Feld unten dargestellten Informationen hinzu. 

localized image

Schritt 4:Starten Sie den Telemetriedienst neu.

Führen Sie die Call Home-Cmdlets in PowerShell aus.

Manuelles Sammeln und Hochladen von Diagnoseinformationen

Sie können über die CIS-Website ein Diagnoseinformationspaket nach CIS hochladen. Sie können auch PowerShell-Cmdlets zum Sammeln und Hochladen von Diagnoseinformationen nach CIS verwenden.

Hochladen eines Pakets über die CIS-Website

  1. Melden Sie sich mit Ihren Citrix Kontoanmeldeinformationen an Citrix Insight Services an.
  2. Wählen Sie My Workspace.
  3. Wählen Sie Healthcheck und navigieren Sie zum Speicherort der Daten.

CIS unterstützt mehrere PowerShell-Cmdlets, die Datenuploads verwalten. In dieser Dokumentation werden die Cmdlets für zwei häufige Fälle behandelt:

  • Verwenden Sie das Cmdlet Start-CitrixCallHomeUpload, um ein Diagnoseinformationspaket manuell zu sammeln und nach CIS hochzuladen. (Das Paket wird nicht lokal gespeichert.)
  • Verwenden Sie das Cmdlet Start-CitrixCallHomeUpload, um Daten manuell zu sammeln und ein Diagnoseinformationspaket lokal zu speichern. Auf diese Weise können Sie eine Vorschau der Daten anzeigen. Zu einem späteren Zeitpunkt können Sie dann das Cmdlet Send-CitrixCallHomeBundle verwenden, um eine Kopie des Pakets manuell nach CIS hochzuladen. (Die ursprünglichen Daten bleiben lokal gespeichert.)

Die PowerShell-Hilfe enthält umfassende Syntax, einschließlich Beschreibungen von Cmdlets und Parametern, die nicht so häufig verwendet werden. 

Wenn Sie ein Cmdlet zum Hochladen von Daten nach CIS eingeben, werden Sie aufgefordert, den Upload zu bestätigen. Wenn ein Timeout des Cmdlets erfolgt, bevor der Upload abgeschlossen ist, überprüfen Sie den Status des Uploads im Systemereignisprotokoll. Die Uploadanforderung wird möglicherweise abgelehnt, wenn der Dienst bereits einen Upload ausführt.

Sammeln von Daten und Hochladen des Pakets nach CIS

Start-CitrixCallHomeUpload [-Credential] [-InputPath ] [-Description ] [-IncidentTime ] [-SRNumber ] [-Name ] [-UploadHeader ] [-AppendHeaders ] [-Collect ] []

Sammeln von Daten und lokales Speichern

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

Parameter

Beschreibung

Anmeldeinformationen

Leitet den Upload nach CIS.

InputPath

Speicherort der ZIP-Datei, die zum Paket gehört. Das kann eine weitere Datei sein, die Citrix Support benötigt. Stellen Sie sicher, dass die Erweiterung .zip eingeschlossen ist.

OutputPath

Speicherort, an dem die Diagnoseinformationen gespeichert werden. Dieser Parameter ist erforderlich, wenn Call Home-Daten lokal gespeichert werden.

Description and Incident Time

Formlose Informationen zum Upload.

SRNumber

Incident-Nummer des technischen Supports von Citrix.

Name

Name des Pakets.

UploadHeader

Zeichenfolge im JSON-Format zur Angabe der Uploadheader, die nach CIS hochgeladen werden.

AppendHeaders

Zeichenfolge im JSON-Format zur Angabe der angefügten Header, die nach CIS hochgeladen werden.

Collect

Zeichenfolge im JSON-Format zur Angabe, welche Daten gesammelt oder ausgelassen werden, das Format ist {'collector':{'enabled':Boolean}}", wobei Boolean "true" oder "false" ist.

Gültige Datensammelpunktwerte sind:

  •  'wmi'
  • 'process'
  •  'registry
  • ''crashreport'
  • 'trace'
  • 'localdata'
  • 'sitedata'
  • 'sfb'

Standardmäßig sind alle Datensammelpunkte außer "sfb" aktiviert. 

Der Datensammelpunkt "sfb" ist für die Verwendung bei Bedarf zur Diagnose von Problemen mit Skype for Business vorgesehen. Neben dem Parameter "enabled" unterstützt sfb die Parameter "account" und "accounts" zur Angabe von Zielbenutzern. Verwenden Sie eines der folgenden Syntaxmuster:

"-Collect "{'sfb':{'account':'domain\\user1'}}"

-Collect "{'sfb':{'accounts':['domain\\user1', 'domain\\user2']}}"

Allgemeine Parameter

Weitere Informationen finden Sie in der PowerShell-Hilfe.

Hochladen von Daten, die zuvor lokal gespeichert waren

Send-CitrixCallHomeBundle -Credential -Path []

Mit dem Path-Parameter geben Sie den Speicherort des zuvor gespeicherten Pakets an.

Beispiele

Mit dem folgenden Cmdlet wird ein Upload von Call Home-Daten (mit Ausnahme von Daten vom WMI-Datensammelpunkt) nach CIS angefordert. Diese Daten beziehen sich auf Registrierungsfehler bei PVS VDAs, die um 14:30 Uhr für den Citrix Supportfall 123456 bemerkt wurden. Zusätzlich zu den Call Home-Daten wird die Datei c:\Diagnostics\ExtraData.zip in das Uploadpaket eingeschlossen.

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'}"

Das folgende Cmdlet speichert Call Home-Daten, die sich auf den Citrix Supportfall 223344 beziehen, der um 8:15 Uhr bemerkt wurde. Die Daten werden in der Datei mydata.zip auf einer Netzwerkfreigabe gespeichert. Zusätzlich zu den Call Home-Daten wird die Datei c:\Diagnostics\ExtraData.zip in das gespeicherte Paket eingeschlossen.

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

Das folgende Cmdlet lädt das Datenpaket hoch, das Sie zuvor gespeichert haben.

$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \\mynetwork\myshare\mydata.zip

Citrix Scout

Citrix Scout ist der Vorgänger von Citrix Call Home. Das Programm erfasst wichtige Datenpunkte und CDF-Traces und lädt diese hoch. Weitere Informationen über Citrix Scout finden Sie unter CTX130147.

Sie können Citrix Scout über diesen Artikel herunterladen. Die Software ist auch im XenApp- bzw. XenDesktop-ISO-Image enthalten.