Documentación de productos
ADC
14.1 - Current Release 13.1 13.0 12.1
Ver PDF

Métricas

July 15, 2024
Contribución de: 
C

Las métricas se refieren al fragmento de datos que NetScaler rastrea. Las métricas proporcionan información valiosa y son útiles para realizar un seguimiento del estado de NetScaler y de las aplicaciones gestionadas por NetScaler.

Una serie temporal es una secuencia de puntos de datos secuenciales que se producen durante un intervalo de tiempo determinado. NetScaler admite la configuración del perfil de series temporales de análisis para enviar métricas a un servicio.

Configurar métricas

Puede habilitar las métricas en NetScaler para recopilar y exportar métricas de NetScaler a varios dispositivos de punto final. Puede exportar las métricas en los siguientes formatos: Avro, Prometheus y JSON. Las métricas exportadas se pueden procesar y visualizar para obtener información significativa. De forma predeterminada, las métricas admiten la exportación de datos de análisis de series temporales cada 30 segundos. Sin embargo, puede configurarlo con un valor de entre 30 y 300 segundos según sus necesidades.

Haga lo siguiente para configurar una métrica mediante la CLI de NetScaler.

  1. Configure un servicio con la dirección IP, el protocolo y el puerto mediante el siguiente comando:

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

    Ejemplo:

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

  2. Configure el perfil de series temporales de análisis para enviar métricas al servicio. Especifique el servicio, la frecuencia de exportación de las métricas y el modo de salida.

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

    Ejemplo:

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

    Nota:

    En este ejemplo se utiliza el perfil de serie temporal predeterminado ns_analytics_time_series_profile. Si desea crear un perfil de series temporales, puede utilizar el comando add analytics profile.

    En este ejemplo, la frecuencia de exportación de métricas se establece en 90 segundos y el modo de exportación se especifica como Prometheus.

    Verifique la configuración de las métricas mediante el comando 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-->

Generación de archivos de métricas

Los archivos metrics_<format>_log.* se generan en la ubicación de la carpeta /var/nslog/.

Compatibilidad con esquemas dinámicos

A partir de la versión 13.1 build 24.38 de NetScaler, se admiten los contadores de esquemas dinámicos. Con el soporte de los contadores de esquemas dinámicos, se puede actualizar un archivo de esquema que contenga una lista de contadores en tiempo de ejecución según los requisitos. De forma predeterminada, el archivo /var/metrics_conf/schema.json se configura con una lista de contadores.

Nota:

  • El archivo de esquema predeterminado de métricas /var/metrics_conf/schema.json se puede instalar en un dispositivo NetScaler mediante un procedimiento installns. Para obtener información sobre el procedimiento installns, consulte Actualizar y revertir versión en un dispositivo NetScaler.
  • El archivo de esquema predeterminado /var/metrics_conf/schema.json se compone de algunas entidades y contadores que no forman parte de reference_schema.json. Estos contadores se conservan en schema.json por motivos de compatibilidad con versiones anteriores porque formaban parte de la versión anterior de las métricas que admitía el esquema estático.

Configurar las métricas para suscribir contadores mediante la CLI

Inicie la exportación de métricas configurando un servicio.

En la línea de comandos, escriba:


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

<!--NeedCopy-->

Nota:

schema.json es la configuración predeterminada de SchemaFile.

Se puede configurar un nuevo archivo de esquema con el conjunto requerido de contadores mediante el comando CLI para exportar las métricas. El archivo de esquema debe estar presente en la ubicación /var/metrics_conf/.

El archivo de esquema que contiene toda la lista de contadores (reference_schema.json) admitidos por stats infra está presente en la ubicación /var/metrics_conf/. Este archivo se puede usar como referencia para crear una lista personalizada de contadores.

Configurar un archivo de esquema mediante la CLI 

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

<!--NeedCopy-->

Se puede agregar y configurar un nuevo archivo de esquema con los contadores necesarios mediante el comando CLI anterior para exportar las métricas.

El archivo de esquema de referencia con toda la lista de contadores (reference_schema.json) compatibles con stats infra está presente en la ubicación /var/metrics_conf/. Este archivo se puede usar como referencia para crear una lista personalizada de contadores.

Compruebe el resultado de la configuración de CLI en el símbolo del sistema:


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

Pasos para actualizar la lista de contadores exportados

Siga estos pasos para actualizar la lista de contadores exportados:

  1. Actualice el archivo de esquema personalizado/nuevo.
  2. Inhabilite y habilite las métricas mediante la opción -metrics que se muestra en la configuración de la CLI para usar el archivo de esquema actualizado.

Compatibilidad con varios perfiles de series temporales

A partir de la versión 13.1 compilación 33.47, NetScaler admite hasta tres configuraciones de perfiles de series temporales.

