Application Real-Time Monitoring Service:ARMS convergence policies

Convergencia basada en anotaciones de Spring

En las API RESTful con variables de ruta, usar las URL de solicitud sin procesar como valores de dimensión provoca divergencia. ARMS lee la información de ruta desde las anotaciones de enrutamiento de Spring (como @RequestMapping) y utiliza la ruta definida en la anotación como valor de dimensión.

Ejemplo

El siguiente APIController define un endpoint RESTful que recupera información de usuarios mediante una variable de ruta. La anotación @RequestMapping("/api/v1/user/{userId}/info") especifica el patrón de la URL.

@RestController
@RequestMapping("/api/v1")
public class APIController {

    @RequestMapping("/user/{userId}/info")
    public String getUserInfo(@PathVariable("userId") String userId) {
        return "hello " + userId;
    }
}

Resultado: /api/v1/user/1234/info converge a /api/v1/user/{userId}/info.

Convergencia basada en estadísticas de memoria

Cuando las aplicaciones no usan el framework Spring Web, o si la convergencia basada en anotaciones falla, ARMS recurre a la convergencia basada en estadísticas de memoria.

Ejemplo

Una aplicación proporciona la plantilla de URL /api/v1/user/${userId}/info. El módulo de estadísticas de memoria detecta divergencia en los identificadores de usuario y hace que la URL converja a /api/v1/user/*/info.

Convergencia personalizada

Defina reglas de convergencia personalizadas para comparar URL con expresiones regulares y reemplazarlas por un destino específico.

Ejemplo

Regla personalizada: hacer que todas las URL que coincidan con /api/v1/user/[\d]+/info converjan a /api/v1/getUserInfo.

Resultado: todas las URL que coinciden con la expresión regular /api/v1/user/[\d]+/info convergen a /api/v1/getUserInfo.

Convergencia de recursos estáticos

Algunas versiones anteriores del agente de ARMS monitorean métricas de recursos estáticos. Dado que las URL de estos recursos cambian con frecuencia, la convergencia para dichas métricas está habilitada de forma predeterminada.

Extensiones de recursos estáticos predeterminadas:

.log .7z .tgz .jpg .jpeg .png .gif .css .js .ico .woff2 .xml .svg .pdf .txt .text .ppt .word .xlsx .tar.gz .tar.bz2 .sh .yml .yaml .zip .gz .ttf .woff .eot .rar .properties

Ejemplo

De forma predeterminada, /api/v1/hello.jpg converge a {ARMS_STATIC_REQ}. Con la configuración avanzada habilitada, converge a {ARMS_S_JPG}.

Convergencia de solicitudes de ciberataque

Los servicios pueden recibir solicitudes de ciberataque (como intentos de leer el archivo /etc/passwd). Estas solicitudes las elaboran los atacantes y cambian con frecuencia, por lo que registrarlas todas satura los recursos de almacenamiento.

Caracteres predeterminados: ' $ \ ' !

Ejemplo

/app/v1/user/info?cmd='more /etc/passwd' converge a {ARMS_ATTACK_REQ}.

Convergencia de parámetros de consulta

De forma predeterminada, el agente de ARMS no captura los parámetros de consulta al recopilar URL. Sin embargo, algunas URL contienen parámetros de consulta que pueden provocar divergencia.

Delimitadores de parámetros de consulta predeterminados: ; ? &

Ejemplo

De forma predeterminada, /api/v1/user/info?userId=12345 converge a {ARMS_PARAMED_REQ}. Con la configuración avanzada habilitada, converge a /api/v1/user/info?{ARMS_REQ_PARAMS}.

Convergencia de palabras sin significado

Las URL con palabras o cadenas de dígitos demasiado largas tienden a divergir. ARMS reemplaza los segmentos de ruta que superan los umbrales de longitud especificados.

Ejemplo

/api/2024040710/hello2024040710 converge a /api/{ARMS_NUMBER}/{ARMS_ANY}.

Convergencia inteligente

Después de aplicar las políticas anteriores, es posible que queden algunas URL divergentes. ARMS genera periódicamente reglas de convergencia mediante algoritmos para gestionar estas URL.

Ejemplo

/api/product/1/info
/api/product/2/info
....
/api/product/N/info

El servidor compara estas URL mediante la expresión regular /api/product/[\d]+/info y las hace converger a /api/product/{ARMS_NUMBER}/info.

Normalización de SQL

El agente de ARMS puede recopilar una gran cantidad de instrucciones SQL debido a la fragmentación (sharding), las anotaciones o los literales en línea. ARMS normaliza cada instrucción SQL al reemplazar los valores divergentes.

Ejemplo

select * from cache_0 where ckey='23'

Resultado:

select * from cache_{NUM} where ckey=?

Convergencia de direcciones IP

Si su aplicación depende de muchos servicios externos a los que se accede mediante direcciones IP, el agente de ARMS puede recopilar una gran cantidad de direcciones IP únicas, lo que provoca divergencia.

Ejemplo

1.1.1.1:8080
...
1.1.1.255:8080

Estas direcciones IP convergen a {ARMS_IP}:8080.

Convergencia de espacio de cardinalidad

Las políticas anteriores resuelven la mayoría de los problemas de alta cardinalidad en las URL. Sin embargo, en las instrucciones SQL y otros tipos de datos aún se puede registrar una gran cantidad de valores de dimensión. Para evitarlo, ARMS limita el número de valores de dimensión que se registran en cada periodo de tiempo.

Umbrales horarios predeterminados

Ejemplo

Suponga que el tamaño del espacio de cardinalidad se establece en 100 registros por hora. Direcciones de servicios externos:

www.a1.com
www.a2.com
....
www.a1000.com

Solo se registran las primeras 100 direcciones por hora. Las direcciones posteriores convergen a {ARMS_OTHERS}.

Agente de ARMS anterior a V4.x

En el lado del agente:

• URL: Convergencia basada en anotaciones de Spring > Convergencia basada en estadísticas de memoria

• SQL: Convergencia basada en estadísticas de memoria

• IP y otros: Convergencia basada en estadísticas de memoria

En el lado del servidor:

• URL: Convergencia personalizada > Convergencia de solicitudes de ciberataque > Convergencia de parámetros de consulta > Convergencia de recursos estáticos > Convergencia de palabras sin significado > Convergencia inteligente > Convergencia de espacio de cardinalidad

• SQL: Convergencia personalizada > Convergencia de espacio de cardinalidad

• IP y otros: Convergencia personalizada > Convergencia de direcciones IP > Convergencia de espacio de cardinalidad

Agente de ARMS V4.x y posteriores

En el lado del agente:

• URL: Convergencia basada en anotaciones de Spring > Convergencia personalizada > Convergencia de solicitudes de ciberataque > Convergencia de parámetros de consulta > Convergencia de recursos estáticos > Convergencia de palabras sin significado > Convergencia inteligente > Convergencia de espacio de cardinalidad

• SQL: Convergencia personalizada > Normalización de SQL > Convergencia de espacio de cardinalidad

• IP y otros: Convergencia personalizada > Convergencia de direcciones IP > Convergencia de espacio de cardinalidad

En el lado del servidor: No aplica (toda la convergencia se ejecuta en el agente).

¿Cómo consulto los valores originales antes de la convergencia?

• Agente de ARMS V4.x y posteriores: Tanto los valores originales como los convergidos se registran en los datos de trazas. Use Trace Explorer para consultar los valores originales.

• Agente de ARMS anterior a V4.x: Los valores originales no están disponibles porque la convergencia ocurre en el servidor.

¿Cómo personalizo las reglas de convergencia?

Defina reglas de convergencia personalizadas en la consola de ARMS. En la página de detalles de la aplicación, elija Configuration > Convergence en la barra de navegación superior.

Por ejemplo, especifique la expresión regular /api/v1/user/\d+/info para que todas las URL coincidentes converjan a /api/v1/user/userId/info. Así, la URL /api/v1/user/124343543/info converge a /api/v1/user/userId/info.

¿Cómo excluyo URL específicas de la convergencia?

Especifique las URL que desea excluir de la convergencia en la consola de ARMS. Vaya a la misma página Configuration > Convergence descrita en la pregunta anterior.

Por ejemplo, si excluye /api/v1/user/9999/info de la convergencia, esta URL no convergerá a /api/v1/user/userId/info.

¿Cuál es la diferencia entre la convergencia en el agente y en el servidor?

La convergencia en el lado del agente procesa los datos en el agente de ARMS antes de enviarlos al servidor. Esto reduce la carga de procesamiento del servidor y garantiza un 100 % de precisión en los datos.

La convergencia en el lado del servidor se aplica cuando la versión del agente no es compatible con ciertas políticas. Sin la convergencia en el agente, este envía paquetes de datos sin converger al servidor. Los paquetes grandes generan dos riesgos:

• Pérdida de datos: los paquetes demasiado grandes pueden rechazarse.

• Menor precisión: las limitaciones de procesamiento del servidor pueden afectar la precisión de los datos convergidos.

Actualice a la versión más reciente del agente de ARMS para ejecutar todas las políticas de convergencia en el agente.