Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
Edge API Analytics es una función integrada muy potente que proporciona Apigee Edge. Recopila y analiza un amplio espectro de datos que fluyen a través de las APIs. Los datos de estadísticas capturados pueden proporcionar estadísticas muy útiles. Por ejemplo, ¿cuál es la tendencia del volumen de tráfico de la API durante un período? ¿Cuál es la API más usada? ¿Qué APIs tienen tasas de error altas?
El análisis regular de estos datos y estadísticas se puede usar para tomar las medidas adecuadas, como la planificación de la capacidad futura de las APIs en función del uso actual, las decisiones comerciales y de inversión futuras, y mucho más.
Datos de estadísticas y su almacenamiento
API Analytics captura muchos tipos diferentes de datos, como los siguientes:
- Información sobre una API: URI de solicitud, dirección IP del cliente, códigos de estado de respuesta, etcétera
- Rendimiento del proxy de API: Tasa de éxito o falla, tiempo de procesamiento de solicitud y respuesta, etcétera
- Rendimiento del servidor de destino: Tasa de éxito o falla, tiempo de procesamiento
- Información de errores: Cantidad de errores, código de falla, política fallida, cantidad de errores causados por Apigee y el servidor de destino
- Otra información: Cantidad de solicitudes realizadas por desarrolladores, apps para desarrolladores, etcétera
Todos estos datos se almacenan en un analytics esquema creado y administrado dentro de una
base de datos de Postgres por Apigee Edge.
Por lo general, en una instalación de Edge sin modificaciones, Postgres tendrá los siguientes esquemas:
Edge usa el esquema llamado analytics para almacenar todos los datos de estadísticas de
cada organización y entorno. Si se instala la monetización, habrá un rkms
esquema. Los otros esquemas están destinados a los elementos internos de Postgres.
El esquema analytics seguirá cambiando, ya que Apigee Edge agregará dinámicamente nuevas tablas de hechos
en tiempo de ejecución. El componente del servidor de Postgres agregará los datos de hechos en tablas agregadas
que se cargarán y mostrarán en la IU de Edge.
Antipatrón
No se recomienda agregar columnas, tablas o vistas personalizadas a ninguno de los esquemas propiedad de Apigee en la base de datos de Postgres en entornos de nube privada directamente con consultas SQL, ya que puede tener implicaciones adversas.
Veamos un ejemplo para explicar esto en detalle.
Considera que se creó una tabla personalizada llamada account en el esquema de estadísticas, como
se muestra a continuación:
Después de un tiempo, supongamos que es necesario actualizar Apigee Edge de una versión inferior a una superior versión. La actualización de Apigee Edge de la nube privada implica actualizar Postgres, entre muchos otros componentes. Si se agregan columnas, tablas o vistas personalizadas a la base de datos de Postgres, la actualización de Postgres falla con errores que hacen referencia a los objetos personalizados, ya que no los crea Apigee Edge. Por lo tanto, la actualización de Apigee Edge también falla y no se puede completar.
Del mismo modo, pueden producirse errores durante las actividades de mantenimiento de Apigee Edge en las que se realizan copias de seguridad y restablecimiento de los componentes de Edge, incluida la base de datos de Postgres.
Impacto
- No se puede completar la actualización de Apigee Edge porque falla la actualización del componente de Postgres con errores que hacen referencia a objetos personalizados que no creó Apigee Edge.
- Inconsistencias (y fallas) durante la realización del mantenimiento del servicio de Apigee Analytics (copia de seguridad o restablecimiento)
Práctica recomendada
- No agregues información personalizada en forma de columnas, tablas, vistas, funciones y
procedimientos directamente a ninguno de los esquemas propiedad de Apigee, como
analytics, etcétera. - Si es necesario admitir información personalizada, se puede agregar como columnas (campos) con
una política de Statistics Collector al esquema
analytics.