Medición del Costo de una Consulta GraphQL con mercurius-explain

Rate this content
Bookmark

La experiencia de desarrollo con GraphQL ofrece una forma simple e inmediata de acceder a los datos. Trabajar en el backend implica enfocarse en cómo y dónde se obtienen los datos, mientras que el frontend se enfoca en recuperar los datos necesarios para el cálculo y la visualización. Sin embargo, esta libertad de acción oculta algunos posibles problemas de rendimiento. Los fragmentos te permiten construir conjuntos de campos y luego incluirlos en las consultas donde se necesiten. A menudo, un cliente solicita datos innecesarios en una llamada de API con la suposición de que los campos adicionales son gratuitos. En cambio, son la causa de consultas adicionales, a veces incluso costosas. No conocer el costo de una consulta hace imposible realizar la optimización correctamente.

FAQ

Mercurius Explain es un complemento para Mercurius, el adaptador GraphQL para Fastify, que permite registrar el tiempo de resolución de cada resolutor GraphQL. Se utiliza para optimizar y depurar consultas GraphQL al mostrar el tiempo que cada campo tarda en resolver, ayudando a identificar campos costosos en términos de rendimiento.

La principal ventaja de usar GraphQL sobre REST es que no necesitas conocer la ruta específica donde se encuentra cada elemento. Esto simplifica las consultas ya que puedes solicitar múltiples recursos en una sola llamada sin preocuparte por la estructura de los datos subyacentes.

Es crucial conocer el costo de cada campo en una consulta GraphQL para evitar problemas de rendimiento significativos. Esto permite a los desarrolladores optimizar sus consultas identificando y eliminando campos innecesarios o costosos, especialmente en grandes aplicaciones de producción.

Mercurius Explain ayuda tanto en la fase de desarrollo como en producción al proporcionar detalles específicos sobre el tiempo de resolución de cada campo de una consulta GraphQL. Esto permite a los desarrolladores detectar rápidamente campos lentos o problemas de rendimiento y realizar ajustes antes de que la aplicación se despliegue a gran escala.

Además de registrar el tiempo de resolución, Mercurius Explain cuenta con un contador de llamadas al resolutor y soporte para políticas de autorización. También es compatible con federaciones, lo cual es esencial para aplicaciones de producción grandes, asegurando que el complemento sea rápido y seguro.

Un resolutor en GraphQL es una función que genera la respuesta para un campo específico de la consulta. Mercurius Explain monitorea y registra el tiempo que cada resolutor tarda en completar su tarea, mostrando estos tiempos en milisegundos directamente en la respuesta GraphQL, lo que facilita la optimización y depuración de las consultas.

Marco Ippolito
Marco Ippolito
7 min
17 Apr, 2023

Comments

Sign in or register to post your comment.

Video Summary and Transcription

Hoy vamos a hablar sobre la medición del costo de una consulta GraphQL con Mercury's Explain. GraphQL nos permite crear una lista de elementos que queremos sin necesidad de conocer sus ubicaciones. NearForm creó Mercurius Explain, un complemento que agrega un Perfilador a tu instancia de GraphQL. Este complemento proporciona información detallada sobre el tiempo de resolución y el número de llamadas al resolutor para cada campo, lo que facilita la optimización y depuración de consultas. Mercurius Explain es una herramienta valiosa para comprender el costo de tus consultas GraphQL.

1. Medición del Costo de una Consulta GraphQL

Short description:

Hoy vamos a hablar sobre la medición del costo de una consulta GraphQL con Mercury's Explain. GraphQL nos permite crear una lista de elementos que queremos sin necesidad de conocer su ubicación. Sin embargo, esto puede generar problemas a la hora de entender el costo de una consulta. Para solucionar esto, NearForm creó Mercurius Explain, un complemento que agrega un Perfilador a tu instancia de GraphQL. Este complemento proporciona información detallada sobre el tiempo de resolución y el número de llamadas al resolver para cada campo, lo que facilita la optimización y depuración de consultas. Ya sea en producción o desarrollo, Mercurius Explain es una herramienta valiosa para entender el costo de tus consultas GraphQL.

