Servicio NetScaler Console

Gobierno de datos para el programa de telemetría de NetScaler

Todos los clientes actuales de NetScaler Console deben cumplir con el programa de telemetría de NetScaler y cargar los datos de telemetría necesarios. El programa de telemetría de NetScaler se habilita a partir de la compilación 14.1-28.x y los datos de telemetría se cargan automáticamente. Para obtener más información, consulte el programa de telemetría de NetScaler. Citrix recopila datos de telemetría de licencias básicos y datos de telemetría de implementación y uso de funciones de NetScaler para sus intereses legítimos, incluido el cumplimiento de las licencias. Los datos de configuración y uso de funciones de la NetScaler Console también se recopilan para administrar, medir y mejorar los productos y servicios de Citrix.

Notas:

  • La carga de telemetría se realiza automáticamente cada 24 horas.

  • Para recopilar y almacenar las métricas de telemetría en sus instancias de NetScaler, se introdujo la siguiente configuración en sus instancias de NetScaler a través de NetScaler Console como parte del programa de telemetría de NetScaler lanzado el 18 de junio de 2024.

enable ns feature AppFlow
add analytics profile telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300
<!--NeedCopy-->
  • El archivo /nsconfig/.telemetry.conf se actualiza con el siguiente comando para la telemetría de Gateway. NetScaler Console comprueba este comando cada hora y, si falta, lo agrega. Este comando solo se envía a las instancias de NetScaler que tienen una configuración de servidor virtual VPN:
ns_telemetry_server,<Console IP>,5140
<!--NeedCopy-->
  • Algunos parámetros de telemetría se recopilan mediante scripts que se envían desde NetScaler Console a las instancias de NetScaler. Estos scripts son de solo lectura y no cambian nada en NetScaler.

La siguiente tabla proporciona los detalles de los parámetros necesarios que se recopilan como parte del programa de telemetría de NetScaler:

Categorías Descripción ¿Para qué lo usamos?
Telemetría de uso e implementación de licencias y uso de NetScaler Información sobre los derechos de licencia, el uso y los datos de implementación de NetScaler de alto nivel y el uso de las funciones de NetScaler. Cumplimiento de licencias y para administrar, medir y mejorar el servicio.
Telemetría de implementación y uso de funciones de NetScaler Console Información sobre la implementación de Console y el uso de las funciones. Gestionar, medir y mejorar el servicio.

Datos de telemetría requeridos

En las tablas siguientes se muestra la lista de datos necesarios recopilados como parte del programa de telemetría de NetScaler:

Licencias

