NetScaler® Telemetrieprogramm
Citrix erfasst grundlegende Lizenztelemetriedaten 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 zu NetScaler Console hinzuzufügen, um Ihre NetScaler-Operationen insgesamt zu verbessern und zu vereinfachen und die Verbesserung 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 Build 14.1-25.56 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 ist nur aktiviert, wenn der automatische Modus deaktiviert ist. Sie müssen die erforderlichen Telemetriedaten von der NetScaler-Telemetrie-Homepage 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 mit dem NetScaler-Telemetrieprogramm konform zu bleiben. Sie können optional die Aufnahme der optionalen 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 an die verwalteten NetScaler-Instanzen übertragen:
-
AppFlow-Konfiguration:
enable ns feature AppFlow -
Telemetrie-Metrikprofilkonfiguration:
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 den neuesten NetScaler Console-Build zu aktualisieren.
-
Ab Build 14.1-43.x / 13.1-57.x entfernt NetScaler Console die Telemetrie-Metrikprofilkonfiguration, falls sie in Ihren NetScaler-Instanzen vorhanden ist. Die Entfernung der Telemetrie-Metrikprofilkonfiguration 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 Builds:
| Build | Im Rahmen des Telemetrieprogramms übertragene Konfigurationen | Telemetriemodus | Erforderliche Aktion |
|---|---|---|---|
| 14.1-43.x / 13.1-57.x | Nein | Automatisch und manuell | Konfigurationen werden nicht an NetScaler-Instanzen übertragen, und die Telemetrie-Metrikprofilkonfiguration 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. |
| 14.1-29.x / 13.1-55.x | Nein | Automatisch und manuell | Konfigurationen werden nicht im Rahmen 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 Telemetrie-Metrikprofilkonfiguration zu entfernen, und verwenden Sie disable ns feature AppFlow, um die AppFlow-Konfiguration zu entfernen. |
| 14.1-25.56 / 13.1-53.22 | Ja. Sowohl AppFlow- als auch Telemetrie-Metrikprofilkonfigurationen | Automatisiert (wenn alle Voraussetzungen erfüllt sind) | 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 Telemetrie-Metrikprofilkonfiguration zu entfernen, und verwenden Sie disable ns feature AppFlow, um die AppFlow-Konfiguration zu entfernen. |
| Automatisiert (wenn nicht alle Voraussetzungen erfüllt sind) oder manuell | NetScaler Console überprüft diese Konfigurationen weiterhin alle 24 Stunden und überträgt sie an NetScaler-Instanzen, falls diese Konfigurationen fehlen. Wenn Sie nicht möchten, dass die Konfigurationen übertragen werden, müssen Sie sich im automatisierten Modus befinden (wenn alle Voraussetzungen erfüllt sind) 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
-
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 gesammelten Informationen, wie E-Mail-Adressen, Benutzernamen und IP-Adressen, werden durch Hashing der Informationen an der Quelle mithilfe von Einweg-Hashing-Algorithmen sicher pseudonymisiert. Daher kann Citrix diese Werte nicht abrufen oder lesen. Diese Telemetriedaten werden ausschließlich für logische Asset-Matching-Zwecke 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 Daten-Governance.
Citrix verlangt, dass Sie innerhalb von 3 Monaten ab dem 18. Juni 2024 auf den neuesten NetScaler Console Build (14.1-25.56 oder höher / 13.1–53.22 oder höher) umstellen. Nach dem Upgrade auf NetScaler Console 14.1-25.56 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.
Hinweise:
-
Das Telemetriemodul führt mehrere SSH-Befehle auf NetScaler aus und liest die Ausgabe in der Antwort mithilfe des SSH-Dienstprogramms der NetScaler Console. Das SSH-Dienstprogramm funktioniert nicht ordnungsgemäß, und die Telemetrie schlägt fehl, wenn eine der folgenden Bedingungen erfüllt ist:
-
Der NetScaler OS-Hostname enthält ein „#“-Zeichen.
-
Die NetScaler motd (Message of the Day) enthält ein „#“-Zeichen.
-
Die NetScaler PS1-Eingabeaufforderung enthält ein „#“-Zeichen.
-
-
Sie müssen sicherstellen, dass Sie bis zum 18. September 2024 auf den neuesten Build (14.1–25.56 und höher / 13.1–53.22 und höher) umsteigen.
-
Wenn Sie sich für den manuellen Telemetriemodus entscheiden, muss der erste Upload innerhalb von 30 Tagen nach Ihrem Umstieg auf den oben genannten Build, 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 Rechtsbehelfen, die Citrix nach Gesetz oder Billigkeit zustehen. Diese Anforderungen gelten nicht, soweit sie gesetzlich oder behördlich verboten sind. Weitere Informationen finden Sie unter Citrix License Telemetry FAQ.