Attività attive

L'endpoint /_active_tasks fornisce un elenco dei task in esecuzione sul server, utile per monitorare le prestazioni del sistema.

È possibile recuperare un elenco di task attivi, compresi quelli di compattazione, replica e indicizzazione. Per ulteriori esempi sull'uso dell'endpoint /_active_tasks, vedere la guida Gestione delle attività.

Recupero di un elenco di attività attive

Metodo
GET
Percorso
/_active_tasks
Risposta
Elenco delle attività in esecuzione, compreso il tipo di attività, il nome, lo stato e l'ID del processo.
Ruoli consentiti
_admin

È possibile ottenere un elenco delle attività attive utilizzando il sito /_active_tasks URL. Il risultato è un array JSON dei task in esecuzione, con ogni task descritto con un singolo oggetto.

Vedere l'esempio di richiesta per recuperare un elenco di attività attive utilizzando i comandi di HTTP:

GET /_active_tasks HTTP/1.1

Vedere l'esempio di richiesta per recuperare un elenco di attività attive tramite la riga di comando:

curl "https://$ACCOUNT.cloudant.com/_active_tasks" \
	-u $ACCOUNT

La struttura restituita comprende i seguenti campi per ogni attività:

Campi della struttura restituita
Nome Descrizione
database Il database e lo shard su cui avviene l'operazione.
pid ID processo Erlang
started_on Ora in cui è stata avviata l'attività. Il valore è un intero che include l'ora UNIX™ UTC.
total_changes Numero totale di documenti da elaborare per l'attività. Il significato esatto dipende dal tipo di compito.
type Tipo di operazione
updated_on Ora di aggiornamento dello stato dell'attività. Il campo si aggiorna ogni pochi secondi. Restituisce l'aggiornamento più recente.

Nel campo type, i valori possibili sono:

  • database_compaction
  • view_compaction
  • replication
  • indexer
  • search_indexer

Il significato degli altri campi della risposta JSON dipende dal tipo di task.

Vedere l'esempio di array di risposta JSON che include i dettagli delle attività in esecuzione:

[
	{
		"user": null,
		"updated_on": 1363274088,
		"type": "replication",
		"target": "https://repl:*****@tsm.cloudant.com/user-3dglstqg8aq0uunzimv4uiimy/",
		"docs_read": 0,
		"doc_write_failures": 0,
		"doc_id": "tsm-admin__to__user-3dglstqg8aq0uunzimv4uiimy",
		"continuous": true,
		"checkpointed_source_seq": "403-g1AAAADfeJzLYWBgYMlgTmGQS0lKzi9KdUhJMjTRyyrNSS3QS87JL01JzCvRy0styQGqY0pkSLL___9_VmIymg5TXDqSHIBkUj1YUxyaJkNcmvJYgCRDA5AC6tuflZhGrPsgGg9ANAJtzMkCAPFSStc",
		"changes_pending": 134,
		"pid": "<0.1781.4101>",
		"node": "dbcore@db11.julep.cloudant.net",
		"docs_written": 0,
		"missing_revisions_found": 0,
		"replication_id": "d0cdbfee50a80fd43e83a9f62ea650ad+continuous",
		"revisions_checked": 0,
		"source": "https://repl:*****@tsm.cloudant.com/tsm-admin/",
		"source_seq": "537-g1AAAADfeJzLYWBgYMlgTmGQS0lKzi9KdUhJMjTUyyrNSS3QS87JL01JzCvRy0styQGqY0pkSLL___9_VmI9mg4jXDqSHIBkUj1WTTityWMBkgwNQAqob39WYhextkE0HoBoBNo4MQsAFuVLVQ",
		"started_on": 1363274083
	},
	{
		"user": "acceptly",
		"updated_on": 1363273779,
		"type": "indexer",
		"node": "dbcore@db11.julep.cloudant.net",
		"pid": "<0.20723.4070>",
		"changes_done": 189,
		"database": "shards/00000000-3fffffff/acceptly/acceptly_my_chances_logs_live.1321035717",
		"design_document": "_design/MyChancesLogCohortReport",
		"started_on": 1363273094,
		"total_changes": 26389
	},
	{
		"user": "username",
		"updated_on": 1371118433,
		"type": "search_indexer",
		"total_changes": 5466,
		"node": "dbcore@db7.meritage.cloudant.net",
		"pid": "<0.29569.7037>",
		"changes_done": 4611,
		"database": "shards/40000000-7fffffff/username/database_name",
		"design_document": "_design/lucene",
		"index": "search1",
		"started_on": 1371118426
	},
	{
		"view": 1,
		"user": "acceptly",
		"updated_on": 1363273504,
		"type": "view_compaction",
		"total_changes": 26095,
		"node": "dbcore@db11.julep.cloudant.net",
		"pid": "<0.21218.4070>",
		"changes_done": 20000,
		"database": "shards/80000000-bfffffff/acceptly/acceptly_my_chances_logs_live.1321035717",
		"design_document": "_design/MyChancesLogCohortReport",
		"phase": "view",
		"started_on": 1363273094
	},
	{
		"updated_on": 1363274040,
		"node": "dbcore@db11.julep.cloudant.net",
		"pid": "<0.29256.4053>",
		"changes_done": 272195,
		"database": "shards/00000000-3fffffff/heroku/app3245179/id_f21a08b7005e_logs.1346083461",
		"started_on": 1363272496,
		"total_changes": 272195,
		"type": "database_compaction"
	}
]

Campi di risposta specifici per le attività di compattazione

Campi di risposta per le attività di compattazione
Nome Descrizione
changes_done Numero di documenti compattati.
phase Riporta lo stadio di compattazione.
total_changes Numero di documenti nel database.

Nel campo phase, il valore indica lo stadio raggiunto dalla compattazione:

ids
La compattazione dei documenti è in corso.
views
La compattazione della vista è in corso.

Campi di risposta specifici per le attività di replica

Campi di risposta per le attività di replica
Nome Descrizione
changes_pending Numero di documenti da modificare nel database di destinazione, espresso come numero intero.
continuous Valore booleano che indica se la replica è continua.
docs_read Numero di documenti letti dal database di origine, espresso come numero intero.
replication_id Stringa di identificazione univoca della replica che può essere utilizzata per annullare l'attività.
revisions_checked Numero di revisioni di documenti che sono state controllate per verificare se sono già presenti nel database di destinazione.
source Una stringa offuscata URL che indica il database da cui l'attività sta replicando.
target Una stringa offuscata URL che indica il database a cui il task sta replicando.
user Utente che ha avviato la replica, espresso come stringa, oppure null se la replica non è stata avviata da un utente.

Campi di risposta specifici per le attività di indicizzazione

Campi di risposta per le attività di indicizzazione
Nome Descrizione
changes_done Numero di revisioni del documento elaborate da questa attività. Un documento può avere una o più revisioni.
design_document Il documento di progettazione che include la funzione o le funzioni della vista o dell'indice.
total_changes Il numero di modifiche non indicizzate da elaborare. Questo conteggio include i documenti cancellati, anche se questi vengono automaticamente saltati dall'indicizzatore.