Tâches actives

Le noeud final /_active_tasks fournit la liste des tâches qui s'exécutent sur le serveur, ce qui permet de surveiller les performances de votre système.

Vous pouvez extraire la liste des tâches actives, notamment des tâches de compression, de réplication et d'indexation. Pour d'autres exemples d'utilisation du noeud final /_active_tasks, voir le guide Gestion des tâches.

Extraction de la liste des tâches actives

Méthode
GET
Voie
/_active_tasks
Réponse
Liste des tâches en cours d'exécution, y compris le type de tâche, le nom, le statut et l'ID de processus.
Rôles autorisés
_admin

Vous pouvez obtenir la liste des tâches actives avec l'URL /_active_tasks. Le résultat est un tableau JSON des tâches en cours d'exécution, dans lequel chaque tâche est décrite avec un objet unique.

Voici un exemple de demande d'extraction de la liste des tâches actives à l'aide de commandes HTTP :

GET /_active_tasks HTTP/1.1

Voici un exemple de demande d'extraction de la liste des tâches actives via la ligne de commande :

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

La structure renvoyée inclut les zones suivantes pour chaque tâche :

Champs de la structure renvoyée
Nom Description
database La base de données et le fragment sur lesquels l'opération est effectuée.
pid ID de processus Erlang
started_on Heure de début de la tâche. La valeur est un nombre entier qui inclut le temps UNIX™ UTC.
total_changes Nombre total de documents que la tâche doit traiter. La signification exacte dépend du type de la tâche.
type Type d'opération
updated_on Heure à laquelle le statut de la tâche a été mis à jour. La zone est mise à jour à quelques secondes d'intervalle. Renvoie la mise à jour la plus récente.

Dans la zone type, les valeurs possibles sont les suivantes :

  • database_compaction
  • view_compaction
  • replication
  • indexer
  • search_indexer

La signification des autres zones figurant dans la réponse JSON dépend du type de la tâche.

Voici un exemple de tableau de réponses JSON qui inclut les détails sur les tâches en cours d'exécution :

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

Zones de réponse spécifiques pour les tâches de compression

Champs de réponse pour les tâches de compactage
Nom Description
changes_done Nombre de documents compressés.
phase Indique l'étape de compression.
total_changes Nombre de documents dans la base de données.

Dans la zone phase, la valeur indique l'étape qui a été atteinte par la compression :

ids
La compression du document est en cours.
views
Voir la compression qui est en cours.

Zones de réponse spécifiques pour les tâches de réplication

Champs de réponse pour les tâches de réplication
Nom Description
changes_pending Nombre de documents devant être changés dans la base de données cible, exprimé sous forme d'entier.
continuous Valeur booléenne qui indique si la réplication est continue.
docs_read Nombre de documents lus depuis la base de données source, exprimée sous forme d'entier.
replication_id Chaîne d'identificateur unique de la réplication pouvant être utilisée pour annuler la tâche.
revisions_checked Nombre de révisions de document qui ont été vérifiées pour déterminer si elles se trouvent déjà dans la base de données cible.
source Chaîne d'URL brouillée qui indique la base de données à partir de laquelle la tâche procède à la réplication.
target Chaîne d'URL brouillée qui indique la base de données dans laquelle la tâche procède à la réplication.
user Utilisateur qui a démarré la réplication, exprimé sous forme de chaîne, ou null si la réplication n'a pas été initiée par un utilisateur.

Zones de réponse spécifiques pour les tâches d'indexation

Champs de réponse pour les tâches d'indexation
Nom Description
changes_done Nombre de révisions de document traitées par cette tâche. Un document peut avoir une ou plusieurs révisions.
design_document Document de conception incluant la ou les fonctions d'index ou de vue.
total_changes Nombre de modifications non indexées à traiter. Ce nombre inclut les documents supprimés, bien que ceux-ci soient automatiquement ignorés par l'indexeur.