Product Documentation

Citrix Insight Services

Jul 08, 2016

Citrix Insight Services (CIS) ist die Flaggschiff-Plattform von Citrix für Diagnose und Problembehandlung. Mit ihr können hauseigene Experten des Kunden oder Partners Probleme 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 sind 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.

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. Support fordert Sie u. U. auf, die Informationen hochzuladen, damit Citrix die Installationserfahrung von Kunden verbessern kann.

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

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

Beim Erstellen einer XenApp- oder XenDesktop-Site werden Sie 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.

Sie können auch am Programm zur Verbesserung der Benutzerfreundlichkeit teilnehmen, wenn Sie andere Citrix Produkte, Komponenten und Technologien 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.

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.

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 direkt nach 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 ca. 20 MB komprimierte Ablaufverfolgungsinformationen. Abhängig vom Umfang der Ablaufverfolgung während des Intervalls enthalten die Daten normalerweise Informationen zu den vergangenen 24 bis 48 Stunden.

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

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.

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

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

Credential

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'

Wenn dieser Parameter nicht angegeben wird, werden Daten von allen Datensammelpunkten gesammelt.

Common Parameters

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