Produktdokumentation
ADC
14.1 - Current Release 13.1 13.0 12.1
PDF anzeigen

Metriken

June 13, 2024
Beitrag von: 
C

Metriken beziehen sich auf das Datenelement, das von NetScaler verfolgt wird. Metriken liefern aussagekräftige Einblicke und sind nützlich, um den Zustand von NetScaler und der von NetScaler verarbeiteten Anwendungen zu verfolgen.

Eine Zeitreihe ist eine Abfolge von aufeinanderfolgenden Datenpunkten, die über ein bestimmtes Zeitintervall auftreten. NetScaler unterstützt die Konfiguration des Analytics-Zeitreihenprofils zum Senden von Metriken an einen Dienst.

Metriken konfigurieren

Sie können Metriken auf NetScaler aktivieren, um Metriken von NetScaler zu sammeln und an verschiedene Endpunkte zu exportieren. Sie können Metriken in den folgenden Formaten exportieren: Avro, Prometheus und JSON. Die exportierten Metriken können verarbeitet und visualisiert werden, um aussagekräftige Erkenntnisse zu erhalten. Standardmäßig unterstützen Metriken den Export von Zeitreihenanalysedaten alle 30 Sekunden. Sie können es jedoch gemäß Ihren Anforderungen auf einen Wert zwischen 30 und 300 Sekunden konfigurieren.

Gehen Sie wie folgt vor, um eine Metrik mithilfe der NetScaler CLI zu konfigurieren.

  1. Konfigurieren Sie einen Dienst mit IP-Adresse, Protokoll und Port mit dem folgenden Befehl:

    add service <metrics_service_name> <ip-address> <protocol> <port>
<!--NeedCopy-->

    Beispiel:

    add service metrics_service1 192.168.1.1 HTTP 5563
<!--NeedCopy-->

  2. Konfigurieren Sie das Analytics-Zeitreihenprofil, um Metriken an den Service zu senden. Geben Sie den Service, die Häufigkeit für den Export von Metriken und den Ausgabemodus an.

    set analytics profile ns_analytics_time_series_profile -collectors <metrics_service_name> -type timeseries -metrics ENABLED metricsExportFrequency <30-300> -outputMode <avro/prometheus>
<!--NeedCopy-->

    Beispiel:

    set analytics profile ns_analytics_time_series_profile -collectors metrics_service1 -type timeseries -metrics Enabled metricsExportFrequency 90 -outputMode prometheus --serveMode PUSH
<!--NeedCopy-->

    Hinweis:

    In diesem Beispiel wird das Standard-Zeitreihenprofil verwendet ns_analytics_time_series_profile. Wenn Sie ein Zeitreihenprofil erstellen möchten, können Sie den add analytics profile Befehl verwenden.

    In diesem Beispiel ist die Exporthäufigkeit von Metriken auf 90 Sekunden und der Exportmodus auf Prometheus festgelegt.

    Überprüfen Sie die Metrikkonfiguration mit dem Befehl show analytics profile <analytics-profile-name>:

    show analytics profile ns_analytics_time_series_profile

    Name: ns_analytics_time_series_profile
    Collector: metrics_service1
    Profile-type: timeseries
        Output Mode: Prometheus
        Metrics: ENABLED
            Schema File: schema.json
            Metrics Export Frequency: 90
        Events: DISABLED
        Auditlog: DISABLED
        Serve mode: Pull
    Reference Count: 0
<!--NeedCopy-->

Generierung von Metrikdateien

Die metrics_<format>_log.*Dateien werden unter dem Ordnerspeicherort /var/nslog/ generiert.

Unterstützung dynamischer Schemas

Ab NetScaler Version 13.1 Build 24.38 werden dynamische Schemazähler unterstützt. Mit der Unterstützung dynamischer Schemazähler kann eine Schemadatei, die eine Liste von Leistungsindikatoren enthält, zur Laufzeit basierend auf der Anforderung aktualisiert werden. Standardmäßig ist die Datei /var/metrics_conf/schema.jsonmit einer Liste von Leistungsindikatoren konfiguriert.

