ADC

Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)

Metriken

July 15, 2024

Beitrag von:

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.

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

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

Beispiel:

add service metrics_service1 192.168.1.1 HTTP 5563
 

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>
 

Beispiel:

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

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
 

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>

 

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>

 

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

 

Schritte zum Aktualisieren der Liste der exportierten Leistungsindikatoren

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

Aktualisieren Sie die benutzerdefinierte/neue Schemadatei.
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
 

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>

 

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:

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

Erstellen Sie eine Schemadatei. Beispiel: vserver_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile vserver_metrics.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"}
    ]
}
 

Anwendungssicherheit

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

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

Erstellen Sie eine Schemadatei. Beispiel: appsec_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile appsec_metrics.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"}
    ]
}
 

SSL-Verkehr

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

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

Erstellen Sie eine Schemadatei. Beispiel: ssltraffic_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile ssltraffic_metrics.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"}
    ]
}
 

TCP-Verkehr

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

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

Erstellen Sie eine Schemadatei. Beispiel: tcptraffic_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile tcptraffic_metrics.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"}
    ]
}

 

HTTP-Verkehr

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

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

Erstellen Sie eine Schemadatei. Beispiel: httptraffic_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile httptraffic_metrics.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"}
    ]
}
 

Überblick über das System

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

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

Erstellen Sie eine Schemadatei. Beispiel: system_metrics.json.

set analytics profile ns_analytics_time_series_profile -schemaFile system_metrics.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"}
    ]
}
 

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>
 

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

 

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}
 

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" } }
 

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:

Prometheus - Sie können die Metriken direkt von NetScaler nach Promethus exportieren. Informationen zum Exportieren von Metriken nach Prometheus finden Sie unter Export von Metriken von NetScaler nach Prometheus.
Splunk — Sie können die Metriken direkt von NetScaler nach Grafana exportieren. Informationen zum Exportieren von Metriken nach Splunk finden Sie unter Export von Metriken von NetScaler nach Splunk.

Beispieldashboards

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

Observability-Beispiel-Dashboard für NetScaler ADC auf Grafana
Infra- und Netzwerkstatus-Dashboard für NetScaler ADC auf Splunk
App- und API-Health-Dashboard auf Splunk

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.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

Metriken

July 15, 2024

Beitrag von:

In diesem Artikel

War dieser Artikel hilfreich?