Application Delivery Management

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 NetScaler-Telemetrieprogramm, das hier beschrieben wird, aufrechtzuerhalten. 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 die Konformität mit dem NetScaler-Telemetrieprogramm sicherstellen. Wir empfehlen dringend, NetScaler-Instanzen zu 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 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 Ihrerseits keine Aktion erforderlich, es sei denn, die Voraussetzungen schlagen fehl. 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 aufrechtzuerhalten. Sie können optional Telemetriedaten vom Daten-Upload ausschließen, 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-Metrikprofil-Konfiguration: 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-Metrikprofil-Konfiguration, falls diese in Ihren NetScaler-Instanzen vorhanden ist. Die Entfernung der Telemetrie-Metrikprofil-Konfiguration 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-Metrikprofil-Konfigurationen im neuesten Build und in früheren Builds:

Build Konfigurationen, die als Teil des Telemetrieprogramms übertragen wurden 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-Metrikprofil-Konfiguration wird aus NetScaler-Instanzen entfernt, falls sie vorhanden ist. 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 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 Telemetrie-Metrikprofil-Konfiguration 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-Metrikprofil-Konfigurationen
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 Telemetrie-Metrikprofil-Konfiguration 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 an 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 den neuesten Build aktualisieren.

Hinweise:

  • Die Datei /nsconfig/.telemetry.conf wird 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 mittels Einweg-Hashing-Algorithmen sicher pseudonymisiert. Infolgedessen kann Citrix diese Werte nicht einsehen oder lesen. Diese Telemetriedaten werden ausschließlich für logische Asset-Matching-Zwecke verwendet.

Die folgende Tabelle enthält die Parameterdetails, die im Rahmen 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 übergeordnete NetScaler-Bereitstellungsdaten sowie 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 den neuesten NetScaler Console-Build (14.1 25.56 oder höher / 13.1–53.22 oder höher) umsteigen. 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.

Wichtige Hinweise:

  • 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) umgestiegen sind.

  • Wenn Sie sich für den manuellen Telemetriemodus entscheiden, muss der erste Upload innerhalb von 30 Tagen nach Ihrem Übergang zum 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 durch Gesetz oder Verordnung verboten sind. Weitere Informationen finden Sie in den Citrix License Telemetry FAQ.

NetScaler® Telemetrieprogramm