Hinweis:

  • Die Standardschemadatei der Metriken /var/metrics_conf/schema.json kann mit dem installns-Verfahren auf einer NetScaler Appliance installiert werden. Informationen zum installns-Verfahren finden Sie unter Upgrade und Downgrade einer NetScaler-Appliance.
  • Die Standardschemadatei /var/metrics_conf/schema.json besteht aus einigen Entitäten und Leistungsindikatoren, die nicht Teil von reference_schema.json sind. Diese Zähler werden in schema.json aus Gründen der Abwärtskompatibilität beibehalten, da sie Teil der älteren Version von Metriken waren, die ein statisches Schema unterstützten.

Konfigurieren Sie die Metriken, um Zähler mithilfe der CLI zu abonnieren

Starten Sie den Metrikexport, indem Sie einen Dienst konfigurieren.

Geben Sie in der Befehlszeile Folgendes ein:


set analytics profile ns_analytics_time_series_profile -metrics ENABLED -collectors <collector_name> -schemaFile  schema.json -outputMode <avro | prometheus>

<!--NeedCopy-->

Hinweis:

schema.json ist die standardmäßige SchemaFile-Konfiguration.

Eine neue Schemadatei mit einem erforderlichen Satz von Zählern kann mit dem CLI-Befehl für den Export der Metriken konfiguriert werden. Die Schemadatei muss am Speicherort /var/metrics_conf/ vorhanden sein.

Die Schemadatei mit der gesamten Liste von Zählern (reference_schema.json), die von stats infra unterstützt werden, ist am Speicherort /var/metrics_conf/ vorhanden. Diese Datei kann als Referenz verwendet werden, um eine benutzerdefinierte Liste von Zählern zu erstellen.

Konfigurieren einer Schemadatei mit der CLI 

set analytics profile ns_analytics_time_series_profile -metrics ENABLED -collectors <collector name> -schemaFile <schema file_name> -outputMode <avro | prometheus>

<!--NeedCopy-->

Eine neue Schemadatei mit den erforderlichen Zählern kann mit dem vorherigen CLI-Befehl für den Export von Metriken hinzugefügt und konfiguriert werden.

Die Referenzschemadatei mit der gesamten Liste von Leistungsindikatoren (reference_schema.json), die von stats infra unterstützt werden, sind im Speicherort /var/metrics_conf/ vorhanden. Diese Datei kann als Referenz verwendet werden, um eine benutzerdefinierte Liste von Zählern zu erstellen.

Überprüfen Sie die Ausgabe der CLI-Konfiguration an der Eingabeaufforderung:


show analytics profile ns_analytics_time_series_profile

    Name: ns_analytics_time_series_profile
    Collector: <collector_name>
    Profile-type: timeseries
    Output Mode: avro
    Metrics: ENABLED
    Schema File: schema.json
    Events: ENABLED
    Auditlog: DISABLED
    Serve mode: Push
    Reference Count: 0

<!--NeedCopy-->

Schritte zum Aktualisieren der Liste der exportierten Leistungsindikatoren

Gehen Sie wie folgt vor, um die Liste der exportierten Leistungsindikatoren zu aktualisieren:

  1. Aktualisieren Sie die benutzerdefinierte/neue Schemadatei.
  2. Deaktivieren und aktivieren Sie Metriken mithilfe der Option -metrics, die in der CLI-Konfiguration für die zu verwendende aktualisierte Schemadatei angezeigt wird.

Unterstützung mehrerer Zeitreihenprofile

Ab NetScaler Version 13.1 Build 33.47 werden bis zu drei Zeitreihenprofilkonfigurationen auf NetScaler unterstützt.

Sie können jede Zeitreihe so konfigurieren, dass sie Folgendes hat:

  • Collector.

  • Schemadatei, die die erforderlichen Leistungsindikatoren für den Export enthält.

  • Das Datenformat, in dem die Metriken exportiert werden sollen.

  • Die Option zum Aktivieren oder Deaktivieren von Messwert-Überwachungsprotokollen und Ereignissen.

Mit der Unterstützung mehrerer Zeitreihenprofile können die Metriken gleichzeitig einen anderen Satz von Metriken (basierend auf der konfigurierten Schemadatei) an verschiedene Collectors in verschiedenen Formaten (Avro, Prometheus, Influx) exportieren.

