활성 태스크
/_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_compactionview_compactionreplicationindexersearch_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 |
처리할 인덱싱되지 않은 변경사항의 수입니다. 삭제된 문서는 인덱서에서 자동으로 건너뛰지만 이 계수에는 포함됩니다. |