google.appengine.ext.db.stats module

Summary

Models to be used when accessing app specific datastore usage statistics.

These entities cannot be created by users, but are populated in the application’s datastore by offline processes run by the Google App Engine team.

Contents

class google.appengine.ext.db.stats.BaseKindStatistic(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseStatistic

Base Statistic Model class for stats associated with kinds.

kind_name

the name of the kind associated with the statistic instance.

entity_bytes

the number of bytes taken up to store the statistic in the datastore minus the cost of storing indices.

STORED_KIND_NAME = '__BaseKindStatistic__'
entity_bytes

An integer property.

kind_name

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.BaseStatistic(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.Model

Base Statistic Model class.

bytes

the total number of bytes taken up in the datastore for the statistic instance.

count

attribute is the total number of occurrences of the statistic in the datastore.

timestamp

the time the statistic instance was written to the datastore.

STORED_KIND_NAME = '__BaseStatistic__'
bytes

An integer property.

count

An integer property.

classmethod kind()source

Kind name override.

timestamp

The base class of all of our date/time properties.

We handle common operations, like converting between time tuples and datetime instances.

class google.appengine.ext.db.stats.GlobalStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseStatistic

An aggregate of all entities across the entire application.

This statistic only has a single instance in the datastore that contains the total number of entities stored and the total number of bytes they take up.

entity_bytes

the number of bytes taken up to store the statistic in the datastore minus the cost of storing indices.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

composite_index_bytes

the number of bytes taken up to store composite index entries

composite_index_count

the number of composite index entries.

STORED_KIND_NAME = '__Stat_Total__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

composite_index_bytes

An integer property.

composite_index_count

An integer property.

entity_bytes

An integer property.

class google.appengine.ext.db.stats.KindCompositeIndexStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseStatistic

Statistic on (kind, composite_index_id) tuples in the datastore.

There is an instance of the KindCompositeIndexStat for every unique (kind, composite_index_id) tuple in the application’s datastore indexes.

index_id

the id of the composite index associated with the statistic instance.

kind_name

the name of the kind associated with the statistic instance.

STORED_KIND_NAME = '__Stat_Kind_CompositeIndex__'
index_id

An integer property.

kind_name

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.KindNonRootEntityStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

Statistics of the number of non root entities in the datastore by Kind.

There is an instance of the KindNonRootEntityStat for every Kind that is in the application’s datastore that is a not a root entity. This stat contains statistics regarding thse non root entity instances.

STORED_KIND_NAME = '__Stat_Kind_NotRootEntity__'
class google.appengine.ext.db.stats.KindPropertyNamePropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

Statistic on (kind, property_name, property_type) tuples in the datastore.

There is an instance of the KindPropertyNamePropertyTypeStat for every (kind, property_name, property_type) tuple in the application’s datastore.

property_type

the property type associated with the statistic instance.

property_name

the name of the property associated with the statistic instance.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

STORED_KIND_NAME = '__Stat_PropertyType_PropertyName_Kind__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

property_name

A textual property, which can be multi- or single-line.

property_type

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.KindPropertyNameStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

Statistics on (kind, property_name) tuples in the app’s datastore.

There is an instance of the KindPropertyNameStat for every (kind, property_name) tuple in the application’s datastore.

property_name

the name of the property associated with the statistic instance.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

STORED_KIND_NAME = '__Stat_PropertyName_Kind__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

property_name

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.KindPropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

Statistics on (kind, property_type) tuples in the app’s datastore.

There is an instance of the KindPropertyTypeStat for every (kind, property_type) tuple in the application’s datastore.

property_type

the property type associated with the statistic instance.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

STORED_KIND_NAME = '__Stat_PropertyType_Kind__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

property_type

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.KindRootEntityStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

Statistics of the number of root entities in the datastore by Kind.

There is an instance of the KindRootEntityState for every Kind that is in the application’s datastore and has an instance that is a root entity. This stat contains statistics regarding these root entity instances.

STORED_KIND_NAME = '__Stat_Kind_IsRootEntity__'
class google.appengine.ext.db.stats.KindStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseKindStatistic

An aggregate of all entities at the granularity of their Kind.

There is an instance of the KindStat for every Kind that is in the application’s datastore. This stat contains per-Kind statistics.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

composite_index_bytes

the number of bytes taken up to store composite index entries

composite_index_count

the number of composite index entries.

STORED_KIND_NAME = '__Stat_Kind__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

composite_index_bytes

An integer property.

composite_index_count

An integer property.

class google.appengine.ext.db.stats.NamespaceGlobalStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.GlobalStat

GlobalStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_Total__'
class google.appengine.ext.db.stats.NamespaceKindCompositeIndexStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindCompositeIndexStat

KindCompositeIndexStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_Kind_CompositeIndex__'
class google.appengine.ext.db.stats.NamespaceKindNonRootEntityStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindNonRootEntityStat

KindNonRootEntityStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_Kind_NotRootEntity__'
class google.appengine.ext.db.stats.NamespaceKindPropertyNamePropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindPropertyNamePropertyTypeStat

KindPropertyNamePropertyTypeStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_PropertyType_PropertyName_Kind__'
class google.appengine.ext.db.stats.NamespaceKindPropertyNameStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindPropertyNameStat

KindPropertyNameStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_PropertyName_Kind__'
class google.appengine.ext.db.stats.NamespaceKindPropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindPropertyTypeStat

KindPropertyTypeStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_PropertyType_Kind__'
class google.appengine.ext.db.stats.NamespaceKindRootEntityStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindRootEntityStat

KindRootEntityStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_Kind_IsRootEntity__'
class google.appengine.ext.db.stats.NamespaceKindStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.KindStat

KindStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_Kind__'
class google.appengine.ext.db.stats.NamespacePropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.PropertyTypeStat

PropertyTypeStat equivalent for a specific namespace.

These may be found in each specific namespace and represent stats for that particular namespace.

STORED_KIND_NAME = '__Stat_Ns_PropertyType__'
class google.appengine.ext.db.stats.NamespaceStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseStatistic

An aggregate of all entities across an entire namespace.

This statistic has one instance per namespace. The key_name is the represented namespace. NamespaceStat entities will only be found in the namespace “” (empty string). It contains the total number of entities stored and the total number of bytes they take up.

subject_namespace

the namespace associated with the statistic instance.

entity_bytes

the number of bytes taken up to store the statistic in the datastore minus the cost of storing indices.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

composite_index_bytes

the number of bytes taken up to store composite index entries

composite_index_count

the number of composite index entries.

STORED_KIND_NAME = '__Stat_Namespace__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

composite_index_bytes

An integer property.

composite_index_count

An integer property.

entity_bytes

An integer property.

subject_namespace

A textual property, which can be multi- or single-line.

class google.appengine.ext.db.stats.PropertyTypeStat(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)source

Bases: google.appengine.ext.db.stats.BaseStatistic

An aggregate of all properties across the entire application by type.

There is an instance of the PropertyTypeStat for every property type (google.appengine.api.datastore_types._PROPERTY_TYPES) in use by the application in its datastore.

property_type

the property type associated with the statistic instance.

entity_bytes

the number of bytes taken up to store the statistic in the datastore minus the cost of storing indices.

builtin_index_bytes

the number of bytes taken up to store builtin-in index entries

builtin_index_count

the number of built-in index entries.

STORED_KIND_NAME = '__Stat_PropertyType__'
builtin_index_bytes

An integer property.

builtin_index_count

An integer property.

entity_bytes

An integer property.

property_type

A textual property, which can be multi- or single-line.