Parámetros Descripción
flex_vpx_inst_titled El total de instancias VPX autorizadas
flex_vpx_inst_allocated El total de instancias VPX asignadas
flex_sdx_inst_titled El total de instancias SDX autorizadas
flex_sdx_inst_allocated El total de instancias SDX asignadas
flex_mpx_inst_titled El total de instancias MPX autorizadas
flex_mpx_inst_allocated El total de instancias MPX asignadas
flex_plt_bw_titled El ancho de banda platino autorizado
flex_plt_bw_allocated El ancho de banda de platino asignado
flex_ent_bw_titled El ancho de banda empresarial autorizado
flex_ent_bw_allocated El ancho de banda empresarial asignado
flex_std_bw_titled El ancho de banda estándar autorizado
flex_std_bw_allocated El ancho de banda estándar asignado
flex_vpx_fips_inst_titled El total de instancias FIPS autorizadas
flex_vpx_fips_inst_allocated El total de instancias FIPS asignadas
license_name El tipo de licencia o el nombre de la función
peak_license_usage El uso máximo de la licencia aplicada en las instancias de NetScaler (asignación)
peak_bandwidth_usage El uso máximo de las instancias de NetScaler
avg_license_usage El uso promedio de la licencia aplicada en las instancias de NetScaler (asignación)
avg_bandwidth_usage El uso promedio de las instancias de NetScaler
license_edition Ancho de banda Platinum/Enterprise/Standard
Nombre de la funcionalidad El nombre de la función de licencia
ID de host El ID de host del dispositivo
Número de serie de la licencia El número de serie de la licencia
Fecha de inicio de la licencia La fecha de inicio de la licencia
Fecha de finalización de la licencia La fecha de finalización de la licencia
Fecha de licencia SA La fecha de ventaja de la suscripción a la licencia
tenantnslictype El tipo de licencia, como CPL, CUL, etc.
instance_id El identificador único de la instancia
instance_mode Comprueba si la instancia es un par independiente o de alta disponibilidad
instance_state El estado de la instancia (activo/inactivo)
is_local_license Comprueba si la licencia está alojada en NetScaler Console
is_pooled_license Comprueba si la licencia es una licencia agrupada
license_edition El tipo de licencia (Platinum/Standard/Enterprise)
license_end_date Número total de días para que caduque la licencia
platform El tipo de dispositivo
plt_license_allocation La asignación de licencias de platino
std_license_allocation La asignación de licencias estándar
ent_license_allocation La asignación de licencias empresariales
nslicensingtype El tipo de licencia (flexible o fija)
instance_ip_address La dirección IP de administración del NetScaler. Nota: La dirección IP se codificará mediante hash*.
total_pooled_devices El total de instancias de NetScaler (administradas y no administradas) con licencias agrupadas
is_pooled_license_server Indica si el servicio NetScaler Console se usa como servidor de licencias agrupado.
perc_discovered_vservers El% de servidores virtuales descubiertos o autorizados
perc_used_vservers El% de servidores virtuales utilizados/autorizados
pool_cpxvcpu_entitled El conjunto total de vCPU CPX titulado
pool_cpxvcpu_used El conjunto total de CPU virtuales CPX utilizadas
pool_entbw_entitled El ancho de banda empresarial total del pool denominado [MBps]
pool_entbw_used El ancho de banda empresarial total utilizado en el pool [MBps]
pool_entvcpu_entitled El conjunto total de vCPU empresariales titulado
pool_entvcpu_used El grupo total utilizado de vCPU empresariales
pool_fips_instances_entitled El conjunto total de instancias FIPS tituladas
pool_fips_instances_used El total de instancias FIPS del grupo utilizadas
pool_instances_entitled El total de instancias del grupo tituladas
pool_instances_used El total de instancias agrupadas utilizadas
pool_perc_bw_used El% de ancho de banda utilizado
pool_perc_instances_used El% de instancias utilizadas
pool_perc_vcpu_used El% de vCPU utilizadas
pool_pltbw_entitled El ancho de banda Platinum total del pool denominado [MBps]
pool_pltbw_used El ancho de banda Platinum total utilizado en el pool [MBps]
pool_pltvcpu_entitled El conjunto total de vCPU Platinum titulado
pool_pltvcpu_used El conjunto total de vCPU Platinum utilizadas
pool_stdbw_entitled El ancho de banda estándar total del pool denominado
pool_stdbw_used El ancho de banda estándar total utilizado
pool_stdvcpu_used El conjunto total de CPU virtuales estándar utilizadas
total_discovered_vservers El total de servidores virtuales descubiertos
total_entitled_vservers El total de servidores virtuales autorizados
total_used_vservers El total de servidores virtuales utilizados

Uso de las funciones de NetScaler Gateway

La siguiente telemetría de datos se recopila solo si la versión local administrada de NetScaler Gateway es 14.1-25.x o posterior:

Parámetros Descripción
accessMode El tipo de modo de acceso. Por ejemplo, ICA, VPN
bytesTransferred El total de bytes enviados y recibidos por sesión
epaScans El número total de escaneos de la EPA
features Las funciones habilitadas en NetScaler Gateway
id El identificador único del evento de uso
prod Identificación del producto de origen y despliegue del evento de uso
prodVer La versión del producto Gateway
email El correo electrónico del usuario de la puerta de enlace. Nota: El ID del correo electrónico se codificará con un hash*.
st La hora actual en la que se están extrayendo los datos
type El tipo de evento utilizado por CAS para identificar los eventos de uso local de Gateway
userName El nombre de usuario de Gateway. Nota: El nombre se codificará con un hash*.
ver La versión del evento de telemetría

Implementación de NetScaler