Hoy vamos a hablar sobre la medición del costo de una consulta GraphQL con Mercury's Explain. Primero, permíteme presentarme. Mi nombre es Marco Ippolito, soy un desarrollador de software en NearForm y colaborador de Node.js. Soy de Spoltore, que es una pequeña ciudad en Abruzzo, Italia, pero actualmente vivo en Milán.

Así que empecemos. Me gusta comparar GraphQL con nuestro comprador personal. Simplemente creamos una lista de elementos que queremos. No necesitamos saber dónde se encuentran los elementos. No necesitamos saber en qué supermercado, en qué pasillo. Simplemente tenemos una consulta, que es básicamente una lista, y él los va a buscar por nosotros. A diferencia de REST, hay algunas diferencias. Por ejemplo, con REST tienes que conocer la ruta donde se encuentra el elemento, mientras que con GraphQL simplemente no te importa. Si cambias la disposición de la tienda, no te importa, pero esto oculta algunos problemas.

¿Y qué hay del costo? Bueno, hay algunas implicaciones. Por ejemplo, cuando tenemos una consulta GraphQL, solo podemos ver el costo total. Por ejemplo, cuántos milisegundos tardó en resolverse la consulta, lo cual no es ideal porque si obtenemos docenas de campos, no sabemos qué campo es más costoso que el otro. Esto significa que es muy difícil depurar y optimizar una consulta lenta, especialmente si usas fragmentos. En aplicaciones de producción grandes, tendemos a usar fragmentos con campos centralizados que queremos solicitar, pero esto dificulta detectar campos adicionales que no necesitamos en una consulta específica. Podemos decir que en GraphQL es muy importante conocer el costo de cada campo de una consulta. De lo contrario, tendrás grandes problemas de rendimiento.

Esta es una de las principales razones por las que en NearForm creamos Mercurius Explain. Mercurius es el adaptador GraphQL para Fastify, y Mercurius Explain es un complemento que puede agregarse fácilmente a tu instancia de Mercurius. Las principales características de este complemento son el Perfilador, que básicamente registra el tiempo de resolución de cada resolutor GraphQL en el atributo Explain de tu respuesta GraphQL. Esto es muy útil porque puedes ver el tiempo de resolución en milisegundos. Como puedes ver en este JSON, está el inicio, el fin y el tiempo total que un resolutor específico tardó para un campo específico de tu consulta. También cuenta con las llamadas al resolutor, que es básicamente un contador de cuántas veces se invoca un resolutor. Funciona perfectamente en una puerta de enlace en una Federación, que es básicamente lo que usamos para aplicaciones de producción grandes. Está asegurado por la firma, por lo que puedes usar tus propias políticas de autorización, por ejemplo, verificar si en la solicitud hay un encabezado específico, y también es muy rápido. Creamos este complemento que está destinado a ser utilizado específicamente en producción, pero también durante el desarrollo. Por eso este complemento también cuenta con un complemento GraphQL. Como puedes ver en esta imagen, en el lado izquierdo está el tiempo de resolución de cada campo de nuestra consulta. Mientras estás en la fase de desarrollo, puedes detectar fácilmente un campo lento o si hay algún problema de rendimiento con este complemento, puedes detectarlo de inmediato. También tenemos el diagrama de barras para cada resolutor. Como puedes ver a la izquierda, está en milisegundos. Para cada resolución puedes ver cuándo comenzó, cuándo terminó, es muy específico. Así que te recomiendo que uses este complemento en prácticamente todas las circunstancias, producción, desarrollo, pequeño, grande, porque es muy útil y es muy importante en GraphQL conocer el costo de una consulta. Así que gracias por escuchar, aquí dejo mis cuentas en redes sociales, y también quiero agradecer a Davide Fiorello, quien es el cerebro detrás de este complemento. Y eso es todo, muchas gracias.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

