Descripción general de Key Visualizer

En esta página, se proporciona una descripción general de la herramienta de diagnóstico de 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 en los que se desglosa el uso los documentos a los que accedes o las entradas de índice que están escritas o borradas como documentos modificados.

Key Visualizer puede proporcionar estadísticas 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 hotspots de claves de índice o documentos secuenciales, o aumentos repentinos de tráfico.
  • Comprender mejor cómo acceder a los datos almacenados en Firestore
  • Diseñar de manera iterativa un modelo de datos o mejorar el diseño de uno existente. En cada iteración, puedes consultar Key Visualizer para detectar problemas causas de tu modelo de datos.

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

  • Verifica si las operaciones de lectura o escritura crean hotspots en rangos de documentos específicos.
  • Consulta cómo un aumento repentino del tráfico afecta la latencia.
  • Observar si tus patrones de acceso se encuentran balanceados en tu base de datos
  • Verifica la estructura de las claves de índice para identificar las definiciones de índice que causan problemas de carga de índices.
  • Usa la visualización de claves de índice para realizar mejores predicciones de patrones de carga de trabajo.

Elegibilidad para el análisis

Cada análisis de Key Visualizer abarca un período de dos horas. Un análisis de un período determinado está disponible para bases de datos con un tráfico que supera las 3,000 operaciones de documentos en un minuto determinado durante ese período.

La elegibilidad para el análisis depende completamente 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 patrones de acceso o métricas de rendimiento para un grupo de claves de documentos o de índices a lo largo del tiempo.

Ejemplo de un análisis de Key Visualizer

Cómo compartir URLs de análisis

Puedes compartir o agregar a favoritos 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 venza la duración de los datos de análisis.

Mapas de calor

El núcleo de un análisis de Key Visualizer es el mapa de calor, que muestra el valor de una a lo largo del tiempo, desglosadas en hasta 1,000 buckets de claves.

Para un mapa de calor de las teclas de un documento, el eje X del mapa de calor representa el tiempo. el eje Y representa las claves del documento, mientras que, para un mapa de calor de las teclas de índice, la el eje X del mapa de calor 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 para una métrica se considera "frío" y aparece de color oscuro. Un valor alto es “caliente”, y aparezca como un color brillante. Los valores más altos se muestran en blanco.

Los diferentes tipos de uso dan como resultado diferentes patrones visuales dentro del mapa de calor, lo que puede permitir el diagnóstico de los problemas de inmediato. Consulta Patrones de mapa de calor para claves de documentos o Patrones de mapa de calor para claves de índice para ver ejemplos de algunos patrones comunes.

Key Visualizer proporciona herramientas que te ayudan a comprender los datos de cada análisis. Consulta Primeros pasos con Key Visualizer y Explorar mapas de calor.

Depósitos de claves

Key Visualizer divide todas las claves de tu base de datos en a 1,000 rangos contiguos, con casi la misma cantidad de claves y de operaciones en cada rango. Estos rangos se conocen como buckets de claves.

Key Visualizer usa el total de operaciones de una base de datos para dividir buckets de claves para que cada bucket capture más o menos la misma cantidad de Ops/s con un mínimo el tamaño previsto de 50 Ops/s por bucket de claves. En el caso de las bases de datos con un mayor total de operaciones por segundo, los buckets de claves pueden capturar más de 50 operaciones por segundo cada uno. Las bases de datos con menos de 50 operaciones/s generan análisis con un solo bucket de claves.

Key Visualizer informa la mayoría de las métricas como promedios de cada bucket de claves, o como los valores máximos de cada uno.

Métricas

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

Métricas Descripción
Métricas de actividad
Operaciones/s Cantidad promedio de operaciones de documentos por segundo. Es aproximadamente igual a la suma de las operaciones de escritura, búsqueda y consulta por segundo. Esta métrica puede indicar qué claves están activas.
Operaciones de escritura por segundo Cantidad promedio de operaciones de documentos por segundo de escritura y eliminación.
Operaciones de búsqueda Cantidad promedio de operaciones de documentos por segundo para las búsquedas.
Operaciones de consulta Es la cantidad promedio de operaciones de documentos por segundo para las consultas.
Métricas de rendimiento
Latencia de escritura promedio Latencia promedio para las operaciones de escritura y eliminación dentro de los datos procesados en el bucket.
Latencia de búsqueda promedio Latencia promedio para las búsquedas dentro de los datos procesados en el bucket.
Latencia promedio de las consultas Latencia promedio de las consultas dentro de los datos procesados en el bucket.
Latencia final de escritura Es la latencia máxima observada de escritura o eliminación en los datos procesados en el bucket.
Buscar latencia final La latencia de búsqueda máxima observada dentro de los datos procesados en el bucket.
Latencia final de las consultas Latencia máxima de consulta observada dentro de los datos procesados en el bucket.

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 índice por segundo Es la cantidad promedio de operaciones de escritura de índices por segundo.

Promedios de rendimiento

Las métricas de latencia promedio toman un promedio de las claves en el bucket de claves. Dado que esta medición se realiza en la capa de almacenamiento, la latencia informada aquí podría ser menor que la latencia total que experimenta una llamada a la API.

Límites

Aunque Key Visualizer muestra una variedad de métricas, no muestra cada métrica que pueda afectar el rendimiento de Firestore. Por ejemplo:

  • Es posible que los problemas de red entre tu aplicación y Google Cloud no sean visibles. Es posible que aparezcan como bandas verticales en todas las claves en Key Visualizer, lo que solo te brinda una idea sobre cuándo se produjeron los problemas.

Duración de los datos

Los datos recopilados por Key Visualizer para Firestore se borran después de 14 días.

Los datos de Key Visualizer están disponibles durante 14 días. Por ejemplo, si inicias Key Visualizer el 19 de diciembre a las 12:45 p.m., la fecha y la hora de inicio más antiguas que puedes elegir para un período de 2 horas es el 5 de diciembre a la 1:00 p.m.

Este límite también significa que si agregas a favoritos la URL de un análisis de Key Visualizer o la compartes, esta URL tiene una duración máxima de 14 días.

¿Qué sigue?