활성 태스크

/_active_tasks 엔드포인트는 서버에서 실행 중인 태스크 목록을 제공하며, 이는 시스템의 성능을 모니터링 하는 데 유용합니다.

압축, 복제 및 인덱싱 태스크를 포함하여 활성 태스크의 목록을 검색할 수 있습니다. /_active_tasks 엔드포인트를 사용하는 방법에 대한 추가 예제는 태스크 관리 안내서를 참조하십시오.

활성 태스크 목록 검색

메소드
GET
경로
/_active_tasks
응답
태스크 유형, 이름, 상태 및 프로세스 ID를 포함한 실행 중인 태스크 목록.
허용되는 역할
_admin

/_active_tasks URL을 사용하여 활성 태스크의 목록을 가져올 수 있습니다. 결과는 단일 오브젝트를 사용하여 각각의 태스크에 대해 설명하는 현재 실행 중인 태스크에 대한 JSON 배열입니다.

다음과 같이 HTTP 명령을 사용하여 활성 태스크의 목록을 검색하는 요청 예제를 참조하십시오.

GET /_active_tasks HTTP/1.1

다음과 같이 명령행을 사용하여 활성 태스크의 목록을 검색하는 요청 예제를 참조하십시오.

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

리턴되는 구조에는 각각의 태스크에 대해 다음과 같은 필드가 포함되어 있습니다.

반환된 구조체의 필드
이름 설명
database 오퍼레이션이 수행되는 데이터베이스 및 샤드입니다.
pid Erlang 프로세스 ID입니다.
started_on 태스크가 시작된 시간입니다. 값은 UNIX™ 시간 UTC를 포함하는 정수입니다.
total_changes 태스크에서 처리할 총 문서 수입니다. 정확한 의미는 태스크의 유형에 따라 달라집니다.
type 조작 유형
updated_on 작업 상태가 업데이트된 시간입니다. 필드는 몇 초마다 업데이트됩니다. 가장 최근 업데이트를 리턴합니다.

type 필드에서 가능한 값은 다음과 같습니다.

  • database_compaction
  • view_compaction
  • replication
  • indexer
  • search_indexer

JSON 응답에 있는 다른 필드의 의미는 태스크의 유형에 따라 달라집니다.

다음과 같이 현재 실행 중인 태스크에 대한 세부사항이 포함된 JSON 응답 배열 예제를 참조하십시오.

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

압축 태스크에 대한 특정 응답 필드

압축 작업의 응답 필드
이름 설명
changes_done 압축된 문서의 수입니다.
phase 압축 단계를 보고합니다.
total_changes 데이터베이스의 문서 수입니다.

phase 필드의 값은 압축에서 도달한 단계를 나타냅니다.

ids
문서 압축이 진행 중입니다.
views
뷰 압축이 진행 중입니다.

복제 태스크에 대한 특정 응답 필드

복제 작업의 응답 필드
이름 설명
changes_pending 대상 데이터베이스에서 변경해야 할 문서의 수입니다(정수로 표시됨).
continuous 복제가 연속적인지 여부를 나타내는 부울 값입니다.
docs_read 소스 데이터에서 읽어들인 문서의 수입니다(정수로 표시됨).
replication_id 태스크를 취소하기 위해 사용할 수 있는 복제의 고유 ID 문자열입니다.
revisions_checked 대상 데이터베이스에 이미 존재하는지 여부를 확인하기 위해 검사된 문서 개정판의 수입니다.
source 태스크가 복제되는 소스 데이터베이스를 나타내는 난독화된 URL 문자열입니다.
target 태스크가 복제되는 대상 데이터베이스를 나타내는 난독화된 URL 문자열입니다.
user 복제를 시작한 사용자(문자열로 표시됨) 또는 사용자가 복제를 시작하지 않은 경우 null입니다.

인덱싱 태스크에 대한 특정 응답 필드

인덱싱 작업의 응답 필드
이름 설명
changes_done 이 태스크에서 처리한 문서 개정판의 수입니다. 문서에는 하나 이상의 개정판이 존재할 수 있습니다.
design_document view 또는 index 함수가 포함된 디자인 문서입니다.
total_changes 처리할 인덱싱되지 않은 변경사항의 수입니다. 삭제된 문서는 인덱서에서 자동으로 건너뛰지만 이 계수에는 포함됩니다.