Hinweis:

Obwohl Metriken für alle konfigurierten Zeitreihenprofile aktiviert werden können, können Ereignisse und Überwachungsprotokolle nur für ein Profil aktiviert werden.

Hinzufügen eines Zeitreihenprofils über die CLI

Geben Sie in der Befehlszeile Folgendes ein:

add analytics profile <profile_name> -type timeseries
<!--NeedCopy-->

Zeitreihenprofil mit der CLI konfigurieren

Geben Sie in der Befehlszeile Folgendes ein:

set analytics profile <profile_name> -metrics <DISABLED|ENABLED> -auditlogs <DISABLED|ENABLED> -events <DISABLED|ENABLED> -collectors <collector_name> -schemaFile schema.json -outputMode <avro | influx | prometheus>

<!--NeedCopy-->

Namenskonventionen für Protokolldateien mit Unterstützung mehrerer Zeitreihenprofile

  • Avro-Protokolldateien werden generiert als metrics_avro_<profile_name>_log.*.
  • Prometheus-Protokolldateien werden als generiert metrics_prom_<profile_name>.log.

Konfigurieren Sie den Export von anwendungsfallspezifischen Metriken

Sie können nur die Metriken exportieren, die sich auf einen bestimmten Anwendungsfall beziehen, indem Sie eine Schemadatei erstellen. Wenn Sie beispielsweise nur Metriken im Zusammenhang mit dem TCP-Verkehr anzeigen möchten, können Sie eine tcptrafficschema.json-Datei erstellen, um nur die Metriken zu exportieren, die sich auf den TCP-Verkehr beziehen. Mit dem Export von anwendungsfallspezifischen Metriken wird es einfacher, die gewünschten Metriken zu finden.

NetScaler unterstützt den Export von Metriken für die folgenden Anwendungsfälle:

  • Virtueller Server
  • Anwendungssicherheit
  • SSL-Verkehr
  • TCP-Verkehr
  • HTTP-Verkehr
  • Überblick über das System

Virtueller Server

Gehen Sie wie folgt vor, um nur Messobjekte anzuzeigen, die sich auf virtuelle Server beziehen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "server_svc_cfg":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_cur_Clients","rate":"False"},
        {"name":"si_cur_Servers","rate":"False"}
    ],
    "server_serviceGroup":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_cur_Clients","rate":"False"},
        {"name":"si_cur_Servers","rate":"False"}
    ],
    "vserver_authn":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_cr":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_cs":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_cur_Clients","rate":"False"},
        {"name":"si_cur_Servers","rate":"False"}
    ],
    "gslb_server":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "gslb_vserver":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "server_gslb_serviceGroup":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_lb":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_cur_Clients","rate":"False"},
        {"name":"si_cur_Servers","rate":"False"}
    ],
    "vserver_vpn":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_user":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_cur_Clients","rate":"False"},
        {"name":"si_cur_Servers","rate":"False"}
    ]
}
<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

Anwendungssicherheit

