Capacidad de una instancia de Azure API Management
SE APLICA A: Desarrollador | Básico | Básico v2 | Estándar | Estándar v2 | Premium | Premium v2
API Management proporciona métricas de Azure Monitor para detectar el uso de la capacidad del sistema, lo que le ayuda a solucionar problemas de puerta de enlace y a tomar decisiones informadas sobre si escalar o actualizar una instancia de API Management para dar cabida a más carga.
En este artículo se explican las métricas de capacidad y cómo se comportan, se muestra cómo acceder a las métricas de capacidad en Azure Portal y se sugiere cuándo considerar la posibilidad de escalar o actualizar la instancia de API Management.
Nota:
Actualmente esta característica no está disponible en las áreas de trabajo.
Importante
En este artículo se presenta cómo supervisar y escalar la instancia de Azure API Management en función de las métricas de capacidad. Sin embargo, cuando una instancia alcanza su capacidad, no se limitará para evitar la sobrecarga. En su lugar, actuará como un servidor web sobrecargado: mayor latencia, conexiones eliminadas y errores de tiempo de espera. Los clientes de API deben estar listos para controlar estos problemas, ya que lo hacen con otros servicios externos, por ejemplo, mediante directivas de reintento.
Requisitos previos
Para seguir los pasos descritos en este artículo, debe tener una instancia de API Management en uno de los niveles que admita métricas de capacidad. Para más información, vea Creación de una instancia de Azure API Management.
Métricas de capacidad disponibles
Hay diferentes métricas de capacidad disponibles en los niveles de servicio de v2 y niveles clásicos.
En los niveles v2, están disponibles las siguientes métricas:
Porcentaje de CPU de puerta de enlace: el porcentaje de capacidad de CPU que usan las unidades de puerta de enlace.
Porcentaje de memoria de la puerta de enlace: el porcentaje de capacidad de memoria usada por las unidades de puerta de enlace.
Las agregaciones disponibles para estas métricas son las siguientes.
- Promedio : porcentaje medio de capacidad usada en los procesos de puerta de enlace en cada unidad de una instancia de API Management.
- Máximo: porcentaje de capacidad en el proceso de puerta de enlace con el mayor consumo.
El uso de la CPU y la memoria revela el consumo de recursos por:
- Los servicios de plano de datos de API Management, como el procesamiento de solicitudes, lo que puede incluir el reenvío de solicitudes o la ejecución de una directiva.
- Los servicios de plano de datos de API Management, como las acciones de administración aplicadas a través de Azure Portal o Azure Resource Manager, o la carga procedente del portal para desarrolladores.
- Procesos seleccionados del sistema operativo, entre los que se incluyen los procesos que implican el costo de los protocolos de enlace TLS en las nuevas conexiones.
- Actualizaciones de plataforma, como actualizaciones del sistema operativo en los recursos de proceso subyacentes para la instancia.
- Número de API implementadas, independientemente de la actividad, que pueden consumir capacidad adicional.
Comportamiento de la métrica de capacidad
En las métricas de capacidad de la vida real pueden verse afectadas por muchas variables, por ejemplo:
- patrones de conexión (conexión nueva en una solicitud frente a reutilización de la conexión existente)
- tamaño de una solicitud y respuesta;
- directivas configuradas en cada API o número de clientes que envían solicitudes.
Las operaciones más complejas en las solicitudes son, cuanto mayor sea el consumo de capacidad. Por ejemplo, las directivas de transformación compleja consumen mucha más CPU que el reenvío de una solicitud simple. También aumentan las respuestas de servicio back-end lentas.
Importante
Las métricas de capacidad no son medidas directas del número de solicitudes que se están procesando.
Las métricas de capacidad también pueden aumentar de forma intermitente o ser mayor que cero aunque no se procese ninguna solicitud. Esto sucede debido a acciones específicas del sistema o de la plataforma, y no debe tenerse en cuenta al decidir si se escala una instancia.
Aunque las métricas de capacidad están diseñadas para exponer problemas con la instancia de API Management, hay casos en los que los problemas no se reflejarán en los cambios en estas métricas. Además, las métricas de baja capacidad no significan necesariamente que la instancia de API Management no experimente ningún problema.
Uso de Azure Portal para examinar las métricas de capacidad
Acceda a las métricas en el portal para comprender la cantidad de capacidad que se usa con el tiempo.
- Vaya a la instancia de API Management en Azure Portal.
- En el menú de la izquierda, en Supervisión, seleccione Métricas.
- Seleccione la métrica porcentaje de CPU de puerta de enlace o porcentaje de memoria de puerta de enlace en las métricas disponibles. Elija el valor predeterminado Agregación Promedio o seleccione la agregación Max para ver el uso máximo.
- Elija el período que desee en la barra superior de la sección.
Importante
Actualmente, la métrica Capacidad también aparece en el portal para las instancias de los niveles v2. Sin embargo, no se admite para su uso en los niveles v2 y muestra un valor de 0.
Nota:
Puede establecer una alerta de métrica que le avise cuando ocurra algo inesperado. Por ejemplo, obtenga notificaciones cuando la instancia de API Management haya superado su uso máximo de CPU o memoria esperado durante más de 20 minutos.
Uso de la capacidad para decidir acerca del escalado
Use métricas de capacidad para tomar decisiones sobre si se debe escalar una instancia de API Management para dar cabida a más carga. A continuación se indican consideraciones generales:
- Observe la tendencia y la media a largo plazo.
- Ignore los picos repentinos que probablemente no estén relacionados con un aumento de la carga (consulte la sección Comportamiento de la métrica de capacidad para obtener una explicación).
- Como regla general, actualice o escale la instancia cuando un valor de métrica de capacidad supere 60 % - 70 % durante un largo período de tiempo (por ejemplo, 30 minutos). Para su servicio o escenario es posible que sean más apropiados otros valores.
- Si la instancia está configurada con solo 1 unidad, actualice o escale la instancia cuando un valor de métrica de capacidad supere 40 % durante un largo período. Esta recomendación se basa en la necesidad de reservar capacidad para las actualizaciones del sistema operativo invitado en la plataforma de servicio subyacente.
Sugerencia
Si puede calcular el tráfico de antemano, pruebe su instancia de API Management en las cargas de trabajo que espera. Puede aumentar la carga de solicitudes de su inquilino gradualmente y controlar el valor de la métrica de capacidad que corresponde a su carga máxima. Siga los pasos de la sección anterior para usar Azure Portal para saber la capacidad que se utiliza en un momento dado.