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, se realizan operaciones de escritura y eliminación de y las claves de índice se distribuyen de manera uniforme en toda la base de datos. Este mapa de calor probablemente representa un patrón de uso efectivo para el modo Datastore.
Índices sobre teclas 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. Índices activados no se recomiendan, ya que pueden crear hotspots. Cuando uses hotspots, es posible que observes latencias elevadas correspondientes.
Los siguientes son algunos ejemplos de hotspots comunes en el índice:
Generación de hotspots debido a una marca de tiempo en aumento
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 y eliminación de índices que aumentan o disminuyen de forma estricta en una marca de tiempo propiedad.
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 generación de hotspots, usa la herramienta Key Visualizer y comprende la clave de índice estructura para determinar qué índice causa el problema y eximir esos índices con las prácticas recomendadas.
Comprende la estructura de la clave del índice
Antes de comprender la estructura de las claves de índice que ves en Key Visualizer obtén información sobre los índices en modo Datastore.
El siguiente código muestra un ejemplo de formato de clave de índice que ves cuando colocas el cursor sobre sobre el rango de teclas 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 índice que modifican el orden 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.
Del ejemplo anterior, identifica las propiedades de PROPERTIES. de salida para encontrar el índice afectado.
Para encontrar el índice, completa los siguientes pasos:
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.
Haz clic en Filtro, selecciona Campos y, luego, ingresa el nombre del campo.
Usa el operador OR para agregar más propiedades en caso de índices compuestos.
Una vez que hayas identificado el índice que causa problemas, puedes usar las siguientes soluciones:
- Índice integrado: Excluye la propiedad de modo que el índice no la mantenga. entradas de índice de 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 clave de índice en el mapa de calor
Tipo | Descripción | Ejemplo |
---|---|---|
Entrada de índice integrada | Entrada del índice para el índice de propiedad único en la propiedad Timestamp , en orden descendente para el espacio de nombres NS . |
NAMESPACE: NS KIND: Users PROPERTIES: (Timestamp: DESC) ANCESTOR: NONE VALUES: (16500000000000001) ENTITY: KEY(PROJECT('PROJECT_ID'), NAMESPACE('NS'), Usuarios, 5000000000000001) |
Entrada de índice integrado | Entrada del índice para el índice de propiedad única en el espacio de nombres predeterminado. | NAMESPACE: ' ' KIND: Users PROPERTIES: (Timestamp: DESC) ANCESTOR: NONE VALUES: (16500000000000001) ENTITY: KEY(PROJECT('PROJECT_ID'), NAMESPACE('NS'), Usuarios, 5000000000000001) |
Entrada de índice compuesto | Entrada de índice para el índice compuesto en la propiedad Timestamp y la propiedad Name en orden descendente sin el ancestro habilitado. |
NAMESPACE: NS KIND: Users PROPERTIES: (Timestamp: DESC, Name: DESC) ANCESTOR: NONE VALUES: (16500000000000001, 'Alice') ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'), Usuarios,5000000000000001) |
Entrada de índice compuesto con ancestro | Entrada del índice compuesto en la propiedad Timestamp en orden descendente y la propiedad Name en orden descendente con el elemento principal habilitado. |
NAMESPACE: NS KIND: Users PROPERTIES: (Timestamp: DESC, Name: ASC) ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'), UserList,1, User,5000000000000001 VALUES: (16500000000000001, 'Alice') ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'), UserList,1, User,5000000000000001) |
Entrada de índice compuesto con __key__ |
Entrada del índice para el índice compuesto en la propiedad Timestamp en orden ascendente y __key__ en orden descendente sin principal habilitado. Puedes usar __key__ como la propiedad final en una definición de índice para cambiar el orden predeterminado de los resultados. |
NAMESPACE: NS KIND: Users PROPERTIES: (Timestamp: ASC, __key__ DESC) ANCESTOR: NONE VALUES: (16500000000000001) ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'), UserList,1, User,5000000000000001) |
¿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.