Gehen Sie wie folgt vor, um nur Kennzahlen zur Anwendungssicherheit anzuzeigen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "netscaler":
    [
        {"name":"as_viol_starturl","rate":"True"},
        {"name":"as_viol_denyurl","rate":"True"},
        {"name":"as_viol_referer_header","rate":"True"},
        {"name":"as_viol_bufferoverflow","rate":"True"},
        {"name":"as_viol_grpc","rate":"True"},
        {"name":"as_viol_postbodylimit","rate":"True"},
        {"name":"as_viol_cookie","rate":"True"},
        {"name":"as_viol_cookie_hijack","rate":"True"},
        {"name":"as_viol_csrf_tag","rate":"True"},
        {"name":"as_viol_xss","rate":"True"},
        {"name":"as_viol_sql","rate":"True"},
        {"name":"as_viol_fldfmt","rate":"True"},
        {"name":"as_viol_fldconsistency","rate":"True"},
        {"name":"as_viol_fileuploadtypes","rate":"True"},
        {"name":"as_viol_infer_ctype_xml","rate":"True"},
        {"name":"as_viol_safecommerce","rate":"True"},
        {"name":"as_viol_safeobject","rate":"True"},
        {"name":"as_viol_signature","rate":"True"},
        {"name":"as_viol_content_type","rate":"True"},
        {"name":"as_viol_cmd","rate":"True"},
        {"name":"as_viol_json_dos","rate":"True"},
        {"name":"as_viol_json_sql","rate":"True"},
        {"name":"as_viol_json_xss","rate":"True"},
        {"name":"as_viol_json_cmd","rate":"True"},
        {"name":"as_viol_sql_gram","rate":"True"},
        {"name":"as_viol_json_sql_gram","rate":"True"},
        {"name":"as_viol_sql_comb","rate":"True"},
        {"name":"as_viol_xxe_comb","rate":"True"},
        {"name":"as_viol_xss_comb","rate":"True"},
        {"name":"as_viol_owasp_comb","rate":"True"},
        {"name":"as_viol_cmd_gram","rate":"True"},
        {"name":"as_viol_json_cmd_gram","rate":"True"},
        {"name":"as_viol_block_keyword","rate":"True"},
        {"name":"as_viol_json_blockkeyword","rate":"True"},
        {"name":"as_Requests","rate":"False"},
        {"name":"http_tot_Requests","rate":"True"},
        {"name":"http_tot_Requests1_0","rate":"True"},
        {"name":"http_tot_Requests1_1","rate":"True"},
        {"name":"as_sig_num_viols","rate":"True"}
    ],
    "appfw__":
    [
        {"name":"as_viol_starturl_profile","rate":"True"},
        {"name":"as_viol_denyurl_profile","rate":"True"},
        {"name":"as_viol_referer_header_profile","rate":"True"},
        {"name":"as_viol_bufferoverflow_profile","rate":"True"},
        {"name":"as_viol_postbodylimit_profile","rate":"True"},
        {"name":"as_viol_cookie_profile","rate":"True"},
        {"name":"as_viol_cookie_hijack_profile","rate":"True"},
        {"name":"as_viol_csrf_tag_profile","rate":"True"},
        {"name":"as_viol_xss_profile","rate":"True"},
        {"name":"as_viol_sql_profile","rate":"True"},
        {"name":"as_viol_fldfmt_profile","rate":"True"},
        {"name":"as_viol_fldconsistency_profile","rate":"True"},
        {"name":"as_viol_safecommerce_profile","rate":"True"},
        {"name":"as_viol_safeobject_profile","rate":"True"},
        {"name":"as_viol_signature_profile","rate":"True"},
        {"name":"as_viol_content_type_profile","rate":"True"},
        {"name":"as_viol_json_dos_profile","rate":"True"},
        {"name":"as_viol_json_sql_profile","rate":"True"},
        {"name":"as_viol_json_xss_profile","rate":"True"},
        {"name":"as_viol_json_cmd_profile","rate":"True"},
        {"name":"as_viol_fileuploadtypes_profile","rate":"True"},
        {"name":"as_viol_infer_ctype_xml_profile","rate":"True"},
        {"name":"as_viol_cmd_profile","rate":"True"},
        {"name":"as_viol_sql_gram_profile","rate":"True"},
        {"name":"as_viol_json_sql_gram_profile","rate":"True"},
        {"name":"as_viol_sql_comb_profile","rate":"True"},
        {"name":"as_viol_xxe_comb_profile","rate":"True"},
        {"name":"as_viol_xss_comb_profile","rate":"True"},
        {"name":"as_viol_owasp_comb_profile","rate":"True"},
        {"name":"as_viol_cmd_gram_profile","rate":"True"},
        {"name":"as_viol_json_cmd_gram_profile","rate":"True"},
        {"name":"as_viol_block_keyword_profile","rate":"True"},
        {"name":"as_viol_json_blockkeyword_profile","rate":"True"},
        {"name":"as_viol_total_per_profile","rate":"True"}
    ]
}
<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

SSL-Verkehr

