Aktive Tasks

Vom Endpunkt /_active_tasks wird eine Liste der Tasks bereitgetellt, die auf dem Server ausgeführt werden; dies ist für die Überwachung der Systemleistung hilfreich.

Sie können eine Liste der aktiven Tasks abrufen (einschließlich Komprimierungs-, Replikations- und Indexierungstasks). Weitere Beispiele für die Verwendung des Endpunkts /_active_tasks finden Sie im Leitfaden zum Verwalten von Tasks.

Liste der aktiven Tasks abrufen

Methode
GET
Pfad
/_active_tasks
Antwort
Liste der aktiven Tasks, einschließlich Tasktyp, Name, Status und Prozess-ID.
Zulässige Rollen
_admin

Sie können eine Liste der aktiven Tasks mithilfe der URL /_active_tasks abrufen. Das Ergebnis ist ein JSON-Array mit den momentan aktiven Tasks. Dabei wird jede Task durch ein einzelnes Objekt beschrieben.

Beispielanforderung zum Abrufen einer Liste der aktiven Tasks mithilfe von HTTP-Befehlen:

GET /_active_tasks HTTP/1.1

Beispielanforderung zum Abrufen einer Liste der aktiven Tasks über die Befehlszeile:

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

Die zurückgegebene Struktur enthält für jede Task die folgenden Felder:

Felder in der zurückgegebenen Struktur
Name Beschreibung
database Die Datenbank und die Shard, in der die Operation ausgeführt wird.
pid Die Erlang-Prozess-ID.
started_on Der Zeitpunkt, an dem die Task gestartet wurde. Der Wert ist eine ganze Zahl, die die UNIX™-Zeit UTC enthält.
total_changes Die Gesamtzahl der Dokumente, die von der Task verarbeitet werden sollen. Die genaue Bedeutung ist vom Tasktyp abhängig.
type Operationstyp
updated_on Der Zeitpunkt, zu dem der Taskstatus aktualisiert wurde. Das Feld wird alle paar Sekunden aktualisiert. Gibt die letzte Aktualisierung zurück.

Zu den möglichen Werten im Feld type gehören die folgenden:

  • database_compaction
  • view_compaction
  • replication
  • indexer
  • search_indexer

Die Bedeutungen anderer Felder in der JSON-Antwort sind vom Typ der Task abhängig.

Beispiel für ein JSON-Antwortarray mit Details aktuell ausgeführter Tasks:

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

Spezielle Antwortfelder für Koprimierungstasks

Antwortfelder für Verdichtungsaufgaben
Name Beschreibung
changes_done Die Anzahl der komprimierten Dokumente.
phase Gibt die Komprimierungsphase an.
total_changes Die Anzahl der Dokumente in der Datenbank.

Der Wert im Feld phase gibt die erreichte Phase der Komprimierung an:

ids
Die Dokumentkomprimierung ist in Bearbeitung.
views
Die Anzeige der Komprimierung ist in Bearbeitung.

Spezielle Antwortfelder für Replikationstasks

Antwortfelder für Replikationsaufgaben
Name Beschreibung
changes_pending Anzahl der Dokumente, die in der Zieldatenbank geändert werden müssen, ausgedrückt als ganze Zahl.
continuous Boolescher Wert, der angibt, ob die Replikation fortlaufend ist.
docs_read Anzahl der Dokumente, die aus der Quellendatenbank gelesen werden, ausgedrückt als ganze Zahl.
replication_id Eindeutige ID-Zeichenfolge der Replikation, die zum Abbrechen der Task verwendet werden kann.
revisions_checked Anzahl der Dokumentrevisionen, für die geprüft wurde, ob sie bereits in der Zieldatenbank enthalten sind.
source Eine unkenntlich gemachte URL-Zeichenfolge, die angibt, aus welcher Datenbank die Task repliziert wird.
target Eine unkenntlich gemachte URL-Zeichenfolge, die angibt, in welche Datenbank die Task repliziert wird.
user Benutzer, der die Replikation gestartet hat, ausgedrückt als Zeichenfolge, oder null, wenn die Replikation nicht von einem Benutzer gestartet wurde.

Spezielle Antwortfelder für Indexierungstasks

Antwortfelder für Indizierungsaufgaben
Name Beschreibung
changes_done Anzahl der Dokumentrevisionen, die von dieser Task verarbeitet werden. Für ein Dokument können mehrere Revisionen vorhanden sein.
design_document Das Entwurfsdokument, das die Anzeige- oder Indexfunktion(en) enthält.
total_changes Anzahl der nicht indexierten Änderungen, die verarbeitet werden sollen. Diese Anzahl beinhaltet gelöschte Dokumente, obwohl diese von der Indexierungskomponente automatisch übersprungen werden.