Produktdokumentation
Application Delivery Management
14.1 - Current Release 13.1 13.0
PDF anzeigen

Fehlerbehebung bei Gateway Insight-Problemen

December 12, 2025
Beitrag von: 
C

Wenn die Gateway Insight-Lösung nicht wie erwartet funktioniert, könnte das Problem bei einem der folgenden Punkte liegen. Beachten Sie die Checklisten in den jeweiligen Abschnitten zur Fehlerbehebung.

  • Gateway Insight-Konfiguration.
  • Konnektivitätsproblem zwischen NetScaler und NetScaler Console.
  • Datensatzgenerierung in NetScaler.
  • Validierungen in der NetScaler Console.

Gateway Insight-Konfigurations-Checkliste

  • Stellen Sie sicher, dass die AppFlow-Funktion in der NetScaler-Appliance aktiviert ist. Weitere Informationen finden Sie unter Enabling AppFlow.

  • Überprüfen Sie die Gateway Insight-Konfiguration in der laufenden NetScaler-Konfiguration.

    Führen Sie den Befehl show running | grep -i <appflow_policy> aus, um die Gateway Insight-Konfiguration zu überprüfen. Stellen Sie sicher, dass der Bindungstyp REQUEST ist. Zum Beispiel:

     bind vpn vserver afsanity -policy afp -priority 100 -type REQUEST
 <!--NeedCopy-->

    Der Bindungstyp OTHERTCP_REQUEST ist ebenfalls für Gateway Insight erforderlich.

     bind vpn vserver afsanity -policy afp -priority 100 -type OTHERTCP_REQUEST
 <!--NeedCopy-->
  • Stellen Sie für Single-Hop-, Access Gateway- oder Unified Gateway-Bereitstellungen sicher, dass die Gateway Insight AppFlow-Richtlinie an den VPN-virtuellen Server gebunden ist, über den der VPN-Verkehr fließt. Weitere Informationen finden Sie unter Enabling HDX Insight data collection.
  • Für Double-Hop muss Gateway Insight auf beiden Hops konfiguriert werden.
  • Überprüfen Sie den Parameter appflowlog im NetScaler Gateway/VPN-Virtual Server. Weitere Informationen finden Sie unter Enabling AppFlow for Virtual Servers.

Checkliste zur Konnektivität zwischen NetScaler und NetScaler Console

  • Überprüfen Sie den AppFlow-Collector-Status in NetScaler. Weitere Informationen finden Sie unter How to check the status of connectivity between NetScaler and AppFlow Collector.

  • Überprüfen Sie die Treffer der Gateway Insight AppFlow®-Richtlinie.

    Führen Sie den Befehl show appflow policy <policy_name> aus, um die AppFlow-Richtlinientreffer zu überprüfen.

    Sie können auch in der GUI zu Settings > AppFlow > Policies navigieren, um die AppFlow-Richtlinientreffer zu überprüfen.

  • Überprüfen Sie, ob eine Firewall die AppFlow-Ports 4739 oder 5557 blockiert.

Checkliste zur Datensatzgenerierung in NetScaler

  • Führen Sie den Befehl nsconmsg -d stats -g ai_tot aus und überprüfen Sie die Statistikinkremente in NetScaler.
  • Erfassen Sie nstrace logs und überprüfen Sie CFLOW-Pakete, um zu bestätigen, dass NetScaler AppFlow-Datensätze exportiert.

    Hinweis:

    Die nstrace logs sind nur für IPFIX erforderlich. Für Logstream bestätigen nstrace-Protokolle nicht, ob die NetScaler-Appliance die AppFlow-Datensätze exportiert hat.

Validierung von Datensätzen in der NetScaler Console

  • Führen Sie den Befehl tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: vpn_" aus, um die Protokolle zu überprüfen und zu bestätigen, dass die NetScaler Console AppFlow-Datensätze empfängt.
  • Stellen Sie sicher, dass die NetScaler-Instanz zur NetScaler Console hinzugefügt ist.
  • Stellen Sie sicher, dass der NetScaler Gateway/VPN-Virtual Server in der NetScaler Console lizenziert ist.

Validierung von Logstream-Protokollen in der NetScaler Console

Die Validierung der von der NetScaler Console empfangenen Logstream-Daten kann mit den folgenden Methoden erfolgen:

  • Aktivieren der Datensatzprotokollierung in der NetScaler Console

    Nach der Aktivierung sind die Protokolle in /var/mps/log/mps_afdecoder.log sichtbar.

  • Aktivieren der ULFD-Bibliotheksprotokollierung

    Führen Sie den Befehl /mps/decoder_enable_debug aus.

    Die Protokolle werden in /var/ulflog/libulfd.log erfasst.

    Sie können die Protokollierung mit dem Befehl /mps/decoder_disable_debug deaktivieren.

Gateway Insight-Zähler

Die folgenden Gateway Insight-Zähler sind verfügbar.

  • ai_tot_preauth_epa_export
  • ai_tot_auth_export
  • ai_tot_auth_session_id_update_export
  • ai_tot_postauth_epa_export
  • ai_tot_vpn_update_export
  • ai_tot_ica_fileinfo_export
  • ai_tot_app_launch_failure
  • ai_tot_logout_export
  • ai_tot_skip_appflow_export
  • ai_tot_sso_appflow_export
  • ai_tot_authz_appflow_export
  • ai_tot_appflow_pol_eval_failure
  • ai_tot_vpn_export_state_mismatch
  • ai_tot_appflow_disabled
  • ai_tot_appflow_pol_eval_in_gwinsight
  • ai_tot_app_launch_success