Gehen Sie wie folgt vor, um nur SSL-bezogene Metriken anzuzeigen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "netscaler":
    [
        {"name":"ssl_tot_sslInfo_TotalTxCount","rate":"True"},
        {"name":"ssl_tot_enc_bytes","rate":"True"},
        {"name":"ssl_tot_dec_bytes","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_RSA_512","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_RSA_1024","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_RSA_2048","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_RSA_3072","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_RSA_4096","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_DH_512","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_DH_1024","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_DH_2048","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_DH_4096","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_ECDHE_curve_secp521r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_ECDHE_curve_secp384r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_ECDHE_curve_secp256r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_ECDHE_curve_secp224r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_ECDHE_curve_x25519","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC4_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC4_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC4_64","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC4_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_DES_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_DES_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_3DES_168","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_AES_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_AES_256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC2_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC2_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_RC2_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_AESGCM_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_AESGCM_256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Cipher_NULL","rate":"True"},
        {"name":"ssl_tot_sslInfo_Hash_MD5","rate":"True"},
        {"name":"ssl_tot_sslInfo_Hash_SHA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Hash_SHA256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Hash_SHA384","rate":"True"},
        {"name":"ssl_tot_sslInfo_SSLv3HandskCount","rate":"True"},
        {"name":"ssl_tot_sslInfo_TLSv1HandskCount","rate":"True"},
        {"name":"ssl_tot_sslInfo_TLSv11HandskCount","rate":"True"},
        {"name":"ssl_tot_sslInfo_TLSv12HandskCount","rate":"True"},
        {"name":"ssl_tot_sslInfo_Auth_RSA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Auth_DH","rate":"True"},
        {"name":"ssl_tot_sslInfo_Auth_DSS","rate":"True"},
        {"name":"ssl_tot_sslInfo_Auth_ECDSA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Auth_NULL","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_backend_ecdhe_curve_secp521r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_backend_ecdhe_curve_secp384r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_backend_ecdhe_curve_secp256r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_KeyEx_backend_ecdhe_curve_secp224r1","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC4_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC4_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC4_64","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC4_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_DES_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_DES_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_3DES_168","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_AES_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_AES_256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC2_40","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC2_56","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_RC2_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_AESGCM_128","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_AESGCM_256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Cipher_NULL","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Hash_MD5","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Hash_SHA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Hash_SHA256","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Hash_SHA384","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Auth_RSA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Auth_DH","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Auth_DSS","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Auth_ECDSA","rate":"True"},
        {"name":"ssl_tot_sslInfo_Backend_Auth_NULL","rate":"True"},
        {"name":"ssl_tot_enc_bytes_FE","rate":"True"},
        {"name":"ssl_tot_enc_bytes_BE","rate":"True"},
        {"name":"ssl_tot_dec_bytes_FE","rate":"True"},
        {"name":"ssl_tot_dec_bytes_BE","rate":"True"},
        {"name":"ssl_cur_session_inuse","rate":"True"}
    ],
    "vserver_ssl":
    [
        {"name":"ssl_ctx_tot_HandskFail","rate":"True"}
    ]
}
<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

TCP-Verkehr

Gehen Sie wie folgt vor, um nur TCP-bezogene Metriken anzuzeigen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "server_svc_cfg":
    [
        {"name":"si_tot_pkt_rcvd","rate":"True"},
        {"name":"si_tot_pkt_sent","rate":"True"}
    ],
    "vserver_cr":
    [
        {"name":"si_tot_pkt_rcvd","rate":"True"},
        {"name":"si_tot_pkt_sent","rate":"True"}
    ],
    "vserver_cs":
    [
        {"name":"si_tot_pkt_rcvd","rate":"True"},
        {"name":"si_tot_pkt_sent","rate":"True"}
    ],
    "vserver_lb":
    [
        {"name":"si_tot_pkt_rcvd","rate":"True"},
        {"name":"si_tot_pkt_sent","rate":"True"}
    ],
    "netscaler":
    [
        {"name":"tcp_cur_ClientConn","rate":"False"},
        {"name":"tcp_cur_ClientConnEst","rate":"False"},
        {"name":"tcp_cur_ServerConn","rate":"False"},
        {"name":"tcp_cur_ServerConnEst","rate":"False"},
        {"name":"tcp_cur_ClientConnClosing","rate":"False"},
        {"name":"tcp_cur_ServerConnClosing","rate":"False"},
        {"name":"tcp_cur_surgequeuelen","rate":"False"},
        {"name":"tcp_err_rst","rate":"False"},
        {"name":"tcp_err_noip","rate":"False"},
        {"name":"tcp_err_retransmit_giveups","rate":"False"},
        {"name":"tcp_err_retransmit","rate":"False"},
        {"name":"tcp_err_stray_packets","rate":"False"}
    ],
    "vserver_user":
    [
        {"name":"si_tot_pkt_rcvd","rate":"True"},
        {"name":"si_tot_pkt_sent","rate":"True"}
    ]
}