Parámetros Descripción
total_active_managed_devices El total de instancias de NetScaler que están en estado UP
total_nsap_device El total de instancias de partición de administración en NetScaler Console
total_managed_devices El total de instancias de NetScaler administradas en NetScaler Console
instance_mode Comprueba si la instancia es un par independiente o de alta disponibilidad
instance_state El estado de la instancia (activo/inactivo)
dev_pl_aws El tipo de plataforma del dispositivo
dev_pl_azure El tipo de plataforma del dispositivo
dev_pl_citrix_hypervisor El tipo de plataforma del dispositivo
dev_pl_esx El tipo de plataforma del dispositivo
dev_pl_gcp El tipo de plataforma del dispositivo
dev_pl_hyper_v El tipo de plataforma del dispositivo
dev_pl_kvm El tipo de plataforma del dispositivo
dev_pl_unknown El tipo de plataforma del dispositivo
dev_pl_vpx_on_sdx El tipo de plataforma del dispositivo
total_blx_device El total de instancias BLX administradas en NetScaler Console
total_cpx_device El total de instancias de CPX administradas en NetScaler Console
total_ng_device El total de instancias de Gateway administradas en NetScaler Console
total_ngvpx_device El total de instancias de Gateway VPX administradas en NetScaler Console
total_ns_device El total de instancias MPX administradas en NetScaler Console
total_nssdx_device El total de instancias SDX administradas en NetScaler Console
total_nsvpx_device El total de instancias VPX administradas en NetScaler Console
total_nswg_device El total de instancias de Web Gateway administradas en NetScaler Console
total_nswgvpx_device El total de instancias VPX de Web Gateway administradas en NetScaler Console
device_id El ID único de la instancia VPX
device_platform La plataforma donde está alojada la instancia VPX
state El estado actual (ACTIVO o INACTIVO) de la instancia VPX
aaa_vservers La cantidad total de servidores virtuales AAA
cs_vservers La cantidad total de servidores virtuales de conmutación de contenido
gslb_vservers El número total de servidores virtuales GSLB
lb_vservers_http El número total de servidores virtuales HTTP LB
lb_vservers_ssl El número total de servidores virtuales SSL

Uso de las funciones de NetScaler

