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 tu Firestore los patrones de uso. Genera informes visuales que desglosan tu uso en función de 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. 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 accedes 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 revisar Key Visualizer para detectar problemas que pueda causar 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.
- Observa cómo un aumento repentino en el tráfico afecta la latencia.
- Observa si tus patrones de acceso están equilibrados 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.
- Usar la visualización de claves de índice para realizar mejores predicciones de patrones de cargas 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 del análisis depende completamente de la actividad de la base de datos. No depende según la cantidad o el 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 de un grupo de claves de documento o claves de índice a lo largo del tiempo.
Cómo compartir las URLs de análisis
Puedes compartir o agregar a favoritos la URL de un análisis de Key Visualizer. Se abrirá la URL. 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 dividida en segmentos de 10 segundos.
Un valor bajo de una métrica se considera “frío”. y aparece en 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 mapas de calor en el caso de las claves de documentos o patrones de mapa de calor para el índice claves 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. Para bases de datos con un total de Ops/s mayor, los buckets clave pueden capturar más de 50 Ops/s 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 por segundo | 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 son populares. |
| Operaciones de escritura | 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 | Cantidad promedio de operaciones de documentos por segundo para las consultas. |
| Métricas de rendimiento | |
| Latencia de escritura promedio | Latencia promedio de las operaciones de escritura y eliminación 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 | Latencia de búsqueda máxima observada dentro de los datos procesados en el bucket. |
| Latencia final de la consulta | 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/s | Cantidad promedio de escrituras de índice 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 todos que puede 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 verticales. bandas en todas las claves de Key Visualizer, que solo te da 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 lanzar Key Visualizer el 19 de diciembre a las 12:45 p.m., la hora de inicio más temprana que puedes elegir un período de 2 horas para 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 del documento o la clave de índice patrones que podrías ver en los mapas de calor de Key Visualizer.
- Descubre cómo analizar un mapa de calor en detalle.