<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

HTTP-Verkehr

Gehen Sie wie folgt vor, um nur HTTP-bezogene Metriken anzuzeigen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "server_svc_cfg":
    [
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "server_serviceGroup":
    [
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "netscaler":
    [
        {"name":"http_tot_api_req_json","rate":"False"},
        {"name":"http_tot_api_req_xml","rate":"False"},
        {"name":"http_tot_api_req_vnd","rate":"False"},
        {"name":"http_tot_api_res_json","rate":"False"},
        {"name":"http_tot_api_res_xml","rate":"False"},
        {"name":"http_tot_api_res_vnd","rate":"False"}
    ],
    "vserver_authn":
    [
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_cr":
    [
        {"name":"vsvr_tot_Hits","rate":"True"},
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_cs":
    [
        {"name":"vsvr_tot_Hits","rate":"True"},
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_tot_clt_ttlb_transactions","rate":"False"},
        {"name":"si_tot_clt_ttlb","rate":"False"}
    ],
    "gslb_server":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "gslb_vserver":
    [
        {"name":"vsvr_tot_Hits","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "server_gslb_serviceGroup":
    [
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_lb":
    [
        {"name":"vsvr_tot_Hits","rate":"True"},
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"},
        {"name":"si_tot_clt_ttlb_transactions","rate":"False"},
        {"name":"si_tot_clt_ttlb","rate":"False"},
        {"name":"si_tot_1xx_resp","rate":"False"},
        {"name":"si_tot_2xx_resp","rate":"False"},
        {"name":"si_tot_4xx_resp","rate":"False"},
        {"name":"si_tot_5xx_resp","rate":"False"}
    ],
    "vserver_vpn":
    [
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ],
    "vserver_user":
    [
        {"name":"vsvr_tot_Hits","rate":"True"},
        {"name":"si_tot_Requests","rate":"True"},
        {"name":"si_tot_Responses","rate":"True"},
        {"name":"si_tot_RequestBytes","rate":"True"},
        {"name":"si_tot_ResponseBytes","rate":"True"}
    ]
}
<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

Überblick über das System

Gehen Sie wie folgt vor, um nur Metriken im Zusammenhang mit der Systemübersicht anzuzeigen:

  1. Melden Sie sich bei NetScaler CLI an und navigieren Sie zum Ordner /var/metrics_conf/.

  2. Erstellen Sie beispielsweise eine Schemadatei usecase.json, fügen Sie den folgenden Inhalt hinzu und speichern Sie die Änderungen:

    {
    "server_svc_cfg":
    [
        {"name":"si_tot_svr_ttlb","rate":"False"},
        {"name":"si_tot_svr_ttlb_transactions","rate":"False"},
        {"name":"si_cur_state","rate":"False"},
        {"name":"si_tot_svr_ttfb_transactions","rate":"False"},
        {"name":"si_tot_svr_ttfb","rate":"False"}
    ],
    "serviceGroup_NSSVC":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "server_serviceGroup":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"si_tot_svr_ttfb_transactions","rate":"False"},
        {"name":"si_tot_svr_ttfb","rate":"False"}
    ],
    "vserver_authn":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "vserver_cr":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"vsvr_tot_Hits","rate":"True"}
    ],
    "vserver_cs":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"vsvr_tot_Hits","rate":"True"}
    ],
    "gslb_server":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "gslb_vserver":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"vsvr_tot_Hits","rate":"True"}
    ],
    "gslb_serviceGroup_NSSVC":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "server_gslb_serviceGroup":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "vserver_lb":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"si_tot_2xx_resp","rate":"False"},
        {"name":"si_tot_4xx_resp","rate":"False"},
        {"name":"vsvr_tot_Hits","rate":"True"}
    ],
    "interface":
    [
        {"name":"nic_err_dropped_pkts","rate":"True"}
    ],
    "netscaler":
    [
        {"name": "tcp_cur_ClientConn", "rate": "False"},
        {"name": "tcp_err_noip", "rate": "False"},
        {"name": "tcp_err_rst", "rate": "True"},
        {"name": "mem_cur_usedsize", "rate": "False"},
        {"name": "tcp_tot_rxpkts", "rate": "True"},
        {"name": "http_tot_rxResponseBytes", "rate": "True"},
        {"name": "http_tot_Requests1_1", "rate": "True"},
        {"name": "http_tot_Responses", "rate": "True"},
        {"name": "tcp_err_retransmit_giveups", "rate": "True"},
        {"name": "cur_syshealth_disk0_errors", "rate": "False"},
        {"name": "http_tot_Requests", "rate": "True"},
        {"name": "http_tot_rxRequestBytes", "rate": "True"},
        {"name": "slave_cpu_use", "rate": "False"},
        {"name": "cur_syshealth_disk0_used", "rate": "False"},
        {"name": "tcp_err_rst_outof_wnd", "rate": "True"},
        {"name": "tcp_err_stray_packets", "rate": "True"},
        {"name": "cur_syshealth_disk1_errors", "rate": "False"},
        {"name": "mgmt_additional_cpu_use", "rate": "False"},
        {"name": "tcp_cur_ServerConnEst", "rate": "False"},
        {"name": "tcp_cur_ClientConnEst", "rate": "False"},
        {"name": "tcp_err_link_giveups", "rate": "False"},
        {"name": "tcp_err_rst_inTimewaits", "rate": "True"},
        {"name": "tcp_err_retransmit", "rate": "True"},
        {"name": "tcp_cur_ServerConnClosing", "rate": "False"},
        {"name": "tcp_err_rst_not_est", "rate": "True"},
        {"name": "http_tot_Responses1_1", "rate": "True"},
        {"name": "tcp_err_rst_not_est", "rate": "True"},
        {"name": "tcp_err_rst_inTimewaits", "rate": "True"},
        {"name": "tcp_err_rst_outof_wnd", "rate": "True"},
        {"name": "tcp_cur_ServerConn", "rate": "False"},
        {"name": "allnic_tot_tx_mbits", "rate": "True"},
        {"name": "http_tot_Responses1_0", "rate": "True"},
        {"name": "cpu_use", "rate": "False"},
        {"name": "tcp_err_retransmit_giveups", "rate": "True"},
        {"name": "http_tot_Requests1_0", "rate": "True"},
        {"name": "mgmt_cpu_use", "rate": "False"},
        {"name": "cur_syshealth_disk1_size", "rate": "False"},
        {"name": "allnic_tot_rx_mbits", "rate": "True"},
        {"name": "master_cpu_use", "rate": "False"},
        {"name": "cur_syshealth_disk0_size", "rate": "False"}
    ],
    "mempool":
    [
        {"name":"mem_err_alloc_failed","rate":"False"}
    ],
    "vserver_ssl":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "cpu":
    [
        {"name":"cc_cpu_use","rate":"False"}
    ],
    "vserver_vpn":
    [
        {"name":"si_cur_state","rate":"False"}
    ],
    "vserver_user":
    [
        {"name":"si_cur_state","rate":"False"},
        {"name":"vsvr_tot_Hits","rate":"True"}
    ]
}
<!--NeedCopy-->

  3. Nachdem Sie die Schemadatei aktualisiert haben, deaktivieren und aktivieren Sie die Metriken.

    set analytics profile <profile_name> metrics DISABLED