Puede configurar cada serie temporal para que tenga lo siguiente:

  • Coleccionista.

  • Archivo de esquema que contiene el conjunto de contadores que se debe exportar.

  • El formato de datos en el que se van a exportar las métricas.

  • La opción de habilitar o inhabilitar los registros y eventos de auditoría de métricas.

Con la compatibilidad con múltiples perfiles de series temporales, se puede exportar simultáneamente un conjunto diferente (según el archivo de esquema configurado) de métricas a diferentes recopiladores en diferentes formatos (Avro, Prometheus, Influx).

Nota:

Aunque las métricas se pueden habilitar en todos los perfiles de series temporales configurados, los registros de eventos y auditoría solo se pueden habilitar en un perfil.

Agregue un perfil de series temporales mediante la CLI

En la línea de comandos, escriba:

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

Configure el perfil de series temporales mediante la CLI

En la línea de comandos, escriba:

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

Convenciones de nomenclatura de archivos de registro compatibles con múltiples perfiles de series temporales

  • Los archivos de registro de Avro se generan como metrics_avro_<profile_name>_log.*.
  • Los archivos de registro de Prometheus se generan como metrics_prom_<profile_name>.log.

Configurar la exportación de métricas específicas para casos de uso

Puede exportar solo las métricas relacionadas con un caso de uso específico creando un archivo de esquema. Por ejemplo, si desea ver solo las métricas relacionadas con el tráfico TCP, puede crear un archivo tcptrafficschema.json para exportar solo las métricas relacionadas con el tráfico TCP. Con la exportación de métricas específicas para casos de uso, es más fácil encontrar las métricas que desea.

NetScaler admite la exportación de métricas para los siguientes casos de uso:

  • Servidor virtual
  • Seguridad de las aplicaciones
  • Tráfico SSL
  • Tráfico TCP
  • Tráfico HTTP
  • Descripción general del sistema

Servidor virtual

Para ver solo las métricas relacionadas con el servidor virtual, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, vserver_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile vserver_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Seguridad de las aplicaciones

Para ver solo las métricas relacionadas con la seguridad de las aplicaciones, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, appsec_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile appsec_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Tráfico SSL

Para ver solo las métricas relacionadas con SSL, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, ssltraffic_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile ssltraffic_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Tráfico TCP

Para ver solo las métricas relacionadas con TCP, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, tcptraffic_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile tcptraffic_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Tráfico HTTP

Para ver solo las métricas relacionadas con HTTP, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, httptraffic_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile httptraffic_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Descripción general del sistema

Para ver solo las métricas relacionadas con la descripción general del sistema, siga estos pasos:

  1. Inicie sesión en la CLI de NetScaler y vaya a la carpeta /var/metrics_conf/.

  2. Cree un archivo de esquema. Por ejemplo, system_metrics.json.

    set analytics profile ns_analytics_time_series_profile -schemaFile system_metrics.json
<!--NeedCopy-->

  3. Agregue el siguiente contenido y guarde los cambios:

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

Ver métricas

Las siguientes son las diferentes formas de consumir o visualizar las métricas:

  • Interfaz de línea de comandos (CLI) de NetScaler
  • API NITRO de propiedad de Citrix
  • Exportar métricas a NetScaler Console
  • Exportar métricas a herramientas de observabilidad

CLI de NetScaler

Puede usar la CLI de NetScaler para obtener las métricas. Inicie sesión en la CLI de NetScaler y ejecute el comando desde la línea de comandos de Shell. El comando siguiente es un comando de ejemplo:

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

Ejemplo:

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

API NITRO de propiedad de Citrix

Puede ejecutar las API de NITRO y obtener las métricas necesarias.

Por ejemplo, para ver el número total de solicitudes HTTP que gestiona NetScaler, puede usar la API NITRO ejecutando el siguiente comando curl en el shell de Linux:

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

En el ejemplo anterior,

  • nsip es la dirección IP de NetScaler
  • nsuser y nspassword son las credenciales de inicio de sesión de NetScaler

El resultado es el siguiente:

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

Para obtener más información sobre las API NITRO de propiedad de Citrix, consulte API NITRO de Citrix ADC.

Exportar métricas a NetScaler Console

Si tiene NetScaler Console en su red para administrar sus NetScalers, puede ver las métricas a través de la GUI de NetScaler Console. Para obtener más información, consulte la documentación de NetScaler Console.

Exportar métricas a herramientas de observabilidad

Puede exportar métricas, como estadísticas y contadores, a herramientas de observabilidad como:

Cuadros de mando de muestra

Los siguientes paneles disponibles en Grafana y Splunk proporcionan métricas asociadas a un caso de uso específico:

Solucionar problemas relacionados con la exportación de métricas

Puede solucionar cualquier problema utilizando los registros de depuración que se almacenan en la ubicación /var/nslog/metricscollector.log.

Métricas
July 15, 2024
Contribución de: 
C
July 15, 2024
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.