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.

This talk has been presented at Node Congress 2023, check out the latest edition of this JavaScript Conference.

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 2022React Advanced 2022
25 min
Una Guía del Comportamiento de Renderizado de React
Top Content
This transcription provides a brief guide to React rendering behavior. It explains the process of rendering, comparing new and old elements, and the importance of pure rendering without side effects. It also covers topics such as batching and double rendering, optimizing rendering and using context and Redux in React. Overall, it offers valuable insights for developers looking to understand and optimize React rendering.
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
Mishko, the creator of Angular and AngularJS, discusses the challenges of website performance and JavaScript hydration. He explains the differences between client-side and server-side rendering and introduces Quik as a solution for efficient component hydration. Mishko demonstrates examples of state management and intercommunication using Quik. He highlights the performance benefits of using Quik with React and emphasizes the importance of reducing JavaScript size for better performance. Finally, he mentions the use of QUIC in both MPA and SPA applications for improved startup performance.
Concurrencia en React, Explicada
React Summit 2023React Summit 2023
23 min
Concurrencia en React, Explicada
Top Content
React 18's concurrent rendering, specifically the useTransition hook, optimizes app performance by allowing non-urgent updates to be processed without freezing the UI. However, there are drawbacks such as longer processing time for non-urgent updates and increased CPU usage. The useTransition hook works similarly to throttling or bouncing, making it useful for addressing performance issues caused by multiple small components. Libraries like React Query may require the use of alternative APIs to handle urgent and non-urgent updates effectively.
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
Tom Pressenwurter introduces Redwood.js, a full stack app framework for building GraphQL APIs easily and maintainably. He demonstrates a Redwood.js application with a React-based front end and a Node.js API. Redwood.js offers a simplified folder structure and schema for organizing the application. It provides easy data manipulation and CRUD operations through GraphQL functions. Redwood.js allows for easy implementation of new queries and directives, including authentication and limiting access to data. It is a stable and production-ready framework that integrates well with other front-end technologies.
El Futuro de las Herramientas de Rendimiento
JSNation 2022JSNation 2022
21 min
El Futuro de las Herramientas de Rendimiento
Top Content
Today's Talk discusses the future of performance tooling, focusing on user-centric, actionable, and contextual approaches. The introduction highlights Adi Osmani's expertise in performance tools and his passion for DevTools features. The Talk explores the integration of user flows into DevTools and Lighthouse, enabling performance measurement and optimization. It also showcases the import/export feature for user flows and the collaboration potential with Lighthouse. The Talk further delves into the use of flows with other tools like web page test and Cypress, offering cross-browser testing capabilities. The actionable aspect emphasizes the importance of metrics like Interaction to Next Paint and Total Blocking Time, as well as the improvements in Lighthouse and performance debugging tools. Lastly, the Talk emphasizes the iterative nature of performance improvement and the user-centric, actionable, and contextual future of performance tooling.
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
This Talk discusses handling local state in software development, particularly when dealing with asynchronous behavior and API requests. It explores the challenges of managing global state and the need for actions when handling server data. The Talk also highlights the issue of fetching data not in Vuex and the challenges of keeping data up-to-date in Vuex. It mentions alternative tools like Apollo Client and React Query for handling local state. The Talk concludes with a discussion on GitLab going public and the celebration that followed.

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.
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Node Congress 2024Node Congress 2024
152 min
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Featured Workshop
Emanuel Scirlet
Miguel Henriques
2 authors
Ven y aprende cómo puedes potenciar tus aplicaciones modernas y seguras utilizando GraphQL y Javascript. En este masterclass construiremos una API de GraphQL y demostraremos los beneficios del lenguaje de consulta para APIs y los casos de uso para los que es adecuado. Se requiere conocimiento básico de Javascript.
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
React Advanced 2022React Advanced 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.