Una Guía del Comportamiento de Renderizado de React
React Advanced Conference 2022React Advanced Conference 2022
25 min
Una Guía del Comportamiento de Renderizado de React
Top Content
React es una biblioteca para "renderizar" UI a partir de componentes, pero muchos usuarios se encuentran confundidos acerca de cómo funciona realmente el renderizado de React. ¿Qué significan términos como "renderizado", "reconciliación", "Fibers", y "committing"? ¿Cuándo ocurren los renderizados? ¿Cómo afecta el Contexto al renderizado, y cómo las bibliotecas como Redux causan actualizaciones? En esta charla, aclararemos la confusión y proporcionaremos una base sólida para entender cuándo, por qué, y cómo React renderiza. Veremos: - Qué es realmente el "renderizado" - Cómo React encola los renderizados y el comportamiento de renderizado estándar - Cómo se utilizan las claves y los tipos de componentes en el renderizado - Técnicas para optimizar el rendimiento del renderizado - Cómo el uso del contexto afecta al comportamiento del renderizado - Cómo las bibliotecas externas se integran en el renderizado de React
Acelerando tu aplicación React con menos JavaScript
React Summit 2023React Summit 2023
32 min
Acelerando tu aplicación React con menos JavaScript
Top Content
¿Demasiado JavaScript te está agobiando? Los nuevos marcos que prometen no usar JavaScript parecen interesantes, pero tienes una aplicación React existente que mantener. ¿Qué tal si Qwik React es tu respuesta para un inicio de aplicaciones más rápido y una mejor experiencia de usuario? Qwik React te permite convertir fácilmente tu aplicación React en una colección de islas, que pueden ser renderizadas en el servidor y rehidratadas con retraso, e incluso en algunos casos, se puede omitir la rehidratación por completo. Y todo esto de manera incremental sin una reescritura.
Concurrencia en React, Explicada
React Summit 2023React Summit 2023
23 min
Concurrencia en React, Explicada
Top Content
¡React 18! ¡Funciones concurrentes! Tal vez ya hayas probado las nuevas APIs como useTransition, o tal vez solo hayas oído hablar de ellas. Pero, ¿sabes cómo React 18 logra las mejoras de rendimiento que trae consigo? En esta charla, echemos un vistazo bajo el capó de las características de rendimiento de React 18: - Cómo React 18 reduce el tiempo que tu página permanece congelada (también conocido como TBT) - Qué sucede exactamente en el hilo principal cuando ejecutas useTransition() - Cuál es la trampa con las mejoras (¡no hay torta gratis!), y por qué Vue.js y Preact se negaron rotundamente a lanzar algo similar
De GraphQL Zero a GraphQL Hero con RedwoodJS
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
De GraphQL Zero a GraphQL Hero con RedwoodJS
Top Content
Todos amamos GraphQL, pero puede ser desalentador poner en marcha un servidor y mantener tu código organizado, mantenible y testeable a largo plazo. ¡No más! Ven a ver cómo paso de un directorio vacío a una API GraphQL completamente desarrollada en cuestión de minutos. Además, verás lo fácil que es usar y crear directivas para limpiar aún más tu código. ¡Vas a amar aún más GraphQL una vez que hagas las cosas Redwood Easy!
El Futuro de las Herramientas de Rendimiento
JSNation 2022JSNation 2022
21 min
El Futuro de las Herramientas de Rendimiento
Top Content
Nuestra comprensión del rendimiento y la experiencia del usuario ha evolucionado mucho a lo largo de los años. Las herramientas de desarrollo web necesitan evolucionar de manera similar para asegurarse de que sean centradas en el usuario, accionables y contextuales donde se refiere a las experiencias modernas. En esta charla, Addy te guiará a través de cómo Chrome y otros han estado pensando en este problema y qué actualizaciones han estado haciendo a las herramientas de rendimiento para reducir la fricción para construir grandes experiencias en la web.
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Vue.js London Live 2021Vue.js London Live 2021
24 min
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Top Content
¿Cuántas veces has implementado el mismo flujo en tu aplicación: verificar si los datos ya se han obtenido del servidor, si es así - renderizar los datos, si no - obtener estos datos y luego renderizarlos? Creo que lo he hecho más de diez veces yo mismo y he visto la pregunta sobre este flujo más de cincuenta veces. Desafortunadamente, nuestra biblioteca de gestión de estado predeterminada, Vuex, no proporciona ninguna solución para esto.Para la aplicación basada en GraphQL, había una alternativa para usar el cliente Apollo que proporcionaba herramientas para trabajar con la caché. Pero, ¿qué pasa si usas REST? Afortunadamente, ahora tenemos una alternativa de Vue a una biblioteca de react-query que proporciona una buena solución para trabajar con la caché del servidor. En esta charla, explicaré la distinción entre el estado de la aplicación local y la caché del servidor local y haré algo de codificación en vivo para mostrar cómo trabajar con este último.

