Tarefas ativas

O terminal /_active_tasks fornece uma lista das tarefas que estão em execução no servidor, o que é útil para o monitoramento do desempenho do seu sistema.

É possível recuperar uma lista de tarefas ativas, incluindo tarefas de compactação, replicação e indexação. Para obter mais exemplos sobre o uso do terminal /_active_tasks, consulte o guia Gerenciando tarefas.

Recuperando uma lista de tarefas ativas

Método
GET
Caminho
/_active_tasks
Resposta
Lista de tarefas em execução, incluindo o tipo de tarefa, nome, status e ID do processo.
Funções permitidas
_admin

É possível obter uma lista de tarefas ativas usando a URL /_active_tasks. O resultado é uma matriz JSON das tarefas em execução atualmente, com cada tarefa descrita com um único objeto.

Veja a solicitação de exemplo para recuperar uma lista de tarefas ativas usando comandos HTTP:

GET /_active_tasks HTTP/1.1

Veja a solicitação de exemplo para recuperar uma lista de tarefas ativas usando a linha de comandos:

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

A estrutura retornada inclui os campos a seguir para cada tarefa:

Campos na estrutura retornada
Nome Descrição
database O banco de dados e o shard nos quais a operação ocorre.
pid ID do processo Erlang
started_on Horário de início da tarefa. O valor é um número inteiro que inclui a hora UTC do UNIX™.
total_changes Número total de documentos a serem processados pela tarefa. O significado exato depende do tipo da tarefa.
type Tipo da Operação
updated_on Horário de atualização do status da tarefa. O campo é atualizado a cada poucos segundos. Retorna a atualização mais recente.

No campo type, os valores possíveis incluem:

  • database_compaction
  • view_compaction
  • replication
  • indexer
  • search_indexer

O significado de outros campos na resposta JSON depende do tipo da tarefa.

Veja a matriz de resposta de JSON de exemplo que inclui detalhes de tarefas em execução atualmente:

[
	{
		"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"
	}
]

Campos de resposta específicos para tarefas de compactação

Campos de resposta para tarefas de compactação
Nome Descrição
changes_done Número de documentos compactados.
phase Relata o estágio de compactação.
total_changes Número de documentos no banco de dados.

No campo phase, o valor indica o estágio que foi atingido pela compactação:

ids
A compactação do documento está em andamento.
views
A compactação da visualização está em andamento.

Campos de resposta específicos para tarefas de replicação

Campos de resposta para tarefas de replicação
Nome Descrição
changes_pending Número de documentos que precisam ser mudados no banco de dados de destino, expresso como um número inteiro.
continuous Valor booleano que indica se a replicação é contínua.
docs_read Número de documentos que são lidos do banco de dados de origem, expresso como um número inteiro.
replication_id Sequência de identificadores exclusivos da replicação que pode ser usada para cancelar a tarefa.
revisions_checked Número de revisões de documentos que foram verificadas para saber se elas já estão no banco de dados de destino.
source Uma sequência URL ofuscada que indica o banco de dados do qual a tarefa está replicando.
target Uma sequência URL ofuscada que indica o banco de dados para o qual a tarefa está replicando.
user Usuário que iniciou a replicação, expresso como uma sequência ou como null quando a replicação não foi iniciada por um usuário.

Campos de resposta específicos para tarefas de indexação

Campos de resposta para tarefas de indexação
Nome Descrição
changes_done Número de revisões de documentos que são processadas por essa tarefa. Um documento pode ter uma ou mais revisões.
design_document O documento de design que inclui a função ou funções de visualização ou de índice.
total_changes O número de mudanças não indexadas no processo. Essa contagem inclui documentos excluídos, embora esses documentos sejam ignorados automaticamente pelo indexador.