set analytics profile <profile_name> metrics ENABLED
<!--NeedCopy-->

Kennzahlen anzeigen

Im Folgenden finden Sie die verschiedenen Möglichkeiten, Metriken zu konsumieren oder zu visualisieren:

  • NetScaler-Befehlszeilenschnittstelle (CLI)
  • Citrix-eigene NITRO-APIs
  • Metriken in die NetScaler Console exportieren
  • Metriken in Observability-Tools exportieren

NetScaler CLI

Sie können die NetScaler CLI verwenden, um die Metriken abzurufen. Melden Sie sich bei NetScaler CLI an und führen Sie den Befehl an der Shell-Eingabeaufforderung aus. Der folgende Befehl ist ein Beispielbefehl:

stat lb vserver <vserver-name>
<!--NeedCopy-->

Beispiel:

> shell
root@ns# stat lb vserver vsrv-wireless
Virtual Server Summary
                      vsvrIP  port     Protocol        State   Health  actSvcs
vsrv...eless               *     0          TCP           UP      100        1

           inactSvcs
vsrv...eless       0
Virtual Server Statistics
                                          Rate (/s)                Total
Vserver hits                                       0                   10
Requests                                           0                    0
Responses                                          0                    0
Request bytes                                      0                 1580
Response bytes                                     0            532594360
Total Packets rcvd                                 0               216463
Total Packets sent                                 0               369898
Current client connections                        --                    0
Current Client Est connections                    --                    0
Current server connections                        --                    0
Requests in surge queue                           --                    0
Requests in vserver's surgeQ                      --                    0
Requests in service's surgeQs                     --                    0
Spill Over Threshold                              --                    0
Spill Over Hits                                   --                    0
Labeled Connection                                --                    0
Push Labeled Connection                           --                    0
Deferred Request                                   0                    0
Invalid Request/Response                          --                    0
Invalid Request/Response Dropped                  --                    0
Bound Service(s) Summary
                          IP  port         Type        State     Hits   Hits/s