AppFlow-Datensätze im NetScaler-Protokoll

Ab Release 13.0 Build 71.x können Sie die NetScaler-Protokolle überprüfen, um zu bestätigen, ob die AppFlow-Datensätze exportiert werden. Die Standardprotokollstufe von syslogparams erfasst alle Fehler- und Informationsprotokolle. Falls Sie keinen Hinweis auf die Fehler finden, aktivieren Sie alle Protokollstufen einschließlich DEBUG in syslogparams, um auch die DEBUG-Protokolle zu erfassen.

Beispielprotokolle 

<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 147 0 : "GwInsight: Sent auth record Func=ns_sslvpn_export_auth_data Username=<name> Clientip=<ip>:<port> Destip=0:80 SessSeq=0 Sessid=<sessid> Gwip=<ip>:443 StatusCode=0 CSappid=0 CSAppname=(null) VPNfqdn=<vpnfqdn> Authtype=3 EPAid=(null) AuthStage=1 AuthDuration=309 AuthAgent=<auth_server_ip> Groupname= Policyname=<name> CurfactorPolname=<name> NextfactorPolname= CSecExpr= Devicetype=16777219 Deviceid=0 email="
<local0.err> … GMT 0-PPE-0 : default SSLVPN Message 143 0 : "GwInsight: Func=ns_aaa_copy_email_id_to_vpn_record input hash_attrs_len is zero"
<local0.err> … GMT 0-PPE-0 : default SSLVPN Message 148 0 : "GwInsight: Func=update_session_appflow_collector pcb or session is NULL"
<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 165 0 : "GwInsight: Sent session update record Func=ns_sslvpn_send_update_record Username=<> Clientip=<ip>:<port> Destip=<ip>:80 SessSeq=1 Sessid=<sessid> Gwip=<ip>:443 StatusCode=0 CSappid=0 CSAppname=(null) VPNfqdn=<fqdn> SSOAuthMethod=0 SessState=2 SessMode=2 IIP=0 AppByteCount=0 ReqURL=/Citrix/Store
Web BackendServername= SSOurl= email="
SSO logs:
<!--NeedCopy-->

<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 463 0 : "GwInsight: Sent session update record Func=ns_sslvpn_send_update_record Username=<name> Clientip=<ip>:<port> Destip=<ip>:80 SessSeq=2 Sessid=<sessid> Gwip=<ip>:443 StatusCode=150 CSappid=0 CSAppname=(null) VPNfqdn=<fqdn> SSOAuthMethod=1 SessState=4 SessMode=3 IIP=0 AppByteCount=0 ReqURL= BackendServername=<> SSOurl= email="
<!--NeedCopy-->

<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 582 0 : "GwInsight: Sent session update record Func=ns_sslvpn_send_update_record Username=<name> Clientip=<ip>:<port> Destip=<ip>:80 SessSeq=2 Sessid=<sessid> Gwip=<ip>:443 StatusCode=150 CSappid=0 CSAppname=(null) VPNfqdn=<fqdn> SSOAuthMethod=3 SessState=4 SessMode=3 IIP=0 AppByteCount=0 ReqURL= BackendServername=<> SSOurl= email="
<!--NeedCopy-->

<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 513 0 : "GwInsight: Sent session update record Func=ns_sslvpn_send_update_record Username=<name> Clientip=<ip>:<port> Destip=<ip>:80 SessSeq=2 Sessid=<sessid> Gwip=<ip>:443 StatusCode=150 CSappid=0 CSAppname=(null) VPNfqdn=<fqdn> SSOAuthMethod=2 SessState=4 SessMode=3 IIP=0 AppByteCount=0 ReqURL= BackendServername=<> SSOurl= email="
<!--NeedCopy-->

<local0.info> … GMT 0-PPE-0 : default SSLVPN Message 29796 0 : "GwInsight: Sent session update record Func=ns_sslvpn_send_update_record Username=<name> Clientip=<ip>:<port> Destip=<ip>:443 SessSeq=c Sessid=<sessid> Gwip=<ip>:443 StatusCode=155 CSappid=0 CSAppname=(null) VPNfqdn=<fqdn> SSOAuthMethod=6 SessState=4 SessMode=3 IIP=0 AppByteCount=0 ReqURL= BackendServername=<> SSOurl= email="
<!--NeedCopy-->

Wenden Sie sich an den technischen Support von Citrix

Für eine schnelle Lösung stellen Sie sicher, dass Sie die folgenden Informationen haben, bevor Sie sich an den technischen Support von Citrix wenden:

  • Details zur Bereitstellung und Netzwerktopologie.
  • NetScaler- und NetScaler Console-Versionen.
  • Tech Support Bundle für NetScaler und NetScaler Console.
  • nstrace-Erfassung während des Problems.

Bekannte Probleme

Beachten Sie die NetScaler-Versionshinweise für bekannte Probleme mit Gateway Insight.

Fehlerbehebung bei Gateway Insight-Problemen
December 12, 2025
Beitrag von: 
C
December 12, 2025
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.