Estadísticas de Datastore

Google Cloud Datastore mantiene estadísticas sobre los datos almacenados para una aplicación, como la cantidad de entidades de una categoría determinada o el espacio que utilizan los valores de una propiedad de un tipo determinado. Puedes ver estás estadísticas en GCP Console, en la página del panel.

También puedes acceder a estos valores de manera programática dentro de la aplicación si consultas las entidades con nombre específicos con la API de Cloud Datastore. Se accede a cada estadística como una entidad cuya categoría de nombre comienza y termina con dos guiones bajos. Por ejemplo, cada aplicación tiene exactamente una entidad de la categoría __Stat_Total__ que representa las estadísticas sobre todas las entidades en Cloud Datastore en total. Cada entidad estadística tiene las siguientes propiedades:

  • count, la cantidad de elementos considerados por la estadística (un número entero largo);
  • bytes, el tamaño total de los elementos para esta estadística (un número entero largo);
  • timestamp, la hora de la actualización más reciente de la estadística (un valor de fecha y hora).

Algunos tipos de estadísticas también tienen propiedades adicionales que se mencionan a continuación.

Cuando el sistema de estadísticas crea nuevas entidades de estadística, no borra las anteriores de inmediato. La mejor manera de obtener una vista coherente de las estadísticas es consultar la entidad estadística con el timestamp más reciente y luego utilizar ese valor de marca de tiempo como filtro si obtienes otras entidades de estadística.

Las entidades de estadísticas se incluyen en los valores estadísticos calculados. Las entidades estadísticas ocupan un espacio según la cantidad de nombres de variantes y propiedades únicas que utiliza la aplicación.

El sistema de estadística también crea estadísticas específicas para cada espacio de nombres. Ten en cuenta que si una aplicación no utiliza los espacios de nombre de Cloud Datastore, no se crearán estadísticas específicas de espacios de nombres. Las estadísticas específicas de espacio de nombres se encuentran en el espacio de nombres específico. El tipo de nombres para las estadísticas específicas de espacio de nombres tienen el prefijo __Stat_Ns_ y el mismo sufijo correspondiente que los tipos de estadísticas de toda la aplicación.

Las aplicaciones con miles espacios de nombres, variantes o nombres de propiedades necesitan un gran número de entidades de estadísticas. Para que la sobrecarga de almacenamiento y de actualización de las estadísticas sea razonable, Cloud Datastore elimina las entidades de las estadísticas de forma progresiva, en el siguiente orden:

  • por estadísticas de espacio de nombres, de variantes y de propiedad: __Stat_Ns_PropertyName_Kind__, __Stat_Ns_PropertyType_PropertyName_Kind__
  • por estadísticas de variantes y de propiedad: __Stat_PropertyName_Kind__, __Stat_PropertyType_PropertyName_Kind__
  • por estadísticas de espacio de nombres y de variantes: __Stat_Ns_Kind__, __Stat_Ns_Kind_IsRootEntity__, __Stat_Ns_Kind_NotRootEntity__, __Stat_Ns_PropertyType_Kind__
  • por estadísticas de variantes: __Stat_Kind__, __Stat_Kind_IsRootEntity__, __Stat_Kind_NotRootEntity__, __Stat_PropertyType_Kind__
  • por estadísticas de espacio de nombres: __Stat_Namespace__, __Stat_Ns_Kind_CompositeIndex__, __Stat_Ns_PropertyType__, __Stat_Ns_Total__

Las entidades estadísticas de resumen (__Stat_Kind_CompositeIndex__, __Stat_PropertyType__, __Stat_Total__) nunca se eliminan.

La siguiente es la lista completa de estadísticas disponibles:

Estadística Categoría de entidad de estadística Descripción
Todas las entidades __Stat_Total__
Entrada específica del espacio de nombres:
__Stat_Ns_Total__
Todas las entidades. Propiedades adicionales:

entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
composite_index_bytes: el almacenamiento en entradas de índice compuesto medido en bytes
composite_index_count: el conteo de las entradas de índice compuesto
Todas las entidades en un espacio de nombres __Stat_Namespace__
Ten en cuenta que __Stat_Namespace__ las entidades se crearon para cada espacio de nombres encontrado y solo se encuentran en el espacio de nombres de la string vacía.
Todas las entidades en un espacio de nombres

