Información general sobre Key Visualizer

En esta página se ofrece una descripción general de la herramienta de diagnóstico Key Visualizer para Firestore.

¿Qué es Key Visualizer?

Key Visualizer es una herramienta que te ayuda a analizar tus patrones de uso de Firestore. Genera informes visuales que desglosan tu uso en función de los documentos a los que accedes o de las entradas de índice que se escriben o eliminan a medida que se modifican los documentos.

Key Visualizer puede proporcionar información valiosa sobre los patrones de uso a gran escala. Entre los usos de Key Visualizer se incluyen los siguientes:

  • Solucionar problemas de rendimiento. Key Visualizer te ayuda a identificar problemas de rendimiento en tu base de datos causados por puntos de acceso de claves de índice o de documento secuenciales, o por aumentos repentinos del tráfico.
  • Entender mejor cómo accedes a los datos almacenados en Firestore.
  • Diseñar de forma iterativa un modelo de datos o mejorar el diseño de un modelo de datos ya creado. En cada iteración, puede consultar Key Visualizer para detectar los problemas que provoca su modelo de datos.

Para conseguir estos objetivos, Key Visualizer puede ayudarte a completar las siguientes tareas:

  • Comprueba si tus lecturas o escrituras crean puntos de acceso en intervalos de documentos específicos.
  • Consulta cómo afecta a la latencia un aumento repentino del tráfico.
  • Comprueba si tus patrones de acceso están equilibrados en toda la base de datos.
  • Comprueba la estructura de las claves de índice para identificar las definiciones de índice que provocan problemas de carga de índices.
  • Usa la visualización de claves de índice para hacer mejores predicciones de patrones de carga de trabajo.

Analizar si cumple los requisitos

Cada análisis de Key Visualizer abarca un periodo de dos horas. El análisis de un periodo determinado está disponible para las bases de datos con un tráfico que supere las 3000 operaciones de documentos en cualquier minuto de ese periodo.

La idoneidad de los análisis depende por completo de la actividad de la base de datos. No depende de la cantidad ni del tipo de datos de tu base de datos.

Análisis de Key Visualizer

En la siguiente imagen se muestra un análisis de Key Visualizer. Cada análisis incluye un mapa de calor que muestra los patrones de acceso o las métricas de rendimiento de un grupo de claves de documento o de índice a lo largo del tiempo.

Ejemplo de un análisis de Key Visualizer

Compartir URLs de análisis

Puedes compartir o añadir a marcadores la URL de un análisis de Key Visualizer. La URL abrirá el mismo análisis de Key Visualizer y seleccionará la misma métrica. Esta URL es válida hasta que caduque la duración de los datos de análisis.

Mapas de calor

El elemento principal de un análisis de Visualizador de claves es el mapa de calor, que muestra el valor de una métrica a lo largo del tiempo, desglosado en hasta 1000 contenedores de claves contiguos.

En un mapa de calor de claves de documento, el eje X representa el tiempo y el eje Y representa las claves de documento. En un mapa de calor de claves de índice, el eje X representa el tiempo y el eje Y representa las claves de índice.

Cada análisis de Key Visualizer para Firestore abarca dos horas de actividad divididas en segmentos de 10 segundos.

Un valor bajo de una métrica se considera "frío" y se muestra con un color oscuro. Un valor alto es "caliente" y se muestra como un color brillante. Los valores más altos aparecen en blanco.

Los diferentes tipos de uso dan lugar a distintos patrones visuales en el mapa de calor, lo que permite diagnosticar problemas de un vistazo. Consulta Patrones de mapa de calor de claves de documento o Patrones de mapa de calor de claves de índice para ver ejemplos de algunos patrones habituales.

Key Visualizer ofrece herramientas que te ayudan a entender los datos de cada análisis. Consulta los artículos Empezar a usar Key Visualizer y Explorar mapas de calor.

Segmentos de claves

Key Visualizer divide todas las claves de tu base de datos en hasta 1000 intervalos contiguos, con aproximadamente el mismo número de claves y operaciones por segundo en cada intervalo. Estos intervalos se denominan contenedores de claves.

Key Visualizer usa el total de operaciones por segundo de una base de datos para dividir los contenedores de claves, de forma que cada contenedor registre aproximadamente el mismo número de operaciones por segundo, con un tamaño mínimo previsto de 50 operaciones por segundo por contenedor de claves. En las bases de datos con un total de operaciones por segundo más alto, los contenedores de claves pueden registrar más de 50 operaciones por segundo cada uno. Las bases de datos con menos de 50 operaciones por segundo dan como resultado análisis con un solo contenedor de claves.

Key Visualizer muestra la mayoría de las métricas como promedios de cada segmento de claves o como valores máximos de cada segmento de claves.

Métricas

Las siguientes métricas están disponibles para las claves de documento en los análisis de Key Visualizer:

Métricas Descripción
Métricas de actividad
Operaciones/s Número medio de operaciones de documentos por segundo. Equivale aproximadamente a la suma de las escrituras, las búsquedas y las consultas por segundo. Esta métrica puede indicar qué claves están activas.
Operaciones de escritura/s Número medio de operaciones de documentos por segundo en las escrituras y eliminaciones.
Operaciones de búsqueda/s Número medio de operaciones de documentos por segundo para las búsquedas.
Operaciones de consulta por segundo Número medio de operaciones de documentos por segundo en las consultas.
Métricas de rendimiento
Latencia media de escritura Latencia media de las operaciones de escritura y eliminación de los datos procesados del segmento.
Latencia media de búsqueda Latencia media de las búsquedas en los datos procesados del segmento.
Latencia media de las consultas Latencia media de las consultas de los datos procesados del segmento.
Escribir latencia final Latencia máxima de escritura o eliminación observada en los datos procesados del segmento.
Latencia final de búsqueda Latencia máxima de búsqueda observada en los datos procesados del segmento.
Latencia final de las consultas Latencia máxima de las consultas observada en los datos procesados del segmento.

La siguiente métrica está disponible para las claves de índice en los análisis de Key Visualizer:

Métricas Descripción
Operaciones de escritura de índices por segundo Número medio de escrituras de índice por segundo.

Medias de rendimiento

Las métricas de latencia media se calculan a partir del promedio de las claves del segmento de claves. Como esta medición se realiza en la capa de almacenamiento, la latencia que se indica aquí puede ser inferior a la latencia total que experimenta una llamada a la API.

Límites

Aunque Key Visualizer muestra varias métricas, no muestra todas las métricas que pueden afectar al rendimiento de Firestore. Por ejemplo:

  • Es posible que no se vean los problemas de red entre tu aplicación y Google Cloud . Pueden aparecer como bandas verticales en todas las teclas de Key Visualizer, lo que solo te da pistas sobre cuándo se produjeron los problemas.

Duración de los datos

Los datos recogidos por Key Visualizer para Firestore se eliminan al cabo de 14 días.

Los datos de Key Visualizer están disponibles durante los últimos 14 días. Por ejemplo, si inicias Key Visualizer el 19 de diciembre a las 12:45, la hora de inicio más temprana que puedes elegir para un periodo de 2 horas es el 5 de diciembre a las 13:00.

Este límite también significa que, si añades a favoritos o compartes la URL de un análisis de Key Visualizer, la URL tendrá una validez máxima de 14 días.

Siguientes pasos