Versión beta X-Ray en ambiente de pruebas

[milo19980525]

Se requiere realizar una prueba de 5 APIs nuevas que utilicen X-Ray en ambiente de pruebas.

Especificaciones técnicas

• El último desarrollo de X-Ray, se encuentra en rama feature/x-ray.
• El desarrollo final de X-Ray se encuentra documentado en: #81.
• La documentación de X-Ray se encuentra en el issue #82.

Sub Tareas

• [x] Escoger las APIs mid o crud estan relacionadas con las APIs de cumplidos_dve mid y crud o se encuentran asociadas entre ellas para instrumentarlas con X-Ray.
• [x] Instrumentar las APIs escogidas con X-Ray.
• [x] Probar X-Ray en estas nuevas APIs en local.
• [x] Subir los cambios de las APIs a la rama release.
• [x] Realizar pruebas de funcionamiento en ambiente de pruebas.

Criterios de aceptación

• [x] Se escogen 5 nuevas APIs.
• [x] Se instrumentan con X-Ray las 5 nuevas APIs.
• [x] Se prueba el fucnionamiento de X-Ray en las APIs escogidas.

Requerimientos

• [x] Funcionalidad de X-ray funcional con el API de cumplidos_dve_mid y cumplidos_crud.

Dependencias

• No presenta.

Definition of Ready - DoR

• [x] Está refinada y estimada en puntos de historia por el equipo.
• [x] Incluye la descripción y criterios de aceptación, con el detalle funcional y especificaciones técnicas, de forma entendible por cualquier miembro del equipo.
• [x] No tiene bloqueos que impidan su ejecución.
• [x] Las dependencias entán identificadas y resueltas.
• [x] Puede ser probada dentro del Sprint.

Definition of Done - DoD - Desarrollo

• [x] Desarrollo en local.
• [x] Push en Feature.
• [x] Pruebas locales (funcionales).
• [x] PR a Develop.
• [x] PR a Release.
• [x] Criterios de aceptación cumplidos.
• [x] Documentación de issue realizada.
• [x] Aprobada por SM/Líder técnico.

[a52290451]

Listado de APIs a ser instrumentadas

• [x] core_amazon_crud (CRUD)
• [x] parametros_crud (CRUD)
• [ ] administrativa_amazon_api (CRUD)
• [ ] administrativa_crud_api (CRUD)
• [x] resoluciones_crud_v2 (CRUD)
• [x] oikos_api (CRUD)
• [x] resoluciones_mid_v2 (MID)
• [x] titan_api_mid

[a52290451]

Se realiza la instrumentación del API resoluciones_docentes_mid_v2:

Al realizar pruebas en local a diferentes servicios, se evidencia que el API responde correctamente y se envían las trazas al demonio sin inconvenientes:

Nota: en la realización del ejercicio, se evidencian una sobre carga de peticiones al API resoluciones_docentes_crud_v2 que emite en el puerto :8528.

A diferencia de las demás APIs, recibe por petición un promedio de 70 solicitudes lo cual es preocupante. Se recomienda revisar a detalle los servicios implementados en resoluciones_docentes_mid_v2 para encontrar una forma de optimizar las peticiones realizadas al CRUD.

---

Se realiza el despliegue de resoluciones_docentes_mid_v2 en ambiente de pruebas y se comprueba su funcionamiento con AWS X-Ray:

[a52290451]

Se realiza la instrumentación del API resoluciones_docentes_crud_v2:

https://github.com/udistrital/resoluciones_crud_v2/pull/32

Al realizar peticiones directamente al API, se puede evidenciar como se envían las trazas correctamente a la consola de AWS X-Ray:

En combinación con resoluciones_docentes_mid_v2, también se comprueba su funcionamiento:

[a52290451]

Se realiza la instrumentación del API oikos_api:

https://github.com/udistrital/oikos_api/pull/59

Al realizar peticiones directamente al API, se puede evidenciar como se envían las trazas correctamente a la consola de AWS X-Ray:

En combinación con cumplidos_dve_mid, también se comprueba su funcionamiento:

[a52290451]

Se realiza la instrumentación del API parametros_crud:

https://github.com/udistrital/parametros_crud/pull/30

Al realizar peticiones directamente al API, se puede evidenciar como se envían las trazas correctamente a la consola de AWS X-Ray:

En combinación con cumplidos_dve_mid, también se comprueba su funcionamiento:

[a52290451]

Se realiza la instrumentación del API core_amazon_crud:

https://github.com/udistrital/core_amazon_crud/pull/18

El API se despliega correctamente, sin embargo, parece que la imagen no se actualiza en aws ya que no reconoce los últimos cambios:

https://hubci.portaloas.udistrital.edu.co/udistrital/core_amazon_crud/26/1/9

[a52290451]

Se realiza la instrumentación del API titan_api_mid:

Al realizar pruebas en local a diferentes servicios, se evidencia que el API responde correctamente y se envían las trazas al demonio sin inconvenientes:

Nota: en la realización del ejercicio, se evidencian una sobre carga de peticiones al API titan_api_crud que emite en el puerto :8081.

A diferencia de las demás APIs, recibe por petición un promedio de 100 solicitudes lo cual es preocupante. Se recomienda revisar a detalle los servicios implementados en titan_api_mid para encontrar una forma de optimizar las peticiones realizadas al CRUD.

---

Se realiza el despliegue de titan_api_mid en ambiente de pruebas y se comprueba su funcionamiento con AWS X-Ray:

[a52290451]

Se realiza actualización del paquete request en el repositorio utils_oas, instrumentando los metodos con el SDK de AWS X-Ray:

https://github.com/udistrital/utils_oas/commit/16b051aefeaff3a138e8b7db8af011cfd9a91708

De esta forma, las APIs que utilizan request de utils_oas para realizar sus peticiones, quedaran instrumentadas parcialmente.

[milo19980525]

@a52290451 subir al issue imágenes del gráfico de conexiones finales con las APIs instrumentadas.

[a52290451]

Prueba de funcionamiento global.

Posterior a la instrumentación de las APIs mencionadas anteriormente, se procede a realizar una prueba de funcionamiento global, en la cual se realizan peticiones de forma individual a cada API con un cliente ficticio (Postman) y también, se realizan solicitudes empleando un cliente real, en este caso Cumplidos_dve_cliente:

En la prueba se produce un error en el API core_amazon_crud ya que no respondió a una de las peticiones realizadas. Por lo cual se marca en Rojo el nodo.

En general, se evidencia el correcto funcionamiento de la instrumentación de XRAY en las APIs.