Statistiche Datastore nei servizi in bundle legacy

Datastore conserva le statistiche sui dati archiviati per un di un'applicazione, ad esempio quante entità esistono di un determinato tipo viene utilizzato dai valori delle proprietà di un determinato tipo. Puoi visualizzare queste statistiche nella console Google Cloud, pagina Dashboard.

Puoi anche accedere a questi valori in modo programmatico all'interno dell'applicazione eseguire query su entità con nomi specifici usando l'API Datastore. Ogni statistica è accessibile come entità il cui nome del tipo inizia e termina con due trattini bassi. Ad esempio, ogni app ha esattamente un'entità di tipo __Stat_Total__ che rappresenta le statistiche su tutte le entità in Datastore in totale. Ogni entità statistica ha quanto segue: proprietà:

  • count, il numero di elementi considerati dalla statistica (un numero intero lungo)
  • bytes, la dimensione totale degli elementi per questa statistica (un numero intero lungo)
  • timestamp, l'ora dell'aggiornamento più recente della statistica (un data/ora )

Alcuni tipi di statistiche hanno anche proprietà aggiuntive, elencate di seguito.

Un'applicazione Java può accedere alle entità statistiche utilizzando l'API di basso livello. Ad esempio:

DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();
Entity globalStat = datastore.prepare(new Query("__Stat_Total__")).asSingleEntity();
Long totalBytes = (Long) globalStat.getProperty("bytes");
Long totalEntities = (Long) globalStat.getProperty("count");

Quando il sistema delle statistiche crea nuove entità statistiche, non elimina subito quelle vecchie. Il modo migliore per ottenere una visione coerente delle statistiche è eseguire una query per l'entità __Stat_Total__ con il valore timestamp più recente, quindi utilizzare questo valore del timestamp come filtro per recuperare altre entità statistiche.

Le entità statistiche sono incluse nei valori statistici calcolati. Le entità statistiche occupano spazio rispetto al numero di tipi unici e dei nomi delle proprietà usati dall'applicazione.

Il sistema di statistiche creerà anche statistiche specifiche per ogni spazio dei nomi. Tieni presente che se un'applicazione non utilizza gli spazi dei nomi di Datastore, le statistiche specifiche dello spazio dei nomi non verranno create. Le statistiche specifiche dello spazio dei nomi si trovano nello spazio dei nomi a cui si riferiscono. I nomi dei tipi per le statistiche specifiche dell'ambito hanno il prefisso __Stat_Ns_ e hanno lo stesso suffisso corrispondente dei tipi di statistiche a livello di applicazione.

Le applicazioni con migliaia di spazi dei nomi, tipi o nomi di proprietà richiedono un gran numero di entità statistiche. Per mantenere ragionevole il sovraccarico di archiviazione e aggiornamento delle statistiche, Datastore elimina progressivamente le entità statistiche, nell'ordine seguente:

  • Statistiche per spazio dei nomi, tipo e proprietà: __Stat_Ns_PropertyName_Kind__, __Stat_Ns_PropertyType_PropertyName_Kind__
  • Statistiche per tipo e per proprietà: __Stat_PropertyName_Kind__, __Stat_PropertyType_PropertyName_Kind__
  • statistiche per spazio dei nomi e per tipo: __Stat_Ns_Kind__, __Stat_Ns_Kind_IsRootEntity__, __Stat_Ns_Kind_NotRootEntity__ __Stat_Ns_PropertyType_Kind__
  • Statistiche per tipo: __Stat_Kind__, __Stat_Kind_IsRootEntity__, __Stat_Kind_NotRootEntity__, __Stat_PropertyType_Kind__
  • Statistiche per spazio dei nomi: __Stat_Namespace__, __Stat_Ns_Kind_CompositeIndex__, __Stat_Ns_PropertyType__, __Stat_Ns_Total__

Le entità delle statistiche di riepilogo (__Stat_Kind_CompositeIndex__, __Stat_PropertyType__, __Stat_Total__) non vengono mai eliminate.

Di seguito è riportato l'elenco completo delle statistiche disponibili:

Statistica Tipo di entità statistica Descrizione
tutte le entità __Stat_Total__
Voce specifica dello spazio dei nomi:
__Stat_Ns_Total__ 		Tutte le entità. Proprietà aggiuntive:

• entity_bytes: lo spazio di archiviazione nella tabella delle entità misurato in byte.
• builtin_index_bytes: lo spazio di archiviazione nelle voci dell'indice integrate misurato in byte.
• builtin_index_count: il conteggio delle voci dell'indice integrate.
• composite_index_bytes: lo spazio di archiviazione nelle voci di indice composto misurato in byte.
• composite_index_count: il conteggio delle voci di indice composto.
tutte le entità in uno spazio dei nomi __Stat_Namespace__
Tieni presente che le entità __Stat_Namespace__ vengono create per ogni spazio dei nomi incontrato e si trovano solo nello spazio dei nomi della stringa vuota.		 Tutte le entità in uno spazio dei nomi.

