进行guración de la función AppFlow
喝水configurar演示applow de la堂吉诃德manera缆车上山mayoría de las demás funciones basadas en directivas. En primer lugar, habilite la función AppFlow. A continuación, especifique los recopiladores a los que se envían los registros de flujo. Después de eso, defina acciones, que son conjuntos de recopiladores configurados. A continuación, configure una o varias directivas y asocie una acción a cada directiva. La directiva indica al dispositivo NetScaler que seleccione las solicitudes cuyos registros de flujo se envían a la acción asociada. Por último, vincula cada directiva globalmente o al servidor virtual específico para ponerla en práctica.
Puede configurar aún más los parámetros de AppFlow para especificar el intervalo de actualización de la plantilla y permitir la exportación de la información de HttpURL, HttpCookie y HttPreferer. En cada recopilador, debe especificar la dirección IP de NetScaler como dirección del exportador.
Nota
Para obtener información sobre cómo configurar NetScaler como exportador en el recopilador, consulte la documentación del recopilador específico.
La utilidad de configuración proporciona herramientas que ayudan a los usuarios a definir las directivas y acciones. Determina exactamente cómo el dispositivo NetScaler exporta los registros de un flujo en particular a un conjunto de recopiladores (acción). La interfaz de línea de comandos proporciona un conjunto correspondiente de comandos basados en CLI para los usuarios experimentados que prefieren una línea de comandos.
Activación de AppFlow
帕拉美国能够r la función AppFlow, primero debe habilitarla.
Nota
AppFlow solo se puede habilitar en dispositivos NetScaler de nCore.
Habilitar la función AppFlow mediante la interfaz de línea de comandos
En el símbolo del sistema, escriba uno de los siguientes comandos:
enable ns feature AppFlow
Habilitar la función AppFlow mediante la utilidad de configuración
Vaya aSistema > Configuración, haga clic en进行gurar funciones avanzadasy seleccione la opciónAppFlow.
Especificación de un recopilador
Un recopilador recibe los registros de AppFlow generados por el dispositivo NetScaler. Para enviar los registros de AppFlow, debe especificar al menos un recopilador. De forma predeterminada, el recopilador escucha los mensajes IPFIX en el puerto UDP 4739. Puede cambiar el puerto predeterminado al configurar el selector. Del mismo modo, de forma predeterminada, NSIP se utiliza como IP de origen para el tráfico de AppFlow. Puede cambiar esta IP de origen predeterminada a una dirección SNIP al configurar un recopilador. También puede eliminar los recolectores no utilizados.
Especificar un recopilador mediante la interfaz de línea de comandos
Importante
A partir de la versión 12.1 de NetScaler, compilación 55.13, puede especificar el tipo de recopilador que quiere utilizar. Se introduce un nuevo parámetro “Transport” en el comando
add appflow collector
. De forma predeterminada, el recopilador escucha los mensajes IPFIX. Puede cambiar el tipo de recopilador alogstream
oipfix
o descansar mediante el parámetro “Transporte”. Para obtener más información sobre la configuración, consulte el ejemplo.
En el simbolo del sistema escriba洛杉矶siguientescomandos para agregar un recopilador y verificar la configuración:
- add appflow collector -IPAddress -port -netprofile -Transport - show appflow collector
Ejemplo
add appflow collector col1 -IPaddress 10.102.29.251 -port 8000 -netprofile n2 -Transport ipfix
Especificar varios recopiladores mediante la interfaz de línea de comandos
En el simbolo del sistema escriba洛杉矶siguientescomandos para agregar y enviar los mismos datos a varios recopiladores:
add appflow collector -IPAddress add appflow collector -IPAddress add appflow action -collectors add appflow policy true bind lbvserver -policy -priority
Especificar uno o más recopiladores mediante la utilidad de configuración
Vaya aSistema > AppFlow > Recopiladoresy cree el recopilador de AppFlow.
进行gurar una acción de AppFlow
Una acción AppFlow es un recopilador de conjuntos, al que se envían los registros de flujo si coincide la directiva AppFlow asociada.
进行gurar una acción de AppFlow mediante la interfaz de línea de comandos
En el simbolo del sistema escriba洛杉矶siguientescomandos para configurar una acción de AppFlow y verificar la configuración:
add appflow action --collectors ... [-clientSideMeasurements (Enabled|Disabled) ] [-comment ] show appflow action
Ejemplo
add appflow action apfl-act-collector-1-and-3 -collectors collector-1 collecter-3
进行gurar una acción de AppFlow mediante la utilidad de configuración
Vaya aSistema > AppFlow > Accionesy cree la acción AppFlow.
进行gurar una directiva de AppFlow
Después de configurar una acción de AppFlow, debe configurar una directiva de AppFlow. Una directiva de AppFlow se basa en una regla, que consta de una o más expresiones.
Nota
Para crear y administrar directivas de AppFlow, la utilidad de configuración proporciona asistencia que no está disponible en la interfaz de línea de comandos.
进行gurar una directiva de AppFlow mediante la interfaz de línea de comandos
En el símbolo del sistema, escriba el siguiente comando para agregar una directiva de AppFlow y verificar la configuración:
add appflow policy show appflow policy
Ejemplo
add appflow policy apfl-pol-tcp-dsprt client.TCP.DSTPORT.EQ(22) apfl-act-collector-1-and-3
进行gurar una directiva de AppFlow mediante la utilidad de configuración
Vaya aSistema > AppFlow > Directivasy cree la directiva de AppFlow.
Agregue una expresión mediante el cuadro de diálogo Agregar expresión
En el cuadro de diálogo Agregar expresión, en el primer cuadro de lista, elija el primer término de la expresión.
- HTTP El protocolo HTTP. Elija la opción si quiere examinar algún aspecto de la solicitud que pertenece al protocolo HTTP. - SSL
洛杉矶sitios web protegidos。以利亚la opcion si很。惨死re examinar algún aspecto de la solicitud que pertenezca al destinatario de la solicitud. - CLIENT The computer that sent the request. Choose the option if you want to examine some aspect of the sender of the request. Al elegir, el cuadro de lista situado más a la derecha muestra los términos apropiados para la siguiente parte de la expresión.
- En el segundo cuadro de lista, elige el segundo término para su expresión. Las elecciones dependen de la elección que haya realizado en el paso anterior y son apropiadas para el contexto. Después de hacer la segunda elección, la ventana de Ayuda situada debajo de la ventana Construir expresión (que estaba en blanco) muestra ayuda para describir el propósito y el uso del término que acaba de elegir.
- Siga eligiendo términos en los cuadros de lista que aparecen a la derecha del cuadro de lista anterior o escribiendo cadenas o números en los cuadros de texto que aparecen para pedirle que escriba un valor hasta que finalice la expresión.
Vincular una directiva de AppFlow
Para poner en práctica una directiva, debe vincularla de forma global, de modo que se aplique a todo el tráfico que fluye a través de NetScaler, o a un servidor virtual específico, de modo que la directiva se aplique solo al tráfico relacionado con ese servidor virtual.
Cuando vincula una directiva, le asigna una prioridad. La prioridad determina el orden en que se evalúan las directivas que defina. Puede establecer la prioridad en cualquier número entero positivo.
En el sistema operativo NetScaler, las prioridades de las directivas funcionan en orden inverso: cuanto mayor sea el número, menor será la prioridad. Por ejemplo, si tiene tres directivas con prioridades de 10, 100 y 1000, la directiva a la que se le ha asignado una prioridad de 10 se ejecuta primero. Posteriormente, la directiva se asignó con una prioridad de 100, y finalmente la directiva asignó un orden de 1000.
Puede dejar espacio suficiente para agregar otras directivas en cualquier orden y, aun así, configurarlas para que se evalúen en el orden que quiera. Puede lograrlo estableciendo prioridades con intervalos de 50 o 100 entre cada directiva cuando la vincula globalmente. A continuación, puede agregar más directivas en cualquier momento sin tener que cambiar la prioridad de una directiva existente.
Enlazar globalmente una directiva de演示applow媒体nte la interfaz de línea de comandos
En el símbolo del sistema, escriba el siguiente comando para vincular globalmente una directiva de AppFlow y verificar la configuración:
bind appflow global [] [-invoke ( )] show appflow global
Ejemplo
bind appflow global af_policy_lb1_10.102.71.190 1 NEXT -type REQ_OVERRIDE -invoke vserver google
Enlazar una directiva de AppFlow a un servidor virtual específico mediante la interfaz de línea de comandos
En el símbolo del sistema, escriba el siguiente comando para vincular una directiva de AppFlow a un servidor virtual específico y verificar la configuración:
bind lb vserver -policyname -priority
Ejemplo
bind lb vserver google -policyname af_policy_google_10.102.19.179 -priority 251
Enlazar globalmente una directiva de演示applow媒体nte la utilidad de configuración
Vaya aSistema > AppFlow, haga clic enAdministrador de directivas de AppFlowy seleccione el punto de enlace (predeterminado global) y el tipo de conexión pertinentes y, a continuación, enlace la directiva de AppFlow.
Enlazar una directiva de AppFlow a un servidor virtual específico mediante la utilidad de configuración
Vaya aAdministración del tráfico > Equilibrio de carga > Servidores virtuales, seleccione el servidor virtual y haga clic enDirectivasy vincule la directiva de AppFlow.
Habilitar AppFlow para servidores virtuales
Si quiere supervisar solo el tráfico a través de ciertos servidores virtuales, habilite AppFlow específicamente para esos servidores virtuales. Puede habilitar AppFlow para el equilibrio de carga, el cambio de contenido, la redirección de caché, la VPN con SSL, GSLB y servidores virtuales de autenticación.
Habilitar AppFlow para un servidor virtual mediante la interfaz de línea de comandos
En la línea de comandos, escriba:
set cs vserver -appflowLog ENABLED
Ejemplo
set cs vserver Vserver-CS-1 HTTP 10.102.29.161 80 -appflowLog ENABLED
Habilitar AppFlow para un servidor virtual mediante la utilidad de configuración
Vaya aAdministración del tráfico > Cambio de contenido > Servidores virtuales, seleccione el servidor virtual y habilite la opción Registro de AppFlow.
Habilitar AppFlow para un servicio
Puede habilitar AppFlow para los servicios que se van a vincular a los servidores virtuales de equilibrio de carga.
Habilitar AppFlow para un servicio mediante la interfaz de línea de comandos
En la línea de comandos, escriba:
set service -appflowLog ENABLED
Ejemplo
set service ser -appflowLog ENABLED
Habilitar AppFlow para un servicio mediante la utilidad de configuración
Vaya aAdministración del tráfico > Equilibrio de carga > Servicios, seleccione el servicio y habilite la opción Registro de AppFlow.
Establecer los parámetros de AppFlow
Puede configurar los parámetros de AppFlow para personalizar la exportación de datos a los recopiladores.
Establezca los parámetros de AppFlow mediante la interfaz de línea de comandos
Importante
A partir de NetScaler versión 12.1 compilación 55.13, puede utilizar el NSIP para enviar registros
Logstream
en lugar del SNIP. Se introduce un nuevo parámetro “logstreamOverNSIP” en el comandoset appflow param
. De forma predeterminada, el parámetro “LogStreamOvernSIP” es DISABLED, debe “ENABLE”. Para obtener más información sobre la configuración, consulte el ejemplo.A partir de la versión 13.0 build 58.x de NetScaler, puede habilitar la opción de aplicación Web SaaS en la función AppFlow. Se puede habilitar para recibir el uso de datos de aplicaciones web o SaaS del servicio Citrix Gateway. Para obtener más información sobre la configuración, consulte el ejemplo.
En el simbolo del sistema escriba洛杉矶siguientescomandos para establecer los parámetros de AppFlow y verificar la configuración:
- set appflow param [-templateRefresh ] [-appnameRefresh ] [-flowRecordInterval ] [-udpPmtu ] [-httpUrl ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpCookie ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpReferer ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpMethod ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpHost ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpUserAgent ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpXForwardedFor ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )][-clientTrafficOnly ( \*\*YES\*\* | \*\*NO\*\*)] [-webSaaSAppUsageReporting ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-logstreamOverNSIP ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] - show appflow Param
Ejemplo
set appflow Param -templateRefresh 240 -udpPmtu 128 -httpUrl enabled -webSaaSAppUsageReporting ENABLED -logstreamOverNSIP ENABLED
Establezca los parámetros de AppFlow mediante la utilidad de configuración
Vaya aSistema > AppFlow, haga clic enCambiar configuración de AppFlowy especifique los parámetros de AppFlow relevantes.
Soporte para ofuscación de ID de suscriptor
从de la版本13.0 35。xx de NetScaler, la configuración de AppFlow se ha mejorado para admitir el algoritmo “SubscriberidOfuscation” para ofuscar MSISDN en los registros de AppFlow de capa 4 o capa 7. Sin embargo, antes de configurar el algoritmo como MD5 o SHA256, primero debe habilitarlo como un parámetro de AppFlow. El parámetro está inhabilitado de forma predeterminada.
进行gurar el algoritmo de ofuscación de ID de suscriptor mediante la CLI
En la línea de comandos, escriba:
设置演示applow param [-subscriberIdObfuscation (ENABLED | DISABLED ) [-subscriberIdObfuscationAlgo ( MD5 | SHA256 )]]
Ejemplo
set appflow param –subscriberIdObfuscation ENABLED – subscriberIdObfuscationAlgo SHA256
进行gurar el algoritmo de ofuscación de ID de suscriptor mediante la GUI
- Vaya aSistema > AppFlow.
- En el panel detallado de AppFlow, haga clic enCambiar configuración de AppFlowen进行guración.
En la página Configure AppFlow Settings, defina los siguientes parámetros:
- Ofuscación de ID de suscriptorHabilite la opción de ofuscación de MSISDN en los registros de AppFlow L4/L7.
- Algo de ofuscación de ID de abonado.Seleccione el tipo de algoritmo como MD5 o SHA256.
Haga clic enAceptaryCerrar.
Ejemplo: configurar AppFlow para DataStream
El siguiente ejemplo ilustra el procedimiento para configurar AppFlow para DataStream mediante la interfaz de línea de comandos.
enable feature appflow add db user sa password freebsd add lbvserver lb0 MSSQL 10.102.147.97 1433 -appflowLog ENABLED add service sv0 10.103.24.132 MSSQL 1433 -appflowLog ENABLED bind lbvserver lb0 sv0 add appflow collector col0 -IPAddress 10.102.147.90 add appflow action act0 -collectors col0 add appflow policy pol0 "mssql.req.query.text.contains("select")" act0 bind lbvserver lb0 -policyName pol0 -priority 10
Cuando el dispositivo NetScaler recibe una solicitud de base de datos, el dispositivo evalúa la solicitud en función de una directiva configurada. Si se encuentra una coincidencia, los detalles se envían al recopilador AppFlow configurado en la directiva.
进行gurar el recopilador de métricas
El recopilador de métricas es un servicio que puede habilitar en NetScaler para recopilar y exportar métricas de NetScaler a varios puntos de conexión. Puede exportar las métricas en dos formatos: Avro y Prometheus. Las métricas exportadas se pueden procesar y visualizar para obtener información significativa. De forma predeterminada, el recopilador de métricas admite la exportación de datos de análisis de series temporales cada 30 segundos. Sin embargo, puede configurarlo como un valor de 30 a 300 segundos para poder decidir el intervalo para exportar los datos del perfil de análisis de series temporales.
Haga lo siguiente para configurar un recopilador de métricas mediante la CLI.
进行gure un servicio recopilador con dirección IP, protocolo y puerto mediante el siguiente comando.
add service
Ejemplo:
add service metrics_service1 192.168.1.1 HTTP 5563
进行gure el perfil de series temporales de análisis para enviar datos de métricas al servicio recopilador. Especifique el servicio recopilador, la frecuencia de exportación de métricas y el modo de salida.
set analytics profile ns_analytics_time_series_profile -collectors
-type timeseries -metrics ENABLED metricsExportFrequency <30-300> -outputMode Ejemplo:
set analytics profile ns_analytics_time_series_profile -collectors metrics_service1 -type timeseries -metrics Enabled metricsExportFrequency 90 -outputMode prometheus --serveMode PUSH
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 comandoadd 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 del recopilador de métricas mediante el comando
show analytics profile
: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
Recolector de métricas de depuración
Los registros de depuración necesarios se almacenan en la ubicación/var/nslog/metricscollector.log
.
Generación de archivos de
Los archivosmetrics_
se generan en la ubicación de la carpeta/var/nslog/
.
Soporte de esquemas dinámicos en el colector de métricas
反对el soporte de los康塔德esquemas dinamicos, 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 del recopilador de métricas se
/var/metrics_conf/schema.json
puede instalar en un dispositivo NetScaler mediante el procedimiento installns.
进行gurar el recopilador de métricas para suscribir contadores mediante la CLI
Inicie la exportación de métricas configurando un servicio de recopilador.
En la línea de comandos, escriba:
set analytics profile ns_analytics_time_series_profile -metrics ENABLED -collectors -schemaFile schema.json -outputMode
Nota:
schema.json
es la configuración predeterminada de SchemaFile.
Se puede configurar un nuevo archivo de esquema con un conjunto de contadores necesario mediante el comando CLI para que el recopilador de métricas lo exporte. 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.
进行gurar un archivo de esquema mediante la CLI
set analytics profile ns_analytics_time_series_profile -metrics ENABLED -collectors -schemaFile -outputMode
Se puede agregar y configurar un nuevo archivo de esquema con los contadores necesarios mediante el comando CLI anterior para que el recopilador de métricas lo exporte.
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.
有限公司mpruebe 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: Profile-type: timeseries Output Mode: avro Metrics: ENABLED Schema File: schema.json Events: ENABLED Auditlog: DISABLED Serve mode: Push Reference Count: 0
Pasos para actualizar la lista de contadores exportados
El procedimiento siguiente describe los pasos para actualizar la lista de contadores exportados:
- Actualice el archivo de esquema personalizado/nuevo.
- Inhabilite o habilite las métricas mediante la opción
-metrics
que se muestra en la configuración de la CLI para utilizar el archivo de esquema actualizado.
Soporte de múltiples perfiles de series temporales
El recopilador de métricas admite hasta tres configuraciones de perfiles de series temporales en el dispositivo NetScaler. Puede configurar cada serie temporal para que tenga lo siguiente.
有限公司leccionista.
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.
有限公司n la compatibilidad con múltiples perfiles de series temporales, el recopilador de métricas 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).
Agregue un perfil de series temporales mediante la CLI
En la línea de comandos, escriba:
add analytics profile -type timeseries
进行gure el perfil de series temporales mediante la CLI
En la línea de comandos, escriba:
set analytics profile -metrics -auditlogs -events -collectors -schemaFile schema.json -outputMode
有限公司nvenciones 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_
._log.* - Los archivos de registro de Prometheus se generan como
metrics_prom_
..log
Notas:
- 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.
- La función de esquema dinámico se admite a partir de la versión 13.1, compilación 23.16.
- El perfil de varias series temporales es compatible a partir de la versión 13.1, compilación 33.6.
En este artículo
- Activación de AppFlow
- Especificación de un recopilador
- 进行gurar una acción de AppFlow
- 进行gurar una directiva de AppFlow
- Vincular una directiva de AppFlow
- Habilitar AppFlow para servidores virtuales
- Habilitar AppFlow para un servicio
- Establecer los parámetros de AppFlow
- Soporte para ofuscación de ID de suscriptor
- Ejemplo: configurar AppFlow para DataStream
- 进行gurar el recopilador de métricas