Patrones de mapa de calor para claves de índice

En esta página, se muestran ejemplos de patrones que podrías ver en un mapa de calor de Key Visualizer. Estos patrones pueden ayudarte a solucionar problemas de rendimiento específicos.

Uso distribuido de manera uniforme

Si en un mapa de calor se muestra una mezcla detallada de colores oscuros y brillantes, significa que las operaciones de escritura o eliminación para las claves de índice están distribuidas de manera uniforme en la base de datos. Es probable que este mapa de calor represente un patrón de uso efectivo para el modo Datastore.

Índices en claves secuenciales

Un mapa de calor con una sola línea diagonal brillante puede indicar un índice que está en una clave que aumenta o disminuye de forma estricta, como la marca de tiempo. No se recomiendan los índices en claves secuenciales, ya que pueden crear hotspots. Cuando se establece un hotspot, es posible que observes las latencias elevadas correspondientes.

Estos son algunos ejemplos de hotspots comunes en el índice:

Hotspotting debido a una marca de tiempo creciente

En este ejemplo, un mapa de calor con una sola línea diagonal brillante puede indicar una base de datos que usa operaciones de escritura o eliminación de índices estrictamente crecientes o decrecientes en una propiedad de marca de tiempo.

Hotspotting debido a la cantidad creciente de nombres de propiedades

En este ejemplo, un mapa de calor con una sola línea diagonal brillante puede indicar una base de datos que usa operaciones de escritura o eliminación de índices estrictamente crecientes o decrecientes en una propiedad incremental, como números de facturas generados automáticamente.

Para identificar el problema de hotspots, usa la herramienta Key Visualizer y comprende la estructura de claves de índice para determinar qué índice causa el problema y eximir esos índices con las prácticas recomendadas.

Comprende la estructura de clave de índice

Antes de comprender la estructura de las claves de índice que ves en la herramienta Key Visualizer, obtén información sobre los índices en el modo Datastore.

En el siguiente código, se muestra un ejemplo de formato de clave de índice que ves cuando colocas el cursor sobre el rango de claves afectado en el mapa de calor.

NAMESPACE: NS KIND: Users 
PROPERTIES: (Timestamp: DESC, Name: DESC)
ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),`UserList`,1)
VALUES: (16500000000000001,'Alice')
ENTITY:KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`UserList`,1,`User`,5000000000000001)

Aquí:

• NAMESPACE: Es el espacio de nombres de la entidad.
• KIND: Es el tipo de entidad que las clasifica.
• PROPERTIES: Propiedades relacionadas con la entidad. La propiedad de ordenamiento __key__ solo se muestra para las definiciones de índices que modifican el ordenamiento predeterminado.
• ANCESTOR: Es una ruta principal opcional para ubicar la entidad dentro de la jerarquía de la base de datos.
• VALUES: Es el valor de cada propiedad.
• ENTITY: Es el ID de la entidad actualizada en una operación.

En el ejemplo anterior, identifica las propiedades del valor PROPERTIES para encontrar el índice afectado.

Para encontrar el índice, completa los siguientes pasos:

1. Ve a la página Índices del modo de Datastore en la consola de Google Cloud.

   Ve a Índices del modo Datastore

   Para identificar el tipo de índice, analiza el campo PROPERTIES. Consulta los ejemplos de claves de índice para obtener más información.

2. Haz clic en Filtro, selecciona Campos y, luego, ingresa el nombre del campo.

   Usa el operador O para agregar más propiedades en el caso de los índices compuestos.

Después de identificar el índice que causa problemas, puedes usar las siguientes soluciones:

• Índice integrado: Excluye la propiedad para que el índice no mantenga entradas de índice para esa propiedad. Consulta Propiedades excluidas para obtener más información.
• Índice compuesto: Modifica el índice en el archivo index.yaml para asegurarte de que el campo cuyo valor aumenta o disminuye de forma monótonamente no se seleccione como el primer campo para indexar, o bien borra el índice. Consulta Acerca de index.yaml para obtener más información.

Ejemplos de entradas de claves de índice en el mapa de calor

¿Qué sigue?

• Aprende cómo comenzar a usar Key Visualizer.
• Descubre cómo analizar un mapa de calor en detalle.
• Obtén información sobre las métricas que puedes ver en un mapa de calor.