Workshops on related topic

Masterclass de Depuración de Rendimiento de React
React Summit 2023React Summit 2023
170 min
Masterclass de Depuración de Rendimiento de React
Top Content
Featured WorkshopFree
Ivan Akulov
Ivan Akulov
Los primeros intentos de Ivan en la depuración de rendimiento fueron caóticos. Vería una interacción lenta, intentaría una optimización aleatoria, vería que no ayudaba, y seguiría intentando otras optimizaciones hasta que encontraba la correcta (o se rendía).
En aquel entonces, Ivan no sabía cómo usar bien las herramientas de rendimiento. Haría una grabación en Chrome DevTools o React Profiler, la examinaría, intentaría hacer clic en cosas aleatorias, y luego la cerraría frustrado unos minutos después. Ahora, Ivan sabe exactamente dónde y qué buscar. Y en esta masterclass, Ivan te enseñará eso también.
Así es como va a funcionar. Tomaremos una aplicación lenta → la depuraremos (usando herramientas como Chrome DevTools, React Profiler, y why-did-you-render) → identificaremos el cuello de botella → y luego repetiremos, varias veces más. No hablaremos de las soluciones (en el 90% de los casos, es simplemente el viejo y regular useMemo() o memo()). Pero hablaremos de todo lo que viene antes - y aprenderemos a analizar cualquier problema de rendimiento de React, paso a paso.
(Nota: Esta masterclass es más adecuada para ingenieros que ya están familiarizados con cómo funcionan useMemo() y memo() - pero quieren mejorar en el uso de las herramientas de rendimiento alrededor de React. Además, estaremos cubriendo el rendimiento de la interacción, no la velocidad de carga, por lo que no escucharás una palabra sobre Lighthouse 🤐)
Construir con SvelteKit y GraphQL
GraphQL Galaxy 2021GraphQL Galaxy 2021
140 min
Construir con SvelteKit y GraphQL
Top Content
Featured WorkshopFree
Scott Spence
Scott Spence
¿Alguna vez has pensado en construir algo que no requiera mucho código de plantilla con un tamaño de paquete pequeño? En esta masterclass, Scott Spence irá desde el hola mundo hasta cubrir el enrutamiento y el uso de endpoints en SvelteKit. Configurarás una API de GraphQL en el backend y luego usarás consultas de GraphQL con SvelteKit para mostrar los datos de la API de GraphQL. Construirás un proyecto rápido y seguro que utiliza las características de SvelteKit, y luego lo desplegarás como un sitio completamente estático. Este curso es para los curiosos de Svelte que no han tenido una experiencia extensa con SvelteKit y quieren una comprensión más profunda de cómo usarlo en aplicaciones prácticas.