subject_namespace, el espacio de nombres representado (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
composite_index_bytes: el almacenamiento en entradas de índice compuesto medido en bytes
composite_index_count: el conteo de las entradas de índice compuesto
Todas las entradas en los índices definidos de la aplicación __Stat_Kind_CompositeIndex__
Entrada específica de espacio de nombres: __Stat_Ns_Kind_CompositeIndex__
Entradas en la tabla del índice compuesto; una entidad estadística por cada tipo de entidad almacenada. Propiedades adicionales:

index_id, el ID del índice
kind_name, el nombre de la categoría representada (una string)
Entidades de una categoría __Stat_Kind__
Entrada específica del espacio de nombres:
__Stat_Ns_Kind__
Entidades de un tipo; una entidad estadística por cada tipo de entidad almacenada Propiedades adicionales:

kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
composite_index_bytes: el almacenamiento en entradas de índice compuesto medido en bytes
composite_index_count: el conteo de las entradas de índice compuesto
Entidades raíz de una categoría __Stat_Kind_IsRootEntity__
Entrada específica del espacio de nombres:
__Stat_Ns_Kind_IsRootEntity__
Las entidades de una categoría que son entidades raíz de un grupo de entidad (no tienen una entidad principal superior); una entidad estadística para cada tipo de entidad almacenada. Propiedades adicionales:

kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
Entidades que no sean raíz de una categoría __Stat_Kind_NotRootEntity__
Entrada específica del espacio de nombres:
__Stat_Ns_Kind_NotRootEntity__
Las entidades de una categoría que no son entidades raíz de un grupo de entidad (tienen una entidad principal superior); una entidad estadística para cada tipo de entidad almacenada. Propiedades adicionales:

kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
Propiedades de una categoría __Stat_PropertyType__
Entrada específica del espacio de nombres:
__Stat_Ns_PropertyType__
Las propiedades de un tipo de valor en todas las entidades; una entidad estadística por tipo de valor. Propiedades adicionales:

property_type, el nombre del tipo de valor (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
Propiedades de un tipo por categoría __Stat_PropertyType_Kind__
Entrada específica del espacio de nombres:
__Stat_Ns_PropertyType_Kind__
Las propiedades de un tipo de valor en entidades de una categoría determinada; una entidad estadística por combinación de tipo de propiedad y categoría. Propiedades adicionales:

property_type, el nombre del tipo de valor (una string)
kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en índice integrado medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
Propiedades con un nombre __Stat_PropertyName_Kind__
Entrada específica del espacio de nombres:
__Stat_Ns_PropertyName_Kind__
Las propiedades con un nombre determinado en las entidades de una categoría determinada; una entidad estadística por combinación de tipo de propiedad y categoría. Propiedades adicionales:

property_name, el nombre de la propiedad (una string)
kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas
Propiedades de un tipo y con un nombre __Stat_PropertyType_PropertyName_Kind__
Entrada específica del espacio de nombres:
__Stat_Ns_PropertyType_PropertyName_Kind__
Las propiedades con un nombre y valor determinados en las entidades de una categoría determinada; una entidad estadística por combinación del nombre de propiedad, tipo de valor y categoría que existe en Cloud Datastore. Propiedades adicionales:

property_type, el nombre del tipo de valor (una string)
property_name, el nombre de la propiedad (una string)
kind_name, el nombre de la categoría representada (una string)
entity_bytes: el almacenamiento en la tabla de entidades medido en bytes
builtin_index_bytes: el almacenamiento en entradas de índice integradas medido en bytes
builtin_index_count: el conteo de entradas de índice integradas

Algunas estadísticas se refieren a los tipos de valor de propiedad de Cloud Datastore por nombre, como strings. Los nombres son los siguientes:

  • "Blob"
  • "BlobKey"
  • "Boolean"
  • "Category"
  • "Date/Time"
  • "Email"
  • "Float"
  • "GeoPt"
  • "IM"
  • "Integer"
  • "Key"
  • "Link"
  • "NULL"
  • "PhoneNumber"
  • "PostalAddress"
  • "Rating"
  • "ShortBlob"
  • "String"
  • "Text"
  • "User"

Consulta también

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Datastore