Parámetros Descripción
total_aaa_devices El total de instancias de NetScaler configuradas con servidores virtuales AAA
aaa_as_Request_tot_blocked El número total de solicitudes HTTP bloqueadas por el perfil appfw para AAA
aaatm_as_Request_tot_blocked El número total de solicitudes HTTP bloqueadas por el perfil appfw para AAATM
as_Requests_aaatm_lb El número total de solicitudes HTTP procesadas por el módulo appfw en nombre del módulo aaatm_lb
as_Requests_vpn El número total de solicitudes HTTP procesadas por el módulo appfw en nombre del módulo vpn
nsapisec_builtin_tot_hits El número total del esquema de seguridad de API integrado para Project Shield
nsapisec_builtin_tot_validated_success El número total de solicitudes superó correctamente el esquema de seguridad de API integrado para Project Shield
svpn_as_Request_tot_blocked El número total de solicitudes HTTP bloqueadas por el perfil appfw para VPN
appfw.appfirewallrequests El número total de solicitudes de WAF a través del perfil appfw
appfw.appfirewallrequestsrate La tasa total de solicitudes de WAF a través del perfil appfw
appfwprofile.appfw_block El número total de bloqueados aprobados por perfil
appfwprofile.appfw_bypass El número total de solicitudes aprobadas por perfil
appfwprofile.appfw_drop El número total de eliminaciones aprobadas por perfil
appfwprofile.appfw_reset El número total de restablecimientos superados por perfil
bot requests El número total de solicitudes de bots a través del perfil appfw
bot_signature_version La versión de la firma del bot utilizada
botrequestsrate La tasa de solicitudes de bots a través del perfil de bot
waf_signature_version La versión de la firma WAF utilizada
waf.as_requests El número total de solicitudes realizadas a través de todos los perfiles WAF que también incluyen perfiles predeterminados
waf.as_req_bytes El número total de solicitudes realizadas a través de todos los perfiles WAF que excluyen los perfiles predeterminados
total_api_sec_deployments El número total de despliegues de seguridad de API a través del servicio NetScaler Console
ingress_controllers El número total de controladores de ingreso
admin_partitions El número total de particiones
gslb_site_tot_RequestBytes El total de solicitudes en bytes que pasan por el perfil gslb
gslb_site_tot_Requests El total de solicitudes pasan por el perfil gslb
gslb_sites El número total de sitios gslb
gslb.services El número total de servicios gslb
analytics.profile El número total de perfiles de análisis
appfw.policies El número total de políticas de AppFlow
appfw.profiles El número total de perfiles de AppFlow
bot.policies El número total de políticas de bots
bot.profiles El número total de perfiles de bot
category La clasificación del dispositivo. Por ejemplo, Gateway
cluster.nodes El número total de nodos del clúster
cr La cantidad total de servidores virtuales de redirección de caché
cs.all La cantidad total de servidores virtuales de conmutación de contenido
cs.gw El número total de servidores virtuales de conmutación de contenido utilizados como puerta de enlace
cs.used El número total de servidores virtuales de conmutación de contenido direccionables no enlazados a localhost y al protocolo WEB o TCP
deployment_type El tipo de implementación de NetScaler (par de alta disponibilidad o independiente)
ha.node La dirección IP del par HA
lb.all La cantidad total de todos los servidores virtuales de equilibrio de carga
lb.gw La cantidad total de servidores virtuales de equilibrio de carga utilizados como puerta de enlace
lb.used El número total de servidores virtuales de equilibrio de carga direccionables no enlazados a localhost y del protocolo WEB o TCP
nsip El NSIP del NetScaler. Nota: La dirección IP se codificará mediante hash*.
razón El motivo detallado de la clasificación
servidores El número total de servidores virtuales
serviceGroups El número total de ServiceGroups
servicios El número total de servicios
services.dns El número total de servicios de tipo ADNS/ADNS_TCP
VPN El número total de servidores virtuales VPN
vpn.ica La cantidad total de servidores virtuales ICA VPN
vservers.gw La cantidad total de servidores virtuales LB + CS + CR utilizaron una puerta de enlace
vservers.used El número total de servidores virtuales LB + CS + CR direccionables no enlazados a localhost y del protocolo WEB o TCP
waf_protection El tipo de protección de WAF
total_cs_devices El total de instancias de NetScaler configuradas con servidores virtuales de conmutación de contenido
total_gslb_devices El total de instancias de NetScaler configuradas con servidores virtuales de equilibrio de carga de servidores globales
total_gw_devices El total de instancias de NetScaler que están habilitadas con SSL VPN
total_lb_devices El total de instancias de NetScaler configuradas con servidores virtuales de equilibrio de carga
total_lb_devices_http El total de instancias de NetScaler configuradas con servidores virtuales HTTP de equilibrio de carga
is_subscription_enabled Si la configuración de exportación agregada por la suscripción está habilitada o no
telemetry_collected_at La hora a la que se ejecuta el script de telemetría
state El estado actual (activo o inactivo) de la instancia VPX
version La versión de compilación de los dispositivos
exp.events El número total de perfiles de análisis utilizados para exportar eventos
exp.managementlogs El número total de perfiles de análisis utilizados para exportar los registros de administración
exp.metrics El número de perfiles de análisis utilizados para exportar las métricas
exp.auditlogs La cantidad de perfiles de análisis utilizados para exportar los registros de auditoría a Splunk
exp.prometheus El número de perfiles de análisis utilizados para exportar a Prometheus
gw_hdx_insights Si está habilitada la exportación de HDX Insight y Gateway Insight

Implementación de NetScaler Console y uso de funciones

