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 que desglosan tu uso según los documentos a los que accedes o las entradas de índice que se escriben o borran a medida que se modifican los documentos.
Key Visualizer puede proporcionar estadísticas sobre los patrones de uso a gran escala. Key Visualizer se puede usar para realizar las siguientes tareas:
- 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 por aumentos repentinos de tráfico.
- Comprender mejor cómo accedes a los datos almacenados en Firestore
- Diseñar de manera iterativa un modelo de datos o mejorar el diseño de un modelo de datos existente. En cada iteración, puedes revisar Key Visualizer para detectar los problemas que causa 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.
- Descubre cómo un aumento repentino en el tráfico afecta la latencia.
- Observa 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 del índice.
- Usa la visualización de claves de índice para realizar mejores predicciones de patrones de carga de trabajo.
Elegibilidad del análisis
Cada análisis de Key Visualizer cubre un período de dos horas. Hay un análisis de un período determinado disponible para las bases de datos con tráfico que supera las 3,000 operaciones de documentos en un minuto determinado de ese período.
La elegibilidad para el análisis depende completamente de la actividad de la base de datos. No depende de la cantidad de datos 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 documento o de índice a lo largo del tiempo.
Uso compartido de 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 métrica a lo largo del tiempo, dividida en hasta 1,000 buckets de claves contiguos.
En el mapa de calor de las teclas de un documento, el eje x del mapa de calor representa el tiempo y el eje y representa las teclas del documento. En el caso de un mapa de calor de las teclas de índice, el eje x del mapa de calor representa el tiempo y el eje y representa las teclas 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 aparece de color oscuro. Un valor alto es "caliente" y aparece como un color brillante. Los valores más altos aparecen 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 si quieres ver ejemplos de algunos patrones comunes.
Key Visualizer proporciona herramientas para ayudarte a comprender los datos en cada análisis. Consulta Comienza a usar Key Visualizer y Explora mapas de calor.
Depósitos de claves
Key Visualizer divide todas las claves de tu base de datos en hasta 1,000 rangos contiguos, con casi la misma cantidad de claves en cada rango. Estos rangos se conocen como buckets 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 | Es la cantidad promedio de operaciones de documentos por segundo. Similar a la suma de escrituras, búsquedas y consultas por segundo. Esta métrica puede indicar qué claves están activas. |
| Operaciones de escritura | Cantidad promedio de operaciones de documentos por segundo para escrituras y eliminaciones. |
| Operaciones de búsqueda | Cantidad promedio de operaciones de documentos por segundo para búsquedas. |
| Operaciones de consulta | Cantidad promedio de operaciones de documentos por segundo para consultas. |
| Métricas de rendimiento | |
| Latencia de escritura promedio | Latencia promedio para las operaciones de escritura y eliminación en los datos procesados en el bucket. |
| Latencia de búsqueda promedio | Latencia promedio de 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. |
| Escribir latencia final | Latencia máxima observada de escritura o eliminación de escritura en los datos procesados en el bucket. |
| Latencia final de búsqueda | Latencia de búsqueda máxima observada dentro de los datos procesados en el bucket. |
| Latencia de la cola de consultas | Latencia máxima observada de las consultas 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 índices | Cantidad promedio de operaciones de escritura de índice por segundo. |
Medias de rendimiento
Las métricas de latencia promedio toman un promedio sobre 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 todas las métricas que pueden afectar el rendimiento de Firestore. Por ejemplo:
- Es posible que los problemas de red entre tu aplicación y Google Cloud no sean visibles. Pueden aparecer como bandas verticales en todas las claves de Key Visualizer, lo que solo te brinda pistas sobre cuándo ocurrieron 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 lanzas Key Visualizer el 19 de diciembre a las 12:45 p.m., la hora de inicio más temprana 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?
- Aprende cómo comenzar a usar Key Visualizer.
- Comprende los patrones de clave de documento o los patrones de clave de índice que podrías ver en los mapas de calor de Key Visualizer.
- Descubre cómo analizar un mapa de calor en detalle.