svc-internet     192.168.2.2     0          TCP           UP       10      0/s

                 Req    Req/s      Rsp    Rsp/s Throughp ClntConn   SurgeQ
svc-internet       0      0/s        0      0/s        0        0        0
                  SvrConn   ReuseP  MaxConn ActvTran  SvrTTFB     Load
svc-internet         0        0        0        0        0        0

<!--NeedCopy-->

Citrix-eigene NITRO-APIs

Sie können NITRO-APIs ausführen und die erforderlichen Metriken abrufen.

Um beispielsweise die Gesamtzahl der HTTP-Anfragen anzuzeigen, die NetScaler verarbeitet, können Sie die NITRO-API verwenden, indem Sie den folgenden curl-Befehl in der Linux-Shell ausführen:

curl http://{nsip}/nitro/v1/stat/nsglobalcntr?args=counters:http_tot_Requests -u {nsuser}:{nspassword}
<!--NeedCopy-->

Im vorherigen Beispiel

  • nsip ist die NetScaler-IP-Adresse
  • nsuser und nspassword sind die NetScaler-Anmeldeinformationen

Die Ausgabe lautet wie folgt:

root@rohit_lvm:~#  curl "http://10.10.10.10/nitro/v1/stat/nsglobalcntr?args=counters:http_tot_Requests" -u nsroot:freebsd
{ "errorcode": 0, "message": "Done", "severity": "NONE", "nsglobalcntr": { "http_tot_Requests": "33398" } }
<!--NeedCopy-->

Weitere Informationen zu Citrix-eigenen NITRO-APIs finden Sie unter Citrix ADC NITRO-APIs.

Metriken in die NetScaler Console exportieren

Wenn Sie NetScaler Console in Ihrem Netzwerk haben, um Ihre NetScaler zu verwalten, können Sie die Metriken über die NetScaler Console-GUI anzeigen. Weitere Informationen finden Sie in der NetScaler Console-Dokumentation.

Metriken in Observability-Tools exportieren

Sie können Metriken wie Statistiken und Zähler in Observability-Tools wie die folgenden exportieren:

Beispieldashboards

Die folgenden Dashboards, die auf Grafana und Splunk verfügbar sind, bieten Ihnen Metriken, die einem bestimmten Anwendungsfall zugeordnet sind:

Probleme im Zusammenhang mit dem Export von Metriken beheben

Sie können alle Probleme beheben, indem Sie die Debugging-Protokolle verwenden, die am Standort /var/nslog/metricscollector.log gespeichert sind.

Metriken
June 13, 2024
Beitrag von: 
C
June 13, 2024
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.