NetScaler® Telemetrieprogramm
Citrix erfasst grundlegende Lizenz-Telemetriedaten sowie Telemetriedaten zur NetScaler-Bereitstellung und Funktionsnutzung für seine berechtigten Interessen, einschließlich der Lizenzkonformität. Sie können die erforderlichen Lizenz- und Funktionsnutzungsdaten automatisch oder manuell hochladen, um die Konformität mit dem hier beschriebenen NetScaler-Telemetrieprogramm zu gewährleisten. NetScaler Console-Konfigurations- und Funktionsnutzungsdaten werden ebenfalls erfasst, um Citrix-Produkte und -Dienste zu verwalten, zu messen und zu verbessern. Wenn Sie ein bestehender NetScaler Console-Kunde sind, müssen Sie sicherstellen, dass Sie mit dem NetScaler-Telemetrieprogramm konform sind. Wir empfehlen dringend, NetScaler-Instanzen zur NetScaler Console hinzuzufügen, um Ihre NetScaler-Operationen insgesamt zu verbessern und zu vereinfachen und die Weiterentwicklung unserer Produkte und Dienste durch das Senden von NetScaler-Funktionsnutzungsdaten zu unterstützen. Erfahren Sie mehr.
Sie können die erforderlichen Telemetriedaten auf folgende Weisen hochladen:
-
Automatischer Erfassungsmodus – Dieser Modus ist standardmäßig aktiviert, nachdem Sie auf 14.1 25.53 oder höher / 13.1-53.22 oder höher aktualisiert haben. Der automatische Modus erstellt eine ausgehende Verbindung, um den automatisch aktivierten Kanal (Endpunkt-URLs) zu verwenden, und lädt die Telemetriedaten automatisch hoch. Sie müssen lediglich sicherstellen, dass die Endpunkt-URLs erreichbar sind. Da der Upload automatisch erfolgt, ist von Ihrer Seite keine Aktion erforderlich, es sei denn, die Voraussetzungen sind nicht erfüllt. Weitere Informationen finden Sie unter Automatischer Erfassungsmodus.
-
Manueller Erfassungsmodus – Dieser Modus wird nur aktiviert, wenn der automatische Modus deaktiviert ist. Sie müssen die erforderlichen Telemetriedaten von der NetScaler-Telemetrie-Startseite in NetScaler Console On-Prem herunterladen und den ersten Upload an den NetScaler Console-Dienst innerhalb von 30 Tagen abschließen. Die nachfolgenden Uploads müssen alle 90 Tage erfolgen, um konform zu bleiben. Weitere Informationen finden Sie unter Manueller Erfassungsmodus.
Es wird empfohlen, den automatischen Telemetriemodus zu verwenden und die erforderlichen Daten automatisch hochzuladen. Sie können jedoch auch den automatischen Modus deaktivieren und die Daten manuell hochladen. Sowohl im automatischen als auch im manuellen Modus ist der Daten-Upload erforderlich, um die Konformität mit dem NetScaler-Telemetrieprogramm zu gewährleisten. Sie können die Aufnahme optionaler Telemetriedaten in den Daten-Upload deaktivieren, aber die erforderlichen Lizenzkonformitäts- und Funktionsnutzungs-Telemetriedaten müssen sowohl im automatischen als auch im manuellen Modus bereitgestellt werden.
Um konform zu bleiben, darf die Anzahl der Tage seit dem letzten erfolgreichen Upload 90 Tage nicht überschreiten.
Im Rahmen des NetScaler-Telemetrieprogramms wurden die folgenden Konfigurationen auf die verwalteten NetScaler-Instanzen übertragen:
-
AppFlow-Konfiguration:
enable ns feature AppFlow -
Konfiguration des Telemetrie-Metrikprofils:
add analytics profile telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300
Hinweis:
Für eine optimale Telemetrieerfassung empfehlen wir Ihnen, auf die neueste NetScaler Console-Version zu aktualisieren.
-
Ab der Version 13.1-57.x entfernt NetScaler Console die Konfiguration des Telemetrie-Metrikprofils, falls diese in Ihren NetScaler-Instanzen vorhanden ist. Die Entfernung der Konfiguration des Telemetrie-Metrikprofils hat keine Auswirkungen auf bestehende Funktionen in Ihren NetScaler-Instanzen.
-
Wenn Sie die Analysefunktionen von NetScaler oder NetScaler Console nicht verwenden, können Sie den folgenden Befehl verwenden, um die AppFlow-Konfiguration zu entfernen:
disable ns feature AppFlow
Die folgende Tabelle enthält Details zu den AppFlow®- und Telemetrie-Metrikprofilkonfigurationen in der neuesten und früheren Versionen:
| Build | Konfigurationen, die als Teil des Telemetrieprogramms übertragen wurden | Telemetriemodus | Erforderliche Aktion |
|---|---|---|---|
| 13.1-57.x | Nein | Automatisch und manuell | Konfigurationen werden nicht auf NetScaler-Instanzen übertragen, und die Konfiguration des Telemetrie-Metrikprofils wird von NetScaler-Instanzen entfernt, falls vorhanden. Wenn Sie die Analysefunktionen von NetScaler oder NetScaler Console nicht verwenden, können Sie disable ns feature AppFlow verwenden, um die AppFlow-Konfiguration zu entfernen. |
| 13.1-55.x | Nein | Automatisch und manuell | Konfigurationen werden nicht als Teil des NetScaler-Telemetrieprogramms übertragen. Wenn diese Konfigurationen in Ihren NetScaler-Instanzen vorhanden sind und Sie diese entfernen möchten, führen Sie den Befehl rm analytics profile telemetry_metrics_profile auf NetScaler aus, um die Konfiguration des Telemetrie-Metrikprofils zu entfernen, und verwenden Sie disable ns feature AppFlow, um die AppFlow-Konfiguration zu entfernen. |
| 13.1-53.22
|
Ja. Sowohl AppFlow- als auch Telemetrie-Metrikprofilkonfigurationen
|
Automatisch (mit allen erfüllten Voraussetzungen) | Konfigurationen werden als Teil des NetScaler-Telemetrieprogramms übertragen, aber nicht alle 24 Stunden überprüft. Um diese Konfigurationen zu entfernen, führen Sie den Befehl rm analytics profile telemetry_metrics_profile auf NetScaler aus, um die Konfiguration des Telemetrie-Metrikprofils zu entfernen, und verwenden Sie disable ns feature AppFlow, um die AppFlow-Konfiguration zu entfernen. |
| Automatisch (mit nicht erfüllten Voraussetzungen) oder manuell | NetScaler Console überprüft diese Konfigurationen weiterhin alle 24 Stunden und überträgt sie auf NetScaler-Instanzen, falls diese Konfigurationen fehlen. Wenn Sie nicht möchten, dass die Konfigurationen übertragen werden, müssen Sie sich im automatischen Modus befinden (mit allen erfüllten Voraussetzungen) oder auf die neueste Version aktualisieren. |
Hinweise:
- Die Datei
/nsconfig/.telemetry.confwird mit dem folgenden Befehl für die Gateway-Telemetrie aktualisiert. NetScaler Console überprüft diesen Befehl stündlich und fügt ihn hinzu, falls er fehlt:ns_telemetry_server,<Console IP>,5140 <!--NeedCopy-->
Einige Telemetrieparameter werden über Skripte erfasst, die von NetScaler Console an NetScaler-Instanzen übertragen werden. Diese Skripte sind schreibgeschützt und ändern nichts in NetScaler.
Die über Telemetrie erfassten Informationen, wie E-Mail-Adressen, Benutzernamen und IP-Adressen, werden durch Hashing der Informationen an der Quelle mithilfe von Einweg-Hashing-Algorithmen sicher pseudonymisiert. Infolgedessen kann Citrix diese Werte nicht einsehen oder lesen. Diese Telemetriedaten werden ausschließlich für Zwecke des logischen Asset-Abgleichs verwendet.
Die folgende Tabelle enthält die Parameterdetails, die als Teil des NetScaler-Telemetrieprogramms erfasst werden:
| Kategorien | Beschreibung | Wofür verwenden wir es? | Erforderlich/Optional |
|---|---|---|---|
| Lizenz- sowie NetScaler-Bereitstellungs- und Nutzungs-Telemetrie | Informationen zu Lizenzberechtigung, -zuweisung, -nutzung und allgemeinen NetScaler-Bereitstellungsdaten sowie zur NetScaler-Funktionsnutzung. | Lizenzkonformität und zur Verwaltung, Messung und Verbesserung des Dienstes. | Erforderlich |
| NetScaler Console-Bereitstellungs- und Funktionsnutzungs-Telemetrie | Informationen zur Console-Bereitstellung und Funktionsnutzung. | Zur Verwaltung, Messung und Verbesserung des Dienstes. | Optional |
Weitere Informationen zur Liste der optionalen und erforderlichen Telemetrieparameter finden Sie unter Datengovernance.
Citrix verlangt, dass Sie innerhalb von 3 Monaten ab dem 18. Juni 2024 auf die neueste NetScaler Console-Version (14.1 25.53 oder höher / 13.1–53.22 oder höher) umstellen. Nach dem Upgrade auf NetScaler Console 14.1 25.53 oder höher / 13.1–53.22 oder höher muss einer der Telemetriemodi (automatisch oder manuell) aktiv funktionieren. Sofern Sie sich nicht für die manuelle Berichterstattung entschieden haben, stimmen Sie zu, Ihre Firewalls bei Bedarf anzupassen, um die automatische Telemetrieberichterstattung zu ermöglichen.
Wichtige Hinweise:
-
Sie müssen sicherstellen, dass Sie bis zum 18. September 2024 auf die neueste Version (14.1–25.53 und höher / 13.1–53.22 und höher) umgestellt haben.
-
Wenn Sie sich für den manuellen Telemetriemodus entscheiden, muss der erste Upload innerhalb von 30 Tagen nach Ihrer Umstellung auf die oben genannte Version, spätestens jedoch am 18. Oktober 2024, abgeschlossen sein. Danach muss der manuelle Telemetrie-Upload alle 90 Tage erfolgen, damit Ihre NetScaler Console On-Prem mit dem NetScaler-Telemetrieprogramm konform ist.
Citrix kann Ihren Citrix Support bei Nichteinhaltung dieser Anforderungen ohne Haftung aussetzen oder beenden, zusätzlich zu allen anderen Rechtsmitteln, die Citrix nach Gesetz oder Billigkeit zustehen könnten. Diese Anforderungen gelten nicht, soweit dies gesetzlich oder behördlich untersagt ist. Weitere Informationen finden Sie in den FAQ zur Citrix Lizenz-Telemetrie.