Parámetros Descripción
platform La plataforma en la que se aloja NetScaler Console. Por ejemplo, Citrix Hypervisor
csp Si el arrendatario es un proveedor de servicios Citrix
customer_onboard_date La fecha en la que Citrix Cloud se incorporó
Customer_type Si el cliente es un cliente externo o interno
email ID de correo electrónico del ID de Citrix Cloud (recopilado de Citrix Cloud)
end_date Fecha de finalización del SKU de la consola NetScaler
product_sku El SKU del producto
product_sku_description La descripción del SKU del producto
service_type El tipo de servicio de los arrendatarios
session_count El número de inicios de sesión del último día
start_date Fecha de inicio del SKU de la consola NetScaler
state El estado del SKU de la consola NetScaler
built_in_agents Los agentes integrados que utilizan las instancias de NetScaler para comunicarse con el servicio NetScaler Console
page_views El recuento total de páginas vistas y visitas en la GUI de NetScaler Console
smart_deployment El recuento de despliegues de CADS
botInsight_usage Si la información sobre bots está habilitada (sí o no)
data_from_adm_service  
adm_pop El nombre PoP del servicio NetScaler Console
model_id El tipo de modelo NetScaler
total_haproxy_device El recuento total de dispositivos con el tipo “haproxyhost”
version La fecha de compilación, versión y lanzamiento de NetScaler
is_agt Comprueba si el agente está configurado o no
is_cloud Comprueba si la implementación de NetScaler Console es el servicio NetScaler Console o NetScaler Console de forma local
number_of_ns_upgrade_jobs El total de trabajos de actualización utilizados
visión web Si Web Insight está habilitado en el servidor virtual lb o cs
webinisight_usage Si hay sesiones hdx activas (sí o no)
adm_analyt_hdx_apps El número total de solicitudes del dispositivo que tiene HDX Insight habilitado
adm_analyt_hdx_users El recuento de usuarios conectados a través de Virtual Desktop
adm_analyt_sec_insight El número total de solicitudes del dispositivo que tiene habilitada la información de seguridad
adm_analyt_webinsight El número total de solicitudes del dispositivo que tiene habilitada la visión web
anomalyinsight Indica si la función de solicitud está habilitada en el servidor virtual lb o cs
count El recuento total de problemas relacionados con la analítica
feature La categoría de función del problema identificado. La función puede ser BOT_INSIGHT, DEVICE, GATEWAY_INSIGHT, HDX_INSIGHT, SECURITY_INSIGHT, SERVICE_GRAPH, SWG_INSIGHT, WEB_INSIGHT, WEB_SECURITY_BOT_INSIGHT
feature La función de análisis habilitada en los servidores virtuales de equilibrio de carga
feature La función de análisis habilitada en los servidores virtuales de conmutación de contenido
feature La función de análisis habilitada en los servidores virtuales VPN
gwinsight Indica si la función ICA_REQUEST está habilitada en un servidor virtual VPN
gwinsight_usage Indica si hay algún usuario de HDX en el último día (sí o no)
ge_hdx_insights Se habilitó la exportación de HDX Insight y Gateway Insight
issue_type La categoría de problema a la que pertenece el problema identificado. Por ejemplo, licencias, configuración
secinsight Indica si la información de seguridad está habilitada en el servidor virtual lb o cs
secinsight_usage Si se detectaron ataques de seguridad en el último día (sí o no)
sub_issue_type La subcategoría del problema identificado. La subedición puede ser NO_VIPS_LICENSED, BOT_INSIGHT_IN_ACTION_DISABLED, NS_FEATURE_DISABLED, VSERVER_WITHOUT_BOT_POLICY_BINDING, NO_COLLECTORS_PRESENT, APPFLOWPARAM_DISABLED, ICA_APPFLOW_POLICY_BINDING, VSERVER_WITHOUT_APPFIREWALL_POLICY_BINDING, SECURITY_INSIGHT_IN_ACTION_DISABLED, NO_CPX_VIPS_PRESENT, COLLECTOR_UNBOUND_IN_VSERVER, VSERVER_WITHOUT_APPFLOW_POLICY_BINDING
total_api_discovery El total de instancias de NetScaler que reciben solicitudes de API
total_csvserver_ft_enabled El total de servidores virtuales de conmutación de contenido en los que está habilitada al menos una función de análisis
total_lbvserver_ft_enabled Los servidores virtuales de equilibrio de carga total en los que está habilitada al menos una función de análisis
total_web_transaction_analytics El total de instancias de NetScaler habilitadas con el análisis de transacciones web
agt_pl_azure El tipo de plataforma del agente
agt_pl_citrix_hypervisor El tipo de plataforma del agente
agt_pl_docker El tipo de plataforma del agente
agt_pl_esx El tipo de plataforma del agente
agt_pl_hyper_v El tipo de plataforma del agente
agt_pl_gcp El tipo de plataforma del agente
agt_pl_kvm El tipo de plataforma del agente
agt_pl_kubernetes El tipo de plataforma del agente
agt_pl_unknown El tipo de plataforma del agente
agt_pl_aws El tipo de plataforma del agente
agent_id El identificador único del agente implementado
city La ciudad en la que está desplegado el agente
country El país en el que está desplegado el agente
platform La plataforma en la que se aloja NetScaler Console. Por ejemplo, Citrix Hypervisor
region La región en la que está desplegado el agente
total_active_agents El total de agentes que se encuentran en el estado activo
version La versión del agente
city La ciudad del centro de datos
isCloud Ya sea local o en la nube
total_k8s La consola de NetScaler alojada en el clúster de Kubernetes. El total de clústeres de Kubernetes
total_apps El total de aplicaciones de NetScaler Console
total_custom_sites El total de sitios personalizados configurados en NetScaler Console
total_managed_apps El total de aplicaciones administradas en NetScaler Console
total_custom_apps El total de aplicaciones personalizadas de NetScaler Console
root Los detalles de uso del disco de la consola NetScaler se encuentran en los directorios /var, /root, /flash, /var/mps
total El espacio total en disco de la consola NetScaler (unidad: bytes)
used El espacio total utilizado en disco de la consola NetScaler
free El espacio total disponible en disco de la consola NetScaler
total_api_requests El total de solicitudes a través de la API a NetScaler Console en las últimas 24 horas. Esto también incluye a los usuarios de proxy remotos (solicitudes del agente).
total_api_external_requests El total de solicitudes a través de la API a NetScaler Console que excluyen las solicitudes del agente
total_gui_requests El total de usuarios que han iniciado sesión en la GUI de NetScaler Console en las últimas 24 horas
total_users El recuento total de usuarios locales de NetScaler Console
total_config_audit La plantilla de auditoría de configuración total configurada en NetScaler Console
total_config_job El total de trabajos de configuración creados en NetScaler Console
total_ssl_certs La certificación SSL total que se crea, modifica o elimina de NetScaler Console
total_custom_event_rules El total de reglas de eventos personalizadas creadas en NetScaler Console
total_success_preauth_requests El recuento de solicitudes exitosas para generar los tokens de preautenticación
total_event_rules El total de reglas de eventos creadas en NetScaler Console
total_ingress_deployed El total de controladores de ingreso en Kubernetes.
total_ipam El total de proveedores de IPAM agregados a NetScaler Console
total_ipam_configured El total de redes de IPAM agregadas a NetScaler Console
total_network_report El informe de red total creado en NetScaler Console
total_pager_duty_profile El total de perfiles de PagerDuty agregados en NetScaler Console
total_rbac_groups El total de grupos RBAC configurados en NetScaler Console
total_slack_profile El total de perfiles de Slack añadidos en NetScaler Console
total_ssl_certs La certificación SSL total que se crea, modifica o elimina de NetScaler Console
total_stylebook_config_store_count El total de paquetes de configuración creados en NetScaler Console
total_user_sb_stylebook_count El total de paquetes de configuración personalizados creados en NetScaler Console
configpack El número total de paquetes de configuración almacenados en StyleBooks
export_end_point El punto final al que se envían los datos.
export_frequency La exportación de datos es por hora o por día
export_type El destino al que se envía la fecha. Ejemplo: Splunk, New Relic
gather_feature Qué datos se exportan. Ejemplo: WAF, Bot
subscribed_by El usuario que ha agregado la configuración de observabilidad
subscription_name El nombre de la suscripción para identificar la configuración
subscription_notification_enabled Si hay alguna configuración de notificación habilitada para la exportación

*La información recopilada mediante telemetría, como las direcciones de correo electrónico, los nombres de usuario y las direcciones IP, se seudonimiza de forma segura codificando la información en el origen mediante algoritmos hash unidireccionales. Como resultado, Citrix no puede acceder a estos valores ni leerlos. Estos datos de telemetría se usan únicamente con fines de comparación lógica de activos.

Gobierno de datos para el programa de telemetría de NetScaler