Tareas activas
El punto final /_active_tasks
proporciona una lista de las tareas que se ejecutan en el servidor, lo cual es útil para supervisar el rendimiento del sistema.
Puede recuperar una lista de tareas activas, incluidas las tareas de compactación, réplica e indexación. Para ver más ejemplos sobre cómo utilizar el punto final /_active_tasks
, consulte la guía de Gestión de tareas.
Recuperación de una lista de tareas activas
- Método
GET
- Vía de acceso
/_active_tasks
- Respuesta
- Lista de tareas en ejecución, incluido el tipo de tarea, el nombre, el estado y el ID de proceso.
- Roles permitidos
_admin
Puede obtener una lista de tareas activas utilizando el URL /_active_tasks
. El resultado es una matriz JSON de las tareas en ejecución actualmente, con cada tarea descrita con un único objeto.
Consulte la solicitud de ejemplo para recuperar una lista de tareas activas mediante mandatos HTTP:
GET /_active_tasks HTTP/1.1
Consulte la solicitud de ejemplo para recuperar una lista de tareas activas mediante la línea de mandatos:
curl "https://$ACCOUNT.cloudant.com/_active_tasks" \
-u $ACCOUNT
La estructura devuelta incluye los campos siguientes para cada tarea:
Nombre | Descripción |
---|---|
database |
La base de datos y el fragmento en los que se produce la operación. |
pid |
ID de proceso Erlang |
started_on |
Hora a la que se ha iniciado la tarea. El valor es un entero que incluye la hora UNIX™ UTC. |
total_changes |
Número total de documentos que la tarea debe procesar. El significado exacto depende del tipo de tarea. |
type |
Tipo de operación |
updated_on |
Hora en que se ha actualizado el estado de la tarea. El campo se actualiza cada pocos segundos. Devuelve la actualización más reciente. |
En el campo type
, los valores posibles incluyen:
database_compaction
view_compaction
replication
indexer
search_indexer
El significado de otros campos de la respuesta JSON depende del tipo de tarea.
Consulte la matriz de respuestas JSON de ejemplo que incluye detalles de las tareas actualmente en ejecución:
[
{
"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 respuesta específicos para tareas de compactación
Nombre | Descripción |
---|---|
changes_done |
Número de documentos compactados. |
phase |
Muestra la etapa de compactación. |
total_changes |
Número de documentos de la base de datos. |
En el campo phase
, el valor indica la etapa que ha alcanzado la compactación:
ids
- La compactación de documentos está en curso.
views
- La compactación de vistas está en curso.
Campos de respuesta específicos para tareas de réplica
Nombre | Descripción |
---|---|
changes_pending |
Número de documentos que se deben modificar en la base de datos de destino, expresado como un entero. |
continuous |
Valor booleano que indica si la réplica es continua. |
docs_read |
Número de documentos que se leen de la base de datos de origen, expresado como un entero. |
replication_id |
Serie de identificador exclusiva de la réplica que se puede utilizar para cancelar la tarea. |
revisions_checked |
Número de revisiones del documento que se han comprobado para verificar si ya están en la base de datos de destino. |
source |
Una serie de URL oculta que indica la base de datos desde la que se realiza la réplica de la tarea. |
target |
Una serie de URL oculta que indica la base de datos en la que se realiza la réplica de la tarea. |
user |
Usuario que ha iniciado la réplica, expresado como una serie, o null si la réplica no ha sido iniciada por un usuario. |
Campos de respuesta específicos para tareas de indexación
Nombre | Descripción |
---|---|
changes_done |
Número de revisiones de documento que procesa esta tarea. Un documento puede tener una o varias revisiones. |
design_document |
El documento de diseño que incluye la función o funciones de vista o de índice. |
total_changes |
El número de cambios no indexados en el proceso. Este recuento incluye documentos suprimidos, aunque el indexador omite automáticamente estos documentos. |