Tabla de contenidos:
- Inicio e introducción a Svelte
- Inicializar el proyecto frontend
- Recorrido por el proyecto esqueleto de SvelteKit
- Configurar el proyecto backend
- Consultar datos con GraphQL
- Recuperación de datos en el frontend con GraphQL
- Estilización
- Directivas de Svelte
- Enrutamiento en SvelteKit
- Endpoints en SvelteKit
- Despliegue en Netlify
- Navegación
- Mutaciones en GraphCMS
- Envío de mutaciones GraphQL a través de SvelteKit
- Preguntas y respuestas
Construyendo aplicaciones web que iluminan Internet con QwikCity
JSNation 2023JSNation 2023
170 min
Construyendo aplicaciones web que iluminan Internet con QwikCity
Featured WorkshopFree
Miško Hevery
Miško Hevery
Construir aplicaciones web instantáneas a gran escala ha sido elusivo. Los sitios del mundo real necesitan seguimiento, análisis y interfaces y interacciones de usuario complejas. Siempre comenzamos con las mejores intenciones pero terminamos con un sitio menos que ideal.
QwikCity es un nuevo meta-framework que te permite construir aplicaciones a gran escala con un rendimiento de inicio constante. Veremos cómo construir una aplicación QwikCity y qué la hace única. El masterclass te mostrará cómo configurar un proyecto QwikCity. Cómo funciona el enrutamiento con el diseño. La aplicación de demostración obtendrá datos y los presentará al usuario en un formulario editable. Y finalmente, cómo se puede utilizar la autenticación. Todas las partes básicas para cualquier aplicación a gran escala.
En el camino, también veremos qué hace que Qwik sea único y cómo la capacidad de reanudación permite un rendimiento de inicio constante sin importar la complejidad de la aplicación.
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
React Advanced Conference 2022React Advanced Conference 2022
95 min
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
Featured WorkshopFree
Sabin Adams
Sabin Adams
En este masterclass, obtendrás una visión de primera mano de lo que es la seguridad de tipo de extremo a extremo y por qué es importante. Para lograr esto, construirás una API de GraphQL utilizando herramientas modernas y relevantes que serán consumidas por un cliente de React.
Prerrequisitos: - Node.js instalado en tu máquina (12.2.X / 14.X)- Se recomienda (pero no es obligatorio) utilizar VS Code para las tareas prácticas- Un IDE instalado (se recomienda VSCode)- (Bueno tener) *Un conocimiento básico de Node.js, React y TypeScript
GraphQL para Desarrolladores de React
GraphQL Galaxy 2022GraphQL Galaxy 2022
112 min
GraphQL para Desarrolladores de React
Featured Workshop
Roy Derks
Roy Derks
Hay muchas ventajas en utilizar GraphQL como fuente de datos para el desarrollo frontend, en comparación con las API REST. Nosotros, los desarrolladores, por ejemplo, necesitamos escribir mucho código imperativo para recuperar datos y mostrarlos en nuestras aplicaciones y manejar el estado. Con GraphQL, no solo puedes reducir la cantidad de código necesario para la obtención de datos y la gestión del estado, sino que también obtendrás una mayor flexibilidad, mejor rendimiento y, sobre todo, una mejor experiencia de desarrollo. En este masterclass aprenderás cómo GraphQL puede mejorar tu trabajo como desarrollador frontend y cómo manejar GraphQL en tu aplicación frontend de React.
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
React Summit 2022React Summit 2022
173 min
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
Top Content
WorkshopFree
Kellen Mace
Kellen Mace
En esta masterclass, aprenderás cómo construir una aplicación Next.js que utiliza Apollo Client para obtener datos de un backend de WordPress sin cabeza y usarlo para renderizar las páginas de tu aplicación. Aprenderás cuándo debes considerar una arquitectura de WordPress sin cabeza, cómo convertir un backend de WordPress en un servidor GraphQL, cómo componer consultas usando el IDE GraphiQL, cómo colocar fragmentos GraphQL con tus componentes, y más.