En esta página, se describe cómo usar Key Visualizer para verificar los problemas de rendimiento relacionados con los patrones de uso de Firestore en modo Datastore.
Antes de comenzar
Si quieres usar Key Visualizer para el modo Datastore, debes habilitar la Firestore Key Visualizer API.
Funciones obligatorias
Asegúrate de que a tu cuenta se le otorgue una de las siguientes funciones de IAM:
- Propietario de Cloud Datastore
- Visualizador de Key Visualizer de Cloud Datastore
- Editor
- Propietario
Estas funciones incluyen los siguientes permisos de IAM, que son necesarios para acceder a Key Visualizer:
datastore.keyVisualizerScans.getdatastore.keyVisualizerScans.listdatastore.databases.getMetadataresourcemanager.projects.get
También puedes definir una función personalizada con los permisos necesarios.
Visualiza un análisis de un período
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.
Para iniciar Key Visualizer, haz lo siguiente:
En la consola de Google Cloud, ve a la página Bases de datos.
Selecciona la base de datos requerida de la lista.
En el menú de navegación, haz clic en Key Visualizer.
Selecciona un período y una métrica de los análisis disponibles de Key Visualizer:
Haz clic en el ícono de lápiz que se encuentra en la esquina superior derecha. Selecciona una Fecha y un Período.
Los análisis están disponibles según la elegibilidad de análisis. No puedes seleccionar intervalos de tiempo que no cumplieron con los requisitos de elegibilidad del análisis o que aún se estén procesando. Los dos análisis más recientes del día tardarán un tiempo en procesarse antes de estar disponibles.
Selecciona Todos los datos de la entidad o Todos los datos de índice como la fuente.
Haga clic en Update.
Selecciona una métrica para analizar:
Haz clic en el menú desplegable de métricas en la esquina superior izquierda y selecciona una para verla. Key Visualizer se abre en la métrica Ops/s para las claves de entidad y en la métrica Index Write Ops/s para las claves de índice de forma predeterminada.
Para comparar métricas o buscar correlaciones de datos, puedes mostrar varias métricas de Key Visualizer juntas. Consulta Cómo buscar conexiones entre diferentes métricas.
Cómo ver la descripción general de una actividad
Para obtener una descripción general de la actividad durante el período de dos horas seleccionado, revisa el mapa de calor de la métrica predeterminada.
En el siguiente ejemplo, se muestra un mapa de calor que contiene las diferencias principales del patrón de uso de los distintos rangos de claves:
- Los rangos que se muestran en colores oscuros tienen muy poca actividad o nada.
- Los rangos que se muestran en colores brillantes tienen más actividad.
- El rango de color blanco brillante del medio tiene un nivel de actividad muy alto.
Análisis de claves de entidad
La métrica Operaciones/s mide la cantidad de solicitudes por segundo para cada rango de claves. Esta métrica es una suma de las solicitudes de escritura, búsqueda y consulta. Key Visualizer muestra esta métrica de forma predeterminada cuando abres un mapa de calor.
Después de tener una idea de la actividad general de tu base de datos, puedes continuar con la investigación si observas otras métricas y te enfocas en los rangos de claves que podrían causar problemas. Más información
Análisis de claves de índice
La métrica Operaciones de escritura de índices en una celda determinada mide las escrituras de índices promedio por segundo dentro del intervalo de tiempo de 10 segundos y el rango de claves correspondientes.
¿Qué sigue?
- Aprende a reconocer patrones comunes en mapas de calor para claves de entidad.
- Aprende a reconocer patrones comunes en mapas de calor para claves de índice.
- Descubre cómo explorar un mapa de calor en profundidad.