• subject_namespace, lo spazio dei nomi rappresentato (una stringa)
• entity_bytes: lo spazio di archiviazione nella tabella delle entità misurato in byte.
• builtin_index_bytes: spazio di archiviazione nelle voci di indice integrate misurato in byte.
• builtin_index_count: il conteggio delle voci dell'indice integrate.
• composite_index_bytes: lo spazio di archiviazione nelle voci dell'indice composito misurato in byte.
• composite_index_count: il conteggio delle voci dell'indice composito.
Tutte le voci degli indici definiti dall'applicazione __Stat_Kind_CompositeIndex__
Voce specifica dello spazio dei nomi: __Stat_Ns_Kind_CompositeIndex__
 Voci nella tabella degli indici composti; un'entità statistica per ogni tipo di entità archiviata. Proprietà aggiuntive:

• index_id, l'ID indice.
• kind_name, il nome del tipo rappresentato (una stringa)
entità di un tipo __Stat_Kind__
Voce specifica dello spazio dei nomi:
__Stat_Ns_Kind__ 		Entità di un tipo; un'entità statistica per ogni tipo di entità archiviata. Proprietà aggiuntive:

• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: lo spazio di archiviazione nella tabella delle entità misurato in byte.
• builtin_index_bytes: lo spazio di archiviazione nelle voci dell'indice integrate misurato in byte.
• builtin_index_count: il numero di voci di indice integrate.
• composite_index_bytes: lo spazio di archiviazione nelle voci di indice composto misurato in byte.
• composite_index_count: il conteggio delle voci dell'indice composito.
entità principali di un tipo __Stat_Kind_IsRootEntity__
Voce specifica dello spazio dei nomi:
__Stat_Ns_Kind_IsRootEntity__ 		Entità di un tipo che sono entità radice del gruppo di entità (nessuna entità padre predecessore); un'entità statistica per ogni tipo di entità archiviata. Proprietà aggiuntive:

• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: l'archiviazione nella tabella delle entità misurata in byte.
entità non root di un tipo __Stat_Kind_NotRootEntity__
Voce specifica dello spazio dei nomi:
__Stat_Ns_Kind_NotRootEntity__ 		Entità di un tipo che non sono entità principali del gruppo di entità (hanno un'entità principale precedente); un'entità statistica per ogni tipo di entità archiviata. Proprietà aggiuntive:

• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: lo spazio di archiviazione nella tabella delle entità misurato in byte.
proprietà di un tipo __Stat_PropertyType__
Voce specifica dello spazio dei nomi:
__Stat_Ns_PropertyType__ 		Proprietà di un tipo di valore in tutte le entità; un'entità statistica per tipo di valore. Proprietà aggiuntive:

• property_type, il nome del tipo di valore (una stringa)
• entity_bytes: l'archiviazione nella tabella delle entità misurata in byte.
• builtin_index_bytes: spazio di archiviazione nelle voci di indice integrate misurato in byte.
• builtin_index_count: il numero di voci di indice integrate.
di un tipo per tipo __Stat_PropertyType_Kind__
Voce specifica dello spazio dei nomi:
__Stat_Ns_PropertyType_Kind__ 		Proprietà di un tipo di valore nelle entità di un determinato tipo; un'entità statistica per ogni combinazione di tipo e tipo di proprietà. Proprietà aggiuntive:

• property_type, il nome del tipo di valore (una stringa)
• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: l'archiviazione nella tabella delle entità misurata in byte.
• builtin_index_bytes: lo spazio di archiviazione nell'indice integrato misurato in byte.
• builtin_index_count: il conteggio delle voci dell'indice incorporate.
proprietà con un nome __Stat_PropertyName_Kind__
Voce specifica dello spazio dei nomi:
__Stat_Ns_PropertyName_Kind__ 		Proprietà con un dato nome tra entità di un determinato tipo; un'entità statistica per combinazione di nome e tipo di proprietà univoci. Proprietà aggiuntive:

• property_name, il nome della proprietà (una stringa)
• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: l'archiviazione nella tabella delle entità misurata in byte.
• builtin_index_bytes: lo spazio di archiviazione nelle voci dell'indice integrate misurato in byte.
• builtin_index_count: il numero di voci di indice integrate.
proprietà di un tipo e con un nome __Stat_PropertyType_PropertyName_Kind__
Voce specifica dello spazio dei nomi:
__Stat_Ns_PropertyType_PropertyName_Kind__ 		Proprietà con un determinato nome e di un determinato tipo di valore nelle entità di un determinato tipo; un'entità statistica per ogni combinazione di nome della proprietà, tipo di valore e tipo esistenti in Datastore. Proprietà aggiuntive:

• property_type, il nome del tipo di valore (una stringa)
• property_name, il nome della proprietà (una stringa)
• kind_name, il nome del tipo rappresentato (una stringa)
• entity_bytes: l'archiviazione nella tabella delle entità misurata in byte.
• builtin_index_bytes: spazio di archiviazione nelle voci di indice integrate misurato in byte.
• builtin_index_count: il numero di voci di indice integrate.

Alcune statistiche fanno riferimento ai tipi di valori delle proprietà Datastore per nome, come stringhe. I